(katalog główny)

Uruchamia serwer proxy deweloperów.

Streszczenie

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

Zastosowanie

devproxy

Argumenty (w programowaniu)

Żaden

Opcje

Nazwa Opis Dozwolone wartości Wartość domyślna
--api-port <apiPort> Port interfejsu API serwera proxy deweloperów do nasłuchiwania. Ustaw wartość , aby 0 umożliwić systemowi operacyjnemu przypisanie losowego dostępnego portu. liczba całkowita 8897
--as-system-proxy Czy zarejestrować serwer proxy dev jako serwer proxy systemu podczas uruchamiania. Jeśli jest ustawiona true wartość wymaga installCert , ustaw wartość na true true, false true
-c, --config-file <configFile> Ścieżka do pliku konfiguracyjnego Ścieżka do pliku lokalnego devproxyrc.json
--detach Uruchamianie serwera proxy dev w tle (tryb odłączony) N/a N/a
--discover Uruchamianie serwera proxy deweloperów w trybie odnajdywania N/a N/a
-e, --env <env> Zmienne, które należy ustawić dla procesu Dev Proxy ciąg key1=value N/a
--install-cert Czy zainstalować certyfikat główny true, false true
--ip-address <ipAddress> Adres IP serwera proxy, z który ma być powiązany Adres IPv4 127.0.0.1
--log-level <loglevel> Poziom komunikatów do rejestrowania trace, , debug, information, , warningerror information
--no-color Wyłącz kolorowe dane wyjściowe. Można również ustawić za pomocą zmiennej środowiskowej NO_COLOR lub TERM=dumb N/a N/a
--no-first-run Pomiń pierwsze środowisko uruchamiania (nie ufaj certyfikatowi w systemie macOS) N/a N/a
--no-watch Wyłącz automatyczne ponowne uruchamianie serwera proxy po zmianie pliku konfiguracji N/a N/a
--output <format> Format danych wyjściowych rejestrowania strukturalnego text, json text
-p, --port <port> Port serwera proxy do nasłuchiwania. Ustaw wartość , aby 0 umożliwić systemowi operacyjnemu przypisanie losowego dostępnego portu. liczba całkowita 8000
--record Użyj tej opcji, aby zarejestrować wszystkie dzienniki żądań N/a N/a
-t, --timeout <seconds> Automatyczne zatrzymywanie serwera proxy po okresie braku aktywności liczba całkowita N/a
-u, --urls-to-watch <urlsToWatch> Lista adresów URL, które serwer proxy powinien przechwycić Bezwzględny adres URL (może zawierać symbole wieloznaczne), na przykład "https://api.contoso.com/*" Zobacz plik devproxyrc
--version Pokaż informacje o wersji N/a N/a
--watch-pids <pids> Identyfikatory procesów do obserwowana pod kątem żądań liczba całkowita N/a
--watch-process-names <processNames> Nazwy procesów, które mają być obserwowane pod kątem żądań ciąg N/a
-?, -h, --help Pokaż pomoc i informacje o użyciu N/a N/a

Dane wyjściowe trybu odłączonego

Po uruchomieniu serwera proxy deweloperskiego z opcją --detach jest ona uruchamiana w tle i wyświetla informacje o uruchamianiu w konsoli programu .

Dane wyjściowe tekstu (wartość domyślna)

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

Dane wyjściowe w formacie JSON

W przypadku użycia z usługą --output json--detachusługa Dev Proxy generuje jednowierszowy kod JSONL na potrzeby analizowania maszyn:

Sukces:

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

Błąd:

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

Wskazówka

Umożliwia --port 0 systemowi operacyjnemu przypisanie losowego dostępnego portu. W Proxy URL danych wyjściowych jest wyświetlany rzeczywisty port przypisany przez system operacyjny.

Kody zakończenia

Code Meaning
0 Powodzenie
1 Błąd środowiska uruchomieniowego
2 Nieprawidłowe dane wejściowe lub użycie