開發 Proxy 隨附數個設定，可用來控制 Proxy 的執行方式。
您可以在位於 Proxy 安裝資料夾的 devproxyrc.json 檔案中設定這些設定，或透過命令行選項在執行時間設定這些設定。
下表說明設定。
| 設定 | 描述 | 命令列選項 | 允許的值 | 預設值 |
|---|---|---|---|---|
apiAllowedOrigins |
能呼叫開發代理 API 的精確瀏覽器來源。 所有請求仍需實例承載令牌。 | n/a | 例如，沒有路徑、萬用字元或尾部斜線的 HTTP 或 HTTPS 來源陣列， ["http://127.0.0.1:3000"] |
[] |
apiIpAddress |
開發代理 API 綁定的 IP 位址。 此設定與 無關。ipAddress 只有在受信任的網路上才使用非迴迴位址，因為承載憑證是透過 HTTP 傳送的。 |
--api-ip-address <apiIpAddress> |
IPv4 或 IPv6 位址 | 127.0.0.1 |
apiPort |
這是驗證過的 Dev Proxy API 的接收埠。 設定為 0 讓作業系統隨機指派一個可用埠口。 |
--api-port <apiPort> |
整數 | 8897 |
asSystemProxy |
是否要在啟動時將開發 Proxy 註冊為系統 Proxy。 當 設定為 true 需要 installCert 時，請將 設定為 true |
--as-system-proxy |
true、false |
true |
env |
為開發代理程序設定的環境變數。 Dev Proxy 會在載入設定檔後、載入外掛前設定這些值，所以讀取環境變數的外掛會使用這些值。 Dev Proxy 也會用它們來替換 {name} MinimalPermissions 外掛所用的 API 規格檔中的佔位符。 傳遞的 --env 值會替換設定檔中的值。 對 、 HTTPS_PROXY、 ALL_PROXY或 NO_PROXY （包括小寫變體）的變更HTTP_PROXY需要停止並啟動開發代理，因為熱載入無法刷新快取的 HTTP 代理設定。 |
-e, --env <env> |
例如，具有字串值 {"CI": "1"}的物件;在命令列中，一對或多個空格分隔 name=value 的對 |
n/a |
filterByHeaders |
僅攔截具有特定標頭的要求 | n/a |
{"filterByHeaders": [ { "name": "value" } ] }。 值可以是空的，以包含具有指定標頭的要求，無論其值為何。 |
n/a |
installCert |
是否安裝跟證書 | --install-cert |
true、false |
true |
ipAddress |
要系結至之 Proxy 的IP位址 | --ip-address <ipAddress> |
IPv4 位址 | 127.0.0.1 |
languageModel |
語言模型的設定 | n/a | 如需詳細資訊， 請參閱語言模型 一節。 | n/a |
logLevel |
要記錄的訊息層級 | --log-level <loglevel> |
trace、、 debug、 information、 warning、 error |
information |
newVersionNotification |
是否要通知新版本 | n/a |
none、stable、beta |
stable |
noColor |
關閉彩色輸出 | --no-color |
n/a | n/a |
noFirstRun |
略過第一次執行體驗（不信任 macOS 上的憑證） | --no-first-run |
n/a | n/a |
noWatch |
當設定檔變更時，請停用自動代理重啟 | --no-watch |
n/a | n/a |
output |
結構化日誌的輸出格式 | --output <format> |
text、json |
text |
port |
代理伺服器要監聽的埠口。 設定為 0 讓作業系統隨機指派一個可用埠口。 |
-p, --port <port> |
整數 | 8000 |
record |
使用此選項來記錄所有要求記錄 | --record |
n/a | n/a |
showSkipMessages |
當 Dev Proxy 略過執行外掛程式時，是否要顯示記錄訊息。 | n/a |
true、false |
true |
showTimestamps |
是否要在互動式日誌輸出中顯示請求時間戳。 分離日誌檔案總是包含完整的時間戳，所以你可以依日期和時間來篩選它們。 | n/a |
true、false |
true |
timeoutSeconds |
時間以秒數計算，之後 Dev Proxy 就會退出。 當開發代理攔截請求時會重置。 | -t, --timeout <seconds> |
正整數 | n/a |
urlsToWatch |
Proxy 應攔截的 URL 清單 | -u, --urls-to-watch <urlsToWatch> |
例如，絕對 URL （可包含通配符） "https://api.contoso.com/*" |
請參閱 devproxyrc 檔案 |
validateSchemas |
是否要根據指定的結構驗證設定。 僅適用於 JSON 設定檔。 | n/a |
true、false |
true |
watchPids |
要監看要求之程式的標識碼 | --watch-pids <pids> |
整數陣列;在命令列中，一個或多個空格分隔的整數 | n/a |
watchProcessNames |
要監看要求的進程名稱 | --watch-process-names <processNames> |
字串陣列;在命令列中，一個或多個空格分隔的名稱 | n/a |
watchProcessTree |
是否也要監控由 watchPids 或 選擇的程序的後代（子程序） watchProcessNames |
--watch-process-tree |
true、false |
false |
備註
失敗率不是代理設定。 要設定時，請在 GenericRandomErrorPlugin 或 GraphRandomErrorPlugin 的設定區段設定該rate屬性，或在載入這些插件時使用-f, --failure-rate命令列選項。
