(raiz)

Inicia o Dev Proxy.

Sinopse

devproxy [options]

Options:
  -c, --config-file <file>      Configuration file path (default: devproxyrc.json)
  -u, --urls-to-watch <urls>    URLs to intercept (supports wildcards)
  -p, --port <port>             Proxy port (default: 8000)
  --api-port <apiPort>          API port (default: 8897)
  --log-level <level>           Logging level: trace|debug|information|warning|error
  --output <format>             Output format: text|json (default: text)
  --record                      Start recording immediately
  --discover                    Run in URL discovery mode
  --watch-pids <pids>           Process IDs to watch
  --watch-process-names <names> Process names to watch
  -t, --timeout <seconds>       Auto-stop after inactivity
  --no-watch                    Disable config file auto-restart on changes
  --no-color                    Disable colored output
  --detach                      Run proxy in the background (detached mode)
  --version                     Show version
  -h, --help                    Show help

Uso

devproxy

Argumentos

Nenhum

Opções

Nome Descrição Valores permitidos Padrão
--api-port <apiPort> A porta para a API de Proxy de Desenvolvimento a ser escutada. Defina para 0 permitir que o sistema operacional atribua uma porta disponível aleatória. inteiro 8897
--as-system-proxy Se o Proxy de Desenvolvimento deve ser registrado como o proxy do sistema na inicialização. Quando definido como true requer ser installCert , defina como true true, false true
-c, --config-file <configFile> O caminho para o arquivo de configuração Caminho de arquivo local devproxyrc.json
--detach Executar o Proxy de Desenvolvimento em segundo plano (modo desanexado) Não disponível Não disponível
--discover Executar o Dev Proxy no modo de descoberta Não disponível Não disponível
-e, --env <env> Variáveis a serem definidas para o processo do Proxy de Desenvolvimento cadeia de caracteres key1=value Não disponível
--install-cert Se o certificado raiz deve ser instalado true, false true
--ip-address <ipAddress> O endereço IP ao qual o proxy se associa Endereço IPv4 127.0.0.1
--log-level <loglevel> Nível de mensagens a serem registradas trace, debug, information, , warningerror information
--no-color Desabilite a saída colorida. Também pode ser definido por meio da variável de NO_COLOR ambiente ou TERM=dumb Não disponível Não disponível
--no-first-run Ignorar a experiência de primeira execução (não confiar no certificado no macOS) Não disponível Não disponível
--no-watch Desabilitar a reinicialização automática do proxy quando o arquivo de configuração for alterado Não disponível Não disponível
--output <format> Formato de saída para registro em log estruturado text, json text
-p, --port <port> A porta para o servidor proxy escutar. Defina para 0 permitir que o sistema operacional atribua uma porta disponível aleatória. inteiro 8000
--record Use essa opção para registrar todos os logs de solicitação Não disponível Não disponível
-t, --timeout <seconds> Parar o proxy automaticamente após um período de inatividade inteiro Não disponível
-u, --urls-to-watch <urlsToWatch> Lista de URLs que o proxy deve interceptar URL absoluta (pode conter curingas), por exemplo, "https://api.contoso.com/*" Veja o arquivo devproxyrc
--version Mostrar informações da versão Não disponível Não disponível
--watch-pids <pids> As IDs dos processos a serem observados para solicitações inteiro Não disponível
--watch-process-names <processNames> Os nomes dos processos a serem observados para solicitações cadeia Não disponível
-?, -h, --help Mostrar ajuda e informações de uso Não disponível Não disponível

Saída do modo desanexado

Quando você inicia o Proxy de Desenvolvimento com a opção --detach , ele é executado em segundo plano e imprime informações de inicialização no console.

Saída de texto (padrão)

Dev Proxy started in background.

  PID:       6456
  Proxy URL: http://127.0.0.1:8000
  API URL:   http://127.0.0.1:8897
  Log file:  /Users/user/.local/dev-proxy/logs/devproxy-6456-2026-03-05.log

Saída em JSON

Quando você usa --output json com --detacho Proxy de Desenvolvimento, o Proxy de Desenvolvimento gera JSONL de linha única para análise de computador:

Sucesso:

{"type":"result","data":{"pid":6456,"proxyUrl":"http://127.0.0.1:8000","apiUrl":"http://127.0.0.1:8897","logFile":"/Users/user/.local/dev-proxy/logs/devproxy-6456-2026-03-05.log"},"timestamp":"2026-03-05T14:22:42.0000000Z"}

Erro:

{"type":"log","level":"error","message":"Dev Proxy is already running (PID: 6456). Use 'devproxy stop' to stop it first.","timestamp":"2026-03-05T14:22:42.0000000Z"}

Dica

Use --port 0 para permitir que o sistema operacional atribua uma porta disponível aleatória. A Proxy URL saída mostra a porta real atribuída pelo sistema operacional.

Códigos de saída

Code Meaning
0 Êxito
1 Erro de runtime
2 Entrada ou uso inválido
  • Last updated on