開発プロキシには、プロキシの実行方法を制御するために使用できるいくつかの設定が用意されています。
これらの設定を構成するには、プロキシ インストール フォルダーにある devproxyrc.json ファイルで設定するか、実行時にコマンド ライン オプションを使用して設定します。
次の表に設定を示します。
| 設定 | 説明 | コマンドライン オプション | 使用できる値 | 規定値 |
|---|---|---|---|---|
apiAllowedOrigins |
開発プロキシ API を呼び出すことができる正確なブラウザーの配信元。 すべての要求には、インスタンス ベアラー トークンが引き続き必要です。 | 該当なし | パス、ワイルドカード、または末尾のスラッシュを含まない HTTP または HTTPS オリジンの配列 (例: ["http://127.0.0.1:3000"] |
[] |
apiIpAddress |
バインド先の Dev Proxy API の IP アドレス。 この設定は、 ipAddressとは無関係です。 ベアラー トークンは HTTP 経由で送信されるため、非ループバック アドレスは信頼されたネットワークでのみ使用します。 |
--api-ip-address <apiIpAddress> |
IPv4 または IPv6 アドレス | 127.0.0.1 |
apiPort |
リッスンする認証済み開発プロキシ API のポート。 OS がランダムに使用可能なポートを割り当てできるようにするには、 0 に設定します。 |
--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 |
リッスンするプロキシ サーバーのポート。 OS がランダムに使用可能なポートを割り当てできるようにするには、 0 に設定します。 |
-p, --port <port> |
整数 | 8000 |
rate |
プロキシが要求に失敗する確率の割合。 すべての要求を API に渡し、すべての要求に失敗するように0するには、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> |
文字列 | 該当なし |
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
Dev Proxy