(raíz)

Inicia Dev Proxy.

Sinopsis

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

Ninguno

Opciones

Nombre Descripción Valores permitidos Predeterminado
--api-port <apiPort> Puerto de la API de proxy de desarrollo en el que se va a escuchar. Establézcalo en 0 para permitir que el sistema operativo asigne un puerto disponible aleatorio. entero 8897
--as-system-proxy Indica si se va a registrar dev Proxy como proxy del sistema al iniciarse. Cuando se establece en true es necesario installCert , establezca en . true true, false true
-c, --config-file <configFile> La ruta de acceso al archivo de configuración Ruta de acceso de archivo local devproxyrc.json
--detach Ejecutar proxy de desarrollo en segundo plano (modo desasociado) N/A N/A
--discover Ejecución de Dev Proxy en modo de detección N/A N/A
-e, --env <env> Variables que se van a establecer para el proceso de Dev Proxy cadena key1=value N/A
--install-cert Si se va a instalar el certificado raíz true, false true
--ip-address <ipAddress> Dirección IP del proxy al que se va a enlazar Dirección IPv4 127.0.0.1
--log-level <loglevel> Nivel de mensajes que se van a registrar trace, debug, information, , warning, error information
--no-color Deshabilite la salida colorada. También se puede establecer a través de la variable de NO_COLOR entorno o TERM=dumb N/A N/A
--no-first-run Omitir la primera experiencia de ejecución (no confiar en el certificado en macOS) N/A N/A
--no-watch Deshabilitar el reinicio automático del proxy cuando cambia el archivo de configuración N/A N/A
--output <format> Formato de salida para el registro estructurado text, json text
-p, --port <port> Puerto en el que se va a escuchar el servidor proxy. Establézcalo en 0 para permitir que el sistema operativo asigne un puerto disponible aleatorio. entero 8000
--record Use esta opción para registrar todos los registros de solicitudes. N/A N/A
-t, --timeout <seconds> Detener automáticamente el proxy después de un período de inactividad entero N/A
-u, --urls-to-watch <urlsToWatch> Lista de direcciones URL que el proxy debe interceptar Dirección URL absoluta (puede contener caracteres comodín), por ejemplo, "https://api.contoso.com/*" Consulte el archivo de devproxyrc .
--version Mostrar información de la versión N/A N/A
--watch-pids <pids> Los identificadores de los procesos que se van a vigilar para las solicitudes entero N/A
--watch-process-names <processNames> Los nombres de los procesos que se van a inspeccionar para las solicitudes cuerda / cadena N/A
-?, -h, --help Mostrar ayuda e información de uso N/A N/A

Salida del modo desasociado

Al iniciar el proxy de desarrollo con la --detach opción , se ejecuta en segundo plano e imprime la información de inicio en la consola.

Salida de texto (valor predeterminado)

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

Salida JSON

Cuando se usa --output json con --detach, el proxy de desarrollo genera JSONL de línea única para el análisis de máquinas:

Correcto:

{"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"}

Error:

{"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"}

Sugerencia

Use --port 0 para permitir que el sistema operativo asigne un puerto disponible aleatorio. En Proxy URL la salida se muestra el puerto real asignado por el sistema operativo.

Códigos de salida

Código Meaning
0 Success
1 Error en tiempo de ejecución
2 Entrada o uso no válidos
  • Last updated on