Rediger

Del via


Proxy settings

Dev Proxy comes with several settings that you can use to control how the proxy should run.

You can configure these settings by setting them in the devproxyrc.json file, located in the proxy installation folder, or by setting them at run time through command line options.

The following table describes the settings.

Setting Description Command-line option Allowed values Default value
apiPort The port for the Dev Proxy API to listen on. Set to 0 to let the OS assign a random available port. --api-port <apiPort> integer 8897
asSystemProxy Whether to register Dev Proxy as the system proxy on startup. When set to true requires installCert to be, set to true --as-system-proxy true, false true
filterByHeaders Only intercept requests with specific headers n/a {"filterByHeaders": [ { "name": "value" } ] }. Value can be empty to include requests with the specified header no matter its value. n/a
installCert Whether to install the root certificate --install-cert true, false true
ipAddress The IP address for the proxy to bind to --ip-address <ipAddress> IPv4 address 127.0.0.1
languageModel Settings for the language model n/a See the language model section for more information. n/a
logLevel Level of messages to log --log-level <loglevel> trace, debug, information, warning, error information
newVersionNotification Whether to notify about new versions n/a none, stable, beta stable
noColor Disable colored output --no-color n/a n/a
noFirstRun Skip the first run experience (don't trust certificate on macOS) --no-first-run n/a n/a
noWatch Disable automatic proxy restart when the configuration file changes --no-watch n/a n/a
output Output format for structured logging --output <format> text, json text
port The port for the proxy server to listen on. Set to 0 to let the OS assign a random available port. -p, --port <port> integer 8000
rate The percentage of chance that proxy fails a request. Set to 0 to pass all requests to APIs, and to 100 to fail all requests. -f, --failure-rate <failurerate> 0..100 50
record Use this option to record all request logs --record n/a n/a
showSkipMessages Whether to show log messages when Dev Proxy skips running a plugin. n/a true, false true
timeout Automatically stop proxy after a period of inactivity -t, --timeout <seconds> integer n/a
urlsToWatch List of URLs that proxy should intercept -u, --urls-to-watch <urlsToWatch> Absolute URL (can contain wildcards) for example, "https://api.contoso.com/*" See devproxyrc file
validateSchemas Whether to validate configuration against the specified schema. Applies to JSON configuration files only. n/a true, false true
watchPids The IDs of processes to watch for requests --watch-pids <pids> integer n/a
watchProcessNames The names of processes to watch for requests --watch-process-names <processNames> string n/a