跳到主要内容

ProxyConfig 对象

  • mode string (可选) - 代理模式。应为 directauto_detectpac_scriptfixed_serverssystem 之一。如果指定了 pacScript 选项,则默认为 pac_script 代理模式,否则默认为 fixed_servers
    • direct - 在直接模式下,所有连接都是直接创建的,不涉及任何代理。
    • auto_detect - 在自动检测模式下,代理配置由 PAC 脚本确定,该脚本可以从 http://wpad/wpad.dat 下载。
    • pac_script - 在 pac_script 模式下,代理配置由 PAC 脚本确定,该脚本从 pacScript 中指定的 URL 获取。如果指定了 pacScript,则这是默认模式。
    • fixed_servers - 在 fixed_servers 模式下,代理配置在 proxyRules 中指定。如果指定了 proxyRules,则这是默认模式。
    • system - 在系统模式下,代理配置取自操作系统。请注意,系统模式与不设置代理配置不同。在后一种情况下,只有当没有命令行选项影响代理配置时,Electron 才会回退到系统设置。
  • pacScript string (可选) - 与 PAC 文件关联的 URL。
  • proxyRules string (可选) - 指示使用哪个代理的规则。
  • proxyBypassRules string (可选) - 指示哪些 URL 应绕过代理设置的规则。

当未指定 mode,且同时提供了 pacScriptproxyRules 时,将忽略 proxyRules 选项并应用 pacScript 配置。

proxyRules 必须遵循以下规则

proxyRules = schemeProxies[";"<schemeProxies>]
schemeProxies = [<urlScheme>"="]<proxyURIList>
urlScheme = "http" | "https" | "ftp" | "socks"
proxyURIList = <proxyURL>[","<proxyURIList>]
proxyURL = [<proxyScheme>"://"]<proxyHost>[":"<proxyPort>]

例如

  • http=foopy:80;ftp=foopy2 - 对 http:// URL 使用 HTTP 代理 foopy:80,对 ftp:// URL 使用 HTTP 代理 foopy2:80
  • foopy:80 - 对所有 URL 使用 HTTP 代理 foopy:80
  • foopy:80,bar,direct:// - 对所有 URL 使用 HTTP 代理 foopy:80,如果 foopy:80 不可用,则故障转移到 bar,之后不使用任何代理。
  • socks4://foopy - 对所有 URL 使用 SOCKS v4 代理 foopy:1080
  • http=foopy,socks5://bar.com - 对 http URL 使用 HTTP 代理 foopy,如果 foopy 不可用,则故障转移到 SOCKS5 代理 bar.com
  • http=foopy,direct:// - 对 http URL 使用 HTTP 代理 foopy,如果 foopy 不可用,则不使用任何代理。
  • http=foopy;socks=foopy2 - 对 http URL 使用 HTTP 代理 foopy,对所有其他 URL 使用 socks4://foopy2

proxyBypassRules 是以下规则的逗号分隔列表

  • [ URL_SCHEME "://" ] HOSTNAME_PATTERN [ ":" <port> ]

    匹配所有与模式 HOSTNAME_PATTERN 匹配的主机名。

    示例: "foobar.com", "*foobar.com", "*.foobar.com", "*foobar.com:99", "https://x.\*.y.com:99"

  • "." HOSTNAME_SUFFIX_PATTERN [ ":" PORT ]

    匹配特定的域后缀。

    示例: ".google.com", ".com", "http://.google.com"

  • [ SCHEME "://" ] IP_LITERAL [ ":" PORT ]

    匹配作为 IP 地址文字的 URL。

    示例: "127.0.1", "[0:0::1]", "[::1]", "http://[::1]:99"

  • IP_LITERAL "/" PREFIX_LENGTH_IN_BITS

    匹配任何位于给定范围内的 IP 文字的 URL。IP 范围使用 CIDR 表示法指定。

    示例: "192.168.1.1/16", "fefe:13::abc/33".

  • <local>

    匹配本地地址。 <local> 的含义是主机是否匹配以下项之一:"127.0.0.1"、"::1"、"localhost"。