开发代理附带了多个设置，可用于控制代理的运行方式。
可以通过在 位于代理安装文件夹的 devproxyrc.json 文件中设置这些设置，或通过命令行选项在运行时设置这些设置来配置这些设置。
下表描述了这些设置。
| 设置 | 说明 | 命令行选项 | 允许的值 | 默认值 |
|---|---|---|---|---|
apiAllowedOrigins |
可以调用开发代理 API 的确切浏览器源。 所有请求仍需要实例持有者令牌。 | 不适用 | 不带路径、通配符或尾部斜杠的 HTTP 或 HTTPS 源数组，例如 ["http://127.0.0.1:3000"] |
[] |
apiIpAddress |
要绑定到的开发代理 API 的 IP 地址。 此设置独立于 ipAddress. 仅在受信任的网络上使用非环回地址，因为持有者令牌通过 HTTP 发送。 |
--api-ip-address <apiIpAddress> |
IPv4 或 IPv6 地址 | 127.0.0.1 |
apiPort |
要侦听的经过身份验证的开发代理 API 的端口。
0设置为允许 OS 分配随机可用端口。 |
--api-port <apiPort> |
整数 | 8897 |
asSystemProxy |
是否在启动时将开发代理注册为系统代理。
true设置为“需要installCert”时，设置为true |
--as-system-proxy |
true、false |
true |
filterByHeaders |
仅截获具有特定标头的请求 | 不适用 |
{"filterByHeaders": [ { "name": "value" } ] }。 无论其值如何，值都可以为空，以包含具有指定标头的请求。 |
不适用 |
installCert |
是否安装根证书 | --install-cert |
true、false |
true |
ipAddress |
要绑定到的代理的 IP 地址 | --ip-address <ipAddress> |
IPv4 地址 | 127.0.0.1 |
languageModel |
语言模型的设置 | 不适用 | 有关详细信息， 请参阅语言模型 部分。 | 不适用 |
logLevel |
要记录的消息级别 | --log-level <loglevel> |
trace、debug、information、warning、error |
information |
newVersionNotification |
是否通知新版本 | 不适用 |
none、stable、beta |
stable |
noColor |
禁用彩色输出 | --no-color |
不适用 | 不适用 |
noFirstRun |
跳过第一次运行体验（不信任 macOS 上的证书） | --no-first-run |
不适用 | 不适用 |
noWatch |
禁用配置文件更改时自动重启代理 | --no-watch |
不适用 | 不适用 |
output |
结构化日志记录的输出格式 | --output <format> |
text、json |
text |
port |
要侦听的代理服务器的端口。
0设置为允许 OS 分配随机可用端口。 |
-p, --port <port> |
整数 | 8000 |
rate |
代理失败请求的可能性百分比。
0设置为将所有请求传递到 API，并100失败所有请求。 |
-f, --failure-rate <failurerate> |
0..100 |
50 |
record |
使用此选项记录所有请求日志 | --record |
不适用 | 不适用 |
showSkipMessages |
当开发代理跳过运行插件时是否显示日志消息。 | 不适用 |
true、false |
true |
timeout |
在处于非活动状态的时间段后自动停止代理 | -t, --timeout <seconds> |
整数 | 不适用 |
urlsToWatch |
代理应截获的 URL 列表 | -u, --urls-to-watch <urlsToWatch> |
例如，绝对 URL（可以包含通配符） "https://api.contoso.com/*" |
请参阅 devproxyrc 文件 |
validateSchemas |
是否根据指定的架构验证配置。 仅适用于 JSON 配置文件。 | 不适用 |
true、false |
true |
watchPids |
要监视请求的进程 ID | --watch-pids <pids> |
整数 | 不适用 |
watchProcessNames |
要监视请求的进程的名称 | --watch-process-names <processNames> |
字符串 | 不适用 |
