PAC 文件会告诉浏览器针对哪个网站使用哪个代理。你无需把所有流量都发给同一个代理,也无需完全不用代理,而是编写一条简短的规则:这些商店走德国的住宅代理,公司内网直连,其余流量按默认方式处理。浏览器在发出每个请求之前都会读取这条规则。
PAC 是 proxy auto-config 的缩写。该格式可追溯到 1990 年代的 Netscape,如今仍被所有主流浏览器和操作系统支持。本指南将说明该文件的工作原理,给出四个可直接复制使用的示例,展示如何在各系统上进行设置,并列出那些会悄悄让流量绕过代理的常见错误。
PAC 文件的工作原理
PAC 文件是一段普通的 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 基础上增加了几个函数。以下四个涵盖了大多数规则:
isPlainHostName(host):对于不含点号的名称(如intranet)返回 true。dnsDomainIs(host, ".example.com"):当主机名以该域名结尾时返回 true。shExpMatch(host, "*.example.*"):匹配 shell 风格的通配符。isInNet(ip, "10.0.0.0", "255.0.0.0"):当某个 IP 处于指定网络范围内时返回 true。
此外还有 dnsResolve(host),用于查询某个主机名对应的 IP。请谨慎使用它,原因见后文”错误”部分。
四个可直接使用的示例
将其中的域名替换为你自己的即可。每个示例都是一份完整的文件。
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")) {
// 关闭失败:如果代理不可用,页面将无法加载。
return "PROXY p.shifter.io:443";
}
if (dnsDomainIs(host, ".example-news.de")) {
// 回退:如果代理不可用,页面将通过你自己的 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 形式进行设置的,而不是直接粘贴文本。请将其托管在你能控制的 Web 服务器上,类型设为 application/x-ns-proxy-autoconfig。Windows 不接受脚本的本地文件路径,因此在任何系统上使用 Web URL 都是更稳妥的选择。
- Windows 11: 设置 > 网络和 Internet > 代理。在自动代理设置下,开启使用设置脚本并输入该 URL。
- macOS: 系统设置 > 网络 > 你的连接 > 详细信息 > 代理。开启自动代理配置并输入该 URL。
- Firefox: 设置 > 网络设置 > 自动代理配置 URL。
- Chrome 和 Edge: 两者都遵循上述系统设置。
- iPhone: 设置 > Wi-Fi > 信息按钮 > 配置代理 > 自动,然后输入该 URL。
- Android: 该 Wi-Fi 网络的高级选项 > 代理 > 代理自动配置,然后输入该 URL。
我们关于在 Windows 和 macOS 上设置代理 的指南展示了同一些设置界面的手动版本,如果你想让所有流量都走同一个代理,可以参考那篇文章。
登录,以及位置为何只设置一次
PAC 文件中没有地方填写用户名或密码。当请求到达代理时,代理会要求提供凭证,浏览器会弹出登录提示框。请输入你完整的代理用户名和密码。如果提示框反复出现,说明凭证被拒绝了:请再次从控制面板中复制用户名和密码,并检查定向部分的拼写是否正确。
在 Shifter 中,位置和会话信息保存在用户名里,例如 customer-USERNAME-country-de-sid-qa1-ttl-1800 表示一个保持 30 分钟的德国 IP。因此,PAC 文件决定哪些网站使用代理,而你用来登录的用户名则决定它们从何处显示出来。一个浏览器会话对应一个位置。如果你需要同时为不同网站使用不同国家,可使用不同的浏览器配置文件,或使用 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 两次:一次让该规则把它指向代理,一次让它直连。第一次访问应显示代理的 IP 以及你用户名中的位置;第二次应显示你自己的信息。然后打开一个不在你列表中的网站,确认它仍能正常加载。
结论
PAC 文件是一段简短的 JavaScript 代码,它会逐个网站地决定某个请求是否经过代理。请让规则基于主机名,避免在其中进行 DNS 查询,在回退与关闭失败之间做出明确选择,并通过 URL 来托管该文件。位置仍由代理用户名设定,因此请为每个浏览器配置文件规划好对应的一个位置。