Configuración del proxy

El proxy de desarrollo incluye varias opciones de configuración que puede usar para controlar cómo se debe ejecutar el proxy.

Puede configurar estos valores estableciendolos en el archivo devproxyrc.json , ubicado en la carpeta de instalación del proxy o estableciendolos en tiempo de ejecución a través de las opciones de la línea de comandos.

En la siguiente tabla se describen las configuraciones.

Configuración	Descripción	Opción de línea de comandos	Valores permitidos	Valor predeterminado
apiAllowedOrigins	Orígenes exactos del explorador que pueden llamar a la API de proxy de desarrollo. Todas las solicitudes siguen necesitando el token de portador de instancia.	N/D	Matriz de orígenes HTTP o HTTPS sin rutas de acceso, caracteres comodín o barras diagonales finales, por ejemplo, ["http://127.0.0.1:3000"]	[]
apiIpAddress	Dirección IP de la API de proxy de desarrollo a la que se va a enlazar. Esta configuración es independiente de ipAddress. Use una dirección que no sea de bucle invertido solo en redes de confianza porque los tokens de portador se envían a través de HTTP.	--api-ip-address <apiIpAddress>	Dirección IPv4 o IPv6	127.0.0.1
apiPort	Puerto para que la API de proxy de desarrollo autenticada escuche. Establézcalo en 0 para permitir que el sistema operativo asigne un puerto disponible aleatorio.	--api-port <apiPort>	integer	8897
asSystemProxy	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	--as-system-proxy	true, false	true
env	Variables de entorno que se van a establecer para el proceso de proxy de desarrollo. Dev Proxy los establece después de cargar el archivo de configuración y antes de cargar complementos, por lo que los complementos que leen variables de entorno usan estos valores. El proxy de desarrollo también los usa para reemplazar {name} los marcadores de posición en los archivos de especificación de API usados por los complementos MinimalPermissions. Valores pasados con --env valores de reemplazo del archivo de configuración. Los cambios en HTTP_PROXY, HTTPS_PROXY, ALL_PROXYo NO_PROXY (incluidas las variantes minúsculas) requieren detener e iniciar el proxy de desarrollo porque la recarga activa no puede actualizar la configuración del proxy HTTP almacenado en caché.	-e, --env <env>	Objeto con valores de cadena, por ejemplo, {"CI": "1"}; en la línea de comandos, uno o varios pares separados por name=value espacios	N/D
filterByHeaders	Interceptar solo solicitudes con encabezados específicos	N/D	{"filterByHeaders": [ { "name": "value" } ] }. El valor puede estar vacío para incluir solicitudes con el encabezado especificado independientemente de su valor.	N/D
installCert	Si se va a instalar el certificado raíz	--install-cert	true, false	true
ipAddress	Dirección IP del proxy al que se va a enlazar	--ip-address <ipAddress>	Dirección IPv4	127.0.0.1
languageModel	Configuración del modelo de lenguaje	N/D	Consulte la sección Modelo de lenguaje para obtener más información.	N/D
logLevel	Nivel de mensajes que se van a registrar	--log-level <loglevel>	trace, debug, information, warning, error	information
newVersionNotification	Si se debe notificar a las nuevas versiones	N/D	none, , stable, beta	stable
noColor	Deshabilitación de la salida colorada	--no-color	N/D	N/D
noFirstRun	Omitir la primera experiencia de ejecución (no confiar en el certificado en macOS)	--no-first-run	N/D	N/D
noWatch	Deshabilitar el reinicio automático del proxy cuando cambia el archivo de configuración	--no-watch	N/D	N/D
output	Formato de salida para el registro estructurado	--output <format>	text, json	text
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.	-p, --port <port>	integer	8000
record	Use esta opción para registrar todos los registros de solicitudes.	--record	N/D	N/D
showSkipMessages	Indica si se muestran los mensajes de registro cuando el proxy de desarrollo omite la ejecución de un complemento.	N/D	true, false	true
showTimestamps	Indica si se muestran las marcas de tiempo de solicitud en la salida del registro interactiva. Los archivos de registro desasociados siempre incluyen marcas de tiempo completas, por lo que puede filtrarlos por fecha y hora.	N/D	true, false	true
timeoutSeconds	Tiempo en segundos después del cual se cierra el proxy de desarrollo. Se restablece cuando dev Proxy intercepta una solicitud.	-t, --timeout <seconds>	entero positivo	N/D
urlsToWatch	Lista de direcciones URL que el proxy debe interceptar	-u, --urls-to-watch <urlsToWatch>	Dirección URL absoluta (puede contener caracteres comodín), por ejemplo, "https://api.contoso.com/*"	Consulte el archivo de devproxyrc .
validateSchemas	Si se va a validar la configuración con el esquema especificado. Solo se aplica a los archivos de configuración JSON.	N/D	true, false	true
watchPids	Los identificadores de los procesos que se van a vigilar para las solicitudes	--watch-pids <pids>	matriz de enteros; en la línea de comandos, uno o varios enteros separados por espacios	N/D
watchProcessNames	Los nombres de los procesos que se van a inspeccionar para las solicitudes	--watch-process-names <processNames>	matriz de cadenas; en la línea de comandos, uno o varios nombres separados por espacios	N/D
watchProcessTree	Si también se deben ver descendientes (procesos secundarios) de procesos seleccionados por watchPids o watchProcessNames	--watch-process-tree	true, false	false

Note

La tasa de errores no es una configuración de proxy. Para configurarlo, establezca la rate propiedad en la sección de configuración de GenericRandomErrorPlugin o GraphRandomErrorPlugin, o use la -f, --failure-rate opción de línea de comandos cuando se cargue uno de estos complementos.