PACファイルは、どのサイトにどのプロキシを使うかをブラウザに指示します。すべてを1つのプロキシに通す、あるいは何も通さないのではなく、短いルールを書きます。たとえば、このショップ群はドイツのレジデンシャルプロキシを経由し、社内イントラネットは直接接続、それ以外はデフォルトに従う、といった具合です。ブラウザはリクエストごとにそのルールを読み込みます。
PACはproxy auto-configの略です。このフォーマットは1990年代のNetscapeにまでさかのぼり、現在も主要なブラウザやOSすべてでサポートされています。本ガイドでは、このファイルの仕組みを説明し、コピーして使える4つの例を示し、各システムでの設定場所を解説し、気づかないうちにトラフィックがプロキシの外へ送られてしまうミスを挙げます。
PACファイルの仕組み
PACファイルは、必須の関数を1つ持つ普通のJavaScriptです。
function FindProxyForURL(url, host) {
return "PROXY p.shifter.io:443";
}
ブラウザはリクエストごとにFindProxyForURLを呼び出し、完全なURLとホスト名を渡します。この関数はリクエストの送り先を示す文字列を返します。
| 戻り値 | 意味 |
|---|---|
DIRECT | プロキシなしで接続する |
PROXY host:port | HTTPプロキシを使う |
HTTPS host:port | プロキシへのTLS接続を通じてHTTPプロキシを使う |
SOCKS5 host:port | SOCKS5プロキシを使う |
複数の回答をセミコロンでつなぐこともでき、たとえばPROXY p.shifter.io:443; DIRECTのように書けます。ブラウザはこれらを順番に試し、プロキシに到達できない場合は次に進みます。このフォールバックは便利な一方で、後述するように、トラフィックがプロキシを迂回してしまう最も一般的な原因でもあります。
Shifterの場合はPROXYを使ってください。ブラウザはPACファイルからSOCKS5プロキシへのサインインをサポートしておらず、ゲートウェイは同じポートでHTTPプロキシ接続を受け付けます。
よく使うヘルパー関数
PACの実行環境は、普通のJavaScriptにいくつかの関数を追加します。以下の4つでほとんどのルールをカバーできます。
isPlainHostName(host):intranetのようにドットを含まない名前の場合にtrueを返します。dnsDomainIs(host, ".example.com"): ホストがそのドメインで終わる場合にtrueを返します。shExpMatch(host, "*.example.*"): シェル形式のワイルドカードにマッチします。isInNet(ip, "10.0.0.0", "255.0.0.0"): IPがそのネットワーク範囲内にある場合にtrueを返します。
ホストのIPを調べるdnsResolve(host)という関数もあります。これは後述のミスの項で触れる理由から、使用は控えめにしてください。
すぐに使える4つの例
ドメイン部分を自分のものに置き換えてください。各例はそれぞれ完全なファイルとして動作します。
1. すべてをプロキシ経由にし、ローカルアドレスのみ直接接続
function FindProxyForURL(url, host) {
if (isPlainHostName(host) ||
host === "localhost" ||
shExpMatch(host, "*.local") ||
shExpMatch(host, "127.*") ||
shExpMatch(host, "10.*") ||
shExpMatch(host, "192.168.*")) {
return "DIRECT";
}
return "PROXY p.shifter.io:443";
}
これにより、ルーターやプリンター、ローカルの開発サーバーには到達可能なまま、すべてのウェブサイトがプロキシを経由するようになります。
2. 特定のサイトのリストだけをプロキシ経由にする
var VIA_PROXY = [".example-shop.com", ".example-news.de"];
function FindProxyForURL(url, host) {
host = host.toLowerCase();
for (var i = 0; i < VIA_PROXY.length; i++) {
if (dnsDomainIs(host, VIA_PROXY[i]) || "." + host === VIA_PROXY[i]) {
return "PROXY p.shifter.io:443";
}
}
return "DIRECT";
}
これはPACファイルを書く最も一般的な理由です。通常のブラウジングは自分自身の回線のまま行われ、確認対象のサイトだけがプロキシを経由するため、GBあたりのトラフィックも低く抑えられます。QAチームは、他の市場からの店舗やアプリのウェブビューを確認しつつ、それ以外のツールはいつも通り使えるようにするためにこれを利用します。プロキシを使ったローカライゼーションQAのページでは、このワークフローを扱っています。
3. フォールバックとフェイルクローズドのどちらにするか選ぶ
function FindProxyForURL(url, host) {
if (dnsDomainIs(host, ".example-shop.com")) {
// Fail closed: if the proxy is down, the page does not load.
return "PROXY p.shifter.io:443";
}
if (dnsDomainIs(host, ".example-news.de")) {
// Fall back: if the proxy is down, the page loads from your own IP.
return "PROXY p.shifter.io:443; DIRECT";
}
return "DIRECT";
}
例1、2、4はいずれもフェイルクローズドです。つまり、プロキシの後に; DIRECTがありません。プロキシに到達できない場合、これらのページはエラーを表示し、気づかないうちに実際のIPから読み込まれることはありません。プロキシを使う目的が別の場所からサイトを見ることである場合、一見正しく見える誤った結果よりも、エラーの方が望ましいでしょう。フォールバックは、何も表示されないよりはどんな結果でも表示された方がましなサイトにだけ追加してください。
4. いくつかのサイトを除いてすべてをプロキシ経由にする
var DIRECT_SITES = [".zoom.us", ".slack.com", ".yourcompany.com"];
function FindProxyForURL(url, host) {
host = host.toLowerCase();
if (isPlainHostName(host)) return "DIRECT";
for (var i = 0; i < DIRECT_SITES.length; i++) {
if (dnsDomainIs(host, DIRECT_SITES[i])) return "DIRECT";
}
return "PROXY p.shifter.io:443";
}
通話、チャット、社内ツールは最も速度が出る自分自身の回線のままにし、それ以外のブラウザ利用はプロキシ経由になります。
PACファイルの設定場所
PACファイルはテキストとして貼り付けるのではなく、URLとして設定します。自分が管理するウェブサーバーから、タイプapplication/x-ns-proxy-autoconfigで配信してください。Windowsはスクリプトのローカルファイルパスを受け付けないため、どの環境でもウェブURLにしておくのが安全な選択です。
- Windows 11: 設定 > ネットワークとインターネット > プロキシ。自動プロキシのセットアップの下でセットアップスクリプトを使うをオンにし、URLを入力します。
- macOS: システム設定 > ネットワーク > 対象の接続 > 詳細 > プロキシ。自動プロキシ構成をオンにし、URLを入力します。
- Firefox: 設定 > ネットワーク設定 > 自動プロキシ構成URL。
- Chrome、Edge: 上記のシステム設定に従います。
- iPhone: 設定 > Wi-Fi > 情報ボタン > プロキシを構成 > 自動、そしてURLを入力します。
- Android: Wi-Fiネットワークの詳細設定 > プロキシ > プロキシ自動構成、そしてURLを入力します。
同じ画面の手動版が必要な場合、つまりすべてに1つのプロキシを使いたい場合は、WindowsとmacOSでのプロキシ設定のガイドをご覧ください。
サインインと、ロケーションが一度に決まる理由
PACファイルにはユーザー名やパスワードを入れる場所がありません。リクエストがプロキシに到達すると、プロキシが認証情報を要求し、ブラウザがサインインのプロンプトを表示します。プロキシの完全なユーザー名とパスワードを入力してください。プロンプトが何度も繰り返し表示される場合は、認証情報が拒否されています。ダッシュボードから両方をもう一度コピーし、ターゲティング部分のスペルを確認してください。
Shifterでは、ロケーションとセッションはユーザー名の中に含まれます。たとえばcustomer-USERNAME-country-de-sid-qa1-ttl-1800は、30分間保持されるドイツのIPを表します。つまり、PACファイルはどのサイトがプロキシを使うかを決め、サインインに使うユーザー名はどこから見えるかを決めます。1つのブラウザセッションは1つのロケーションに対応します。同時に異なるサイトで異なる国を使いたい場合は、別々のブラウザプロファイルを使うか、クリックひとつでロケーションを切り替えられるShifterブラウザ拡張機能を使ってください。
トラフィックがプロキシを迂回してしまうミス
- 意図しないフォールバック。
PROXY ...; DIRECTは、プロキシが失敗するたびに実際のIPからページを読み込みます。これが許容できる場合にのみ使ってください。 - 壊れている、または到達できないファイル。 PACのURLが読み込めなかったり、スクリプトがエラーを投げたりすると、多くのブラウザは直接接続します。編集のたびにテストし、ファイルは小さく保ってください。
- HTTPS URLのパスに対するルール。 ブラウザは関数を呼び出す前にHTTPS URLからパスとクエリを取り除くため、
urlにはhttps://example.com/のようなものしか残りません。hostに対してマッチさせてください。 - ルール内でのDNSルックアップ。 ホスト名に対する
dnsResolveやisInNetは、まず自分自身のネットワーク上でその名前を調べます。これはすべてのリクエストを遅くするだけでなく、ページ自体はプロキシを経由していても、訪問先サイトの名前をローカルのDNSリゾルバに送ってしまいます。レジデンシャルプロキシでDNSリークを防ぐガイドでは、これが重要な理由を扱っています。名前だけで動作するdnsDomainIsとshExpMatchを優先してください。 - 古いバージョンがキャッシュされている。 ブラウザはPACファイルをキャッシュします。編集後はブラウザを再起動するか、設定を再適用してください(Chromeの場合は
chrome://net-internals/#proxy)。 - 頼んでいない自動検出。 「設定を自動的に検出する」(WPAD)は、接続したネットワークがデバイスにPACファイルを渡すことを許可してしまいます。信頼できないネットワークでは、これをオフにしてください。
動作確認
ルールにテスト用のドメインを追加し、そのルールがプロキシを経由するように設定した状態と、直接接続になる状態の両方でip-info.comを開いてみてください。1回目のアクセスではプロキシのIPとユーザー名に含まれるロケーションが表示され、2回目では自分自身のものが表示されるはずです。その後、リストに含まれていないサイトを開き、問題なく読み込まれることを確認してください。
まとめ
PACファイルは、サイトごとにリクエストをプロキシ経由にするかどうかを決める、数行のJavaScriptです。ルールはホスト名に対して設定し、その中でのDNSルックアップは避け、フォールバックとフェイルクローズドのどちらにするかを意図的に選び、ファイルはURLから配信してください。ロケーションを決めるのは依然としてプロキシのユーザー名なので、ブラウザプロファイルごとに1つのロケーションになるよう計画してください。