(radice)

Avvia Dev Proxy.

Synopsis

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

Argomenti

Nessuno

Opzioni

Nome	Descrizione	Valori consentiti	Predefinito
--api-port <apiPort>	Porta per l'API del proxy di sviluppo su cui restare in ascolto. Impostare su 0 per consentire al sistema operativo di assegnare una porta disponibile casuale.	numero intero	8897
--as-system-proxy	Indica se registrare Dev Proxy come proxy di sistema all'avvio. Se impostato su true deve installCert essere, impostare su true	true, false	true
-c, --config-file <configFile>	Il percorso del file di configurazione	Percorso del file locale	devproxyrc.json
--detach	Eseguire il proxy di sviluppo in background (modalità disconnessa)	non disponibile	non disponibile
--discover	Esegui Dev Proxy in modalità di individuazione	non disponibile	non disponibile
-e, --env <env>	Variabili da impostare per il processo Dev Proxy	stringa key1=value	non disponibile
--install-cert	Se installare il certificato radice	true, false	true
--ip-address <ipAddress>	Indirizzo IP per il proxy a cui eseguire l'associazione	Indirizzo IPv4	127.0.0.1
--log-level <loglevel>	Livello di messaggi da registrare	trace, debug, information, , warning, error	information
--no-color	Disabilitare l'output colorato. Può essere impostata anche tramite la variabile di NO_COLOR ambiente o TERM=dumb	non disponibile	non disponibile
--no-first-run	Ignorare la prima esperienza di esecuzione (non considerare attendibile il certificato in macOS)	non disponibile	non disponibile
--no-watch	Disabilitare il riavvio automatico del proxy quando il file di configurazione cambia	non disponibile	non disponibile
--output <format>	Formato di output per la registrazione strutturata	text, json	text
-p, --port <port>	Porta su cui il server proxy deve essere in ascolto. Impostare su 0 per consentire al sistema operativo di assegnare una porta disponibile casuale.	numero intero	8000
--record	Usare questa opzione per registrare tutti i log delle richieste	non disponibile	non disponibile
-t, --timeout <seconds>	Arrestare automaticamente il proxy dopo un periodo di inattività	numero intero	non disponibile
-u, --urls-to-watch <urlsToWatch>	Elenco di URL che il proxy deve intercettare	URL assoluto (può contenere caratteri jolly), ad esempio "https://api.contoso.com/*"	Vedere il file devproxyrc
--version	Mostra informazioni sulla versione	non disponibile	non disponibile
--watch-pids <pids>	ID dei processi da controllare per le richieste	numero intero	non disponibile
--watch-process-names <processNames>	Nomi dei processi da controllare per le richieste	corda	non disponibile
-?, -h, --help	Mostra la Guida e le informazioni sull'utilizzo	non disponibile	non disponibile

Output della modalità disconnessa

Quando si avvia Dev Proxy con l'opzione --detach , viene eseguito in background e stampa le informazioni di avvio nella console.

Output di testo (impostazione predefinita)

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

Output JSON

Quando si usa --output json con --detach, Dev Proxy restituisce JSONL a riga singola per l'analisi del computer:

Successo:

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

Errore:

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

Suggerimento

Usare --port 0 per consentire al sistema operativo di assegnare una porta disponibile casuale. Proxy URL Nell'output viene visualizzata la porta effettiva assegnata dal sistema operativo.

Codici di uscita

Codice	Meaning
0	Success
1	Errore di runtime
2	Input o utilizzo non validi