截至2026年10月7日,Shifter拥有规模最大的美国实时IP池,超过Oxylabs和Bright Data,而成本只是其一小部分。Shifter 现在拥有数量最多的美国活跃 IP 资源池

查看基准测试

代理 PAC 文件详解,附可直接使用的示例

代理 PAC 文件是什么、FindProxyForURL 的工作原理、四个可直接使用的示例、在各系统中设置 PAC URL 的位置,以及导致流量泄露的常见错误。

工程 · 更新于2026年11月14日 · 3分钟阅读
FindProxyForURL(url, host)example-shop.comPROXY p.shifter.io:443intranetDIRECT代理宕机 + "; DIRECT"您自己的 IP
一个函数逐个站点做出判断。琥珀色 回退会用您自己的 IP 加载页面。
知识
本页内容
  1. PAC 文件的工作原理
  2. 你会用到的辅助函数
  3. 四个可直接使用的示例
  4. 在哪里设置 PAC 文件
  5. 登录,以及位置为何只设置一次
  6. 让流量绕过代理的常见错误
  7. 检查是否生效
  8. 结论

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 来托管该文件。位置仍由代理用户名设定,因此请为每个浏览器配置文件规划好对应的一个位置。

常见问题

什么是 PAC 文件?

PAC(proxy auto-config,代理自动配置)文件是一个只包含一个函数 FindProxyForURL(url, host) 的小型 JavaScript 文件。浏览器或操作系统会在每次请求时调用它,并根据返回结果决定该请求是通过代理还是直接连接。

PAC 文件可以包含代理的用户名和密码吗?

不可以。PAC 文件只指定代理的主机和端口。当代理要求提供凭据时,浏览器会弹出登录提示框,或者使用系统中已保存的凭据。

为什么我的 PAC 文件无法匹配 HTTPS URL 的路径?

现代浏览器在将 HTTPS URL 传递给 PAC 文件时,只会传递协议和主机部分,并去除路径和查询参数,这样可以避免将完整地址泄露给脚本。请基于主机名编写规则。

如果 PAC 文件无法加载会发生什么?

大多数浏览器会转为直接连接,不使用代理。如果绝不能出现直接连接的情况,请在每次修改后测试该文件,并留意浏览器网络工具中出现的错误。

准备好开始了吗?

试用 Shifter 住宅代理,205M+ 个 IP,195+ 个国家,低至 $0.10/GB。

立即开始