(Stamm)

Startet den Dev Proxy.

Zusammenfassung

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

Verwendung

devproxy

Argumente

Nichts

Optionen

Name BESCHREIBUNG Zulässige Werte Standard
--api-port <apiPort> Der Port für die Dev-Proxy-API zum Überwachen. Legen Sie fest, 0 dass das Betriebssystem einen zufällig verfügbaren Port zuweisen kann. Integer 8897
--as-system-proxy Gibt an, ob Dev Proxy beim Start als Systemproxy registriert werden soll. Wenn die Einstellung auf true "Erforderlich installCert " festgelegt sein muss, legen Sie diesen auf true true, false true
-c, --config-file <configFile> Der Pfad zur Konfigurationsdatei Lokaler Dateipfad devproxyrc.json
--detach Ausführen von Dev Proxy im Hintergrund (getrennter Modus) n/a n/a
--discover Ausführen des Dev-Proxys im Ermittlungsmodus n/a n/a
-e, --env <env> Variablen, die für den Dev Proxy-Prozess festgelegt werden sollen Zeichenfolge key1=value n/a
--install-cert Gibt an, ob das Stammzertifikat installiert werden soll. true, false true
--ip-address <ipAddress> Die IP-Adresse für den Proxy, an den eine Bindung erfolgen soll IPv4-Adresse 127.0.0.1
--log-level <loglevel> Ebene der zu protokollierenden Nachrichten trace, , debuginformation, , warningerror information
--no-color Farbausgabe deaktivieren. Kann auch über die Umgebungsvariable NO_COLOR oder TERM=dumb n/a n/a
--no-first-run Überspringen der ersten Ausführungsumgebung (Zertifikat auf macOS nicht als vertrauenswürdig festlegen) n/a n/a
--no-watch Deaktivieren des automatischen Neustarts des Proxys, wenn sich die Konfigurationsdatei ändert n/a n/a
--output <format> Ausgabeformat für strukturierte Protokollierung text, json text
-p, --port <port> Der Port für den Proxyserver, der überwacht werden soll. Legen Sie fest, 0 dass das Betriebssystem einen zufällig verfügbaren Port zuweisen kann. Integer 8000
--record Verwenden Sie diese Option, um alle Anforderungsprotokolle aufzuzeichnen. n/a n/a
-t, --timeout <seconds> Automatisches Beenden des Proxys nach einem Zeitraum der Inaktivität Integer n/a
-u, --urls-to-watch <urlsToWatch> Liste der URLs, die der Proxy abfangen soll Absolute URL (kann z. B. Wildcards enthalten) "https://api.contoso.com/*" Siehe devproxyrc-Datei
--version Versionsinformationen anzeigen n/a n/a
--watch-pids <pids> Die IDs von Prozessen, die auf Anforderungen zu achten sind Integer n/a
--watch-process-names <processNames> Die Namen der Prozesse, die auf Anforderungen überwacht werden sollen Schnur n/a
-?, -h, --help Anzeigen von Hilfe- und Nutzungsinformationen n/a n/a

Ausgabe des getrennten Modus

Wenn Sie Dev Proxy mit der --detach Option starten, wird sie im Hintergrund ausgeführt und druckt Startinformationen in die Konsole.

Textausgabe (Standard)

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

JSON-Ausgabe

Bei Verwendung --output json mit --detach, gibt Dev Proxy eine einzeilige JSONL für die Computeranalyse aus:

Erfolg:

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

Fehler:

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

Tipp

Wird verwendet --port 0 , damit das Betriebssystem einen zufällig verfügbaren Port zuweisen kann. Die Proxy URL Ausgabe zeigt den tatsächlichen Port an, der vom Betriebssystem zugewiesen ist.

Exitcodes

Code Bedeutung
0 Success
1 Laufzeitfehler
2 Ungültige Eingabe oder Verwendung
  • Last updated on