跳到正文

Chromium 代理启动参数:proxy-server

完整的参数写法、每个系统各一条启动命令,以及参数看似没用的五个原因。

用代理启动 Chromium:步骤

  1. 第 1 步:退出所有正在运行的窗口

    Chromium 文档要求先在地址栏打开 chrome://quit 关闭浏览器。如果旧进程还在,新启动可能不会带上你的参数。

    继续前请注意 没做这一步,是参数“看似被忽略”的最常见原因。

  2. 第 2 步:带参数启动

    Windows:把参数加在快捷方式「目标」的末尾。macOS:在终端里运行程序文件。Linux:在终端里启动 chromium-browser 或 google-chrome。命令见下一块。

  3. 第 3 步:确认参数生效

    打开 chrome://version,会列出当前使用的完整命令行。代理设置从哪来,可以在 chrome://net-internals/#proxy 里看。

    预期结果 命令行里能看到 --proxy-server=...。

  4. 第 4 步:检查出口 IP

    在这个窗口里打开 https://ipinfo.io/json,对比 IP 和国家与你自己的是否一致。

    预期结果 显示代理的 IP 和国家,而不是你自己的。

Windows、macOS、Linux 的启动命令

# Windows: fully quit the browser first (chrome://quit), then put this at the end of the shortcut's Target
chrome.exe --proxy-server="http://HOST:PORT"

# macOS (Terminal; escape the spaces for Google Chrome)
/Applications/Chromium.app/Contents/MacOS/Chromium --proxy-server="http://HOST:PORT"
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --proxy-server="http://HOST:PORT"

# Linux
chromium-browser --proxy-server="http://HOST:PORT"
google-chrome --proxy-server="http://HOST:PORT"

仅为示例:把 HOST、PORT 换成「我的资产」里的值。撰写时的机器上没有启动过,语法依据 Chromium 文档。

--proxy-server 的值是什么意思

--proxy-server 的值是什么意思
项目Chromium 的做法要注意
http://HOST:PORT所有请求都发给这个代理没写协议头时,HOST:PORT 被当成 HTTP 代理
http://HOST:PORT,direct://先走代理,代理连不上就直连不加兜底时,代理不可达会报 ERR_PROXY_CONNECTION_FAILED;加了兜底则可能暴露你自己的 IP
http=http://HOST:PORT;socks=socks5://H2:P2http:// 网址走一个代理,其余走另一个“socks=” 表示“其他代理”;其中没写协议头的地址会被当成 SOCKS4,而不是 HTTP
socks5://HOST:PORT流量走 SOCKS5 代理Chrome 不支持任何登录方式;域名始终由代理解析
https://HOST:PORT与代理之间用 TLS 通信支持和 HTTP 代理相同的登录方式,另外支持客户端证书

来源:Chromium 文档「Proxy support in Chrome」,2026 年 11 月 14 日阅读。

按协议分代理、兜底与跳过规则

# one proxy for everything
--proxy-server="http://HOST:PORT"

# fall back to a direct connection if the proxy is unreachable (comma = ordered list)
--proxy-server="http://HOST:PORT,direct://"

# a different proxy per scheme (WinInet map format; "socks=" means "other proxies")
--proxy-server="http=http://HOST:PORT;socks=socks5://HOST2:PORT2"

# addresses that should skip the proxy are listed as rules like these
# (semicolon- or comma-separated; the flag that takes them is named in the Chromium page under Sources)
<local>;*.example.com;192.168.0.0/16

这是参数片段,不是完整脚本:只组合你需要的。规则写法来自 Chromium 文档。

让部分地址不走代理

Chromium 文档里另有一个参数(参数名见下方来源链接)接受用分号或逗号分隔的规则。文档列出的有:主机名(foobar.com、*foobar.com)、子域名(.example.com 匹配 sub.example.com,但不匹配 example.com)、IP、IPv4 网段(如 192.168.1.1/16),以及表示不含点号主机名的 <local>。localhost 等回环地址默认就不走代理;<-loopback> 会取消这条默认规则,只用于测试环境。

在中国大陆访问国内网站时,用这样的跳过规则或 PAC 文件是对的办法:让国内网站不走海外出口,这正是本页要讲的。它不能用来访问被屏蔽的网站。

账号密码:这个参数做不到什么

Chrome 不使用写在代理设置里的用户名和密码,所以参数里写 http://LOGIN:PASSWORD@HOST:PORT 并不会登录。HTTP 代理会走普通的登录弹窗流程,Chrome 对 HTTP 代理支持 Basic、Digest、Negotiate 和 NTLM。SOCKS5 则完全不支持任何登录方式。

如果你需要在没人盯着的窗口里用带登录的代理,可以让 Chromium 连一个会补上登录信息的本地转发器,或者改用 Playwright、Puppeteer,它们自己的设置里可以填登录。

参数看似没起作用

chrome://version 里看不到 --proxy-server

检查 启动前是否关闭了所有窗口和后台进程?

处理 用 chrome://quit 退出,再从命令行或改好的快捷方式重新启动。

页面能打开,但 IP 还是你自己的

检查 有没有别的来源盖掉了它:受管策略(chrome://policy)或扩展?

处理 查看 chrome://net-internals/#proxy 和 chrome://policy;Chromium 文档把策略、命令行、扩展和系统设置列为代理设置的来源。

ERR_PROXY_CONNECTION_FAILED

检查 地址、端口、协议头是否正确,代理在浏览器之外能连通吗?

处理 先用 curl 测试,在 chrome://net-internals/#proxy 点「Clear bad proxies」,再按连接失败指南逐项排查。

弹出登录框,或代理拒绝连接

检查 是不是带登录的 SOCKS5,或者 HTTP 代理的登录没人应答?

处理 改用 HTTP 端口并输入一次登录信息,或者用本地转发器。

停止条件 如果用同一组账号密码 curl 也失败,问题出在账号信息,不在这个参数。

Chromium 该用哪种 Proxy302 产品

一个长期登录同一个账号的窗口,建议用静态 ISP IP:租期内不轮换,1 天 US$0.50,30 天 US$7.99(约每天 US$0.27)。购买时选 HTTP;proxy.proxy302.com 上 HTTP 端口是 2222,SOCKS5 端口是 3333。

没有免费试用,最小的购买是 1 个 IP 用 1 天。

常见问题

怎么用命令行给 Chromium 设代理?

先退出浏览器,再用 --proxy-server="http://HOST:PORT" 启动,并检查 chrome://version。

能把账号密码写进 --proxy-server 吗?

可以写,但 Chrome 不会使用嵌在代理设置里的账号密码。

这个参数能用于 SOCKS5 吗?

写 socks5://HOST:PORT。Chrome 对 SOCKS5 不支持任何认证,所以只适合不需要登录的 SOCKS5 代理。

怎么让本地地址不走代理?

localhost 默认不走代理。其他地址请加跳过规则,例如 "<local>;*.example.com",参数名见来源里的 Chromium 文档。

Google Chrome 和 Edge 的参数一样吗?

Chrome 和 Chromium 共用 Chromium 文档里描述的代理代码;Edge 请看 Edge 的设置指南。

参考资料

4
  1. Chromium 文档:Chrome 的代理支持(net/docs/proxy.md)

    官方文档 · 确认日期:

    2026 年 11 月 14 日读:--proxy-server 的写法(单个代理、用 direct:// 做逗号分隔的兜底、http=...;socks=... 这样的按协议映射);只写 host:port 表示 HTTP 代理;跳过列表参数(--proxy-bypass-list)用分号或逗号分隔的规则(主机名、.子域名、IP、IPv4 网段、<local>、<-loopback>);localhost 默认不走代理;代理设置里嵌入的账号密码 Chrome 不使用;SOCKS5 不支持任何认证方式;SOCKS5 的域名始终由代理解析;调试用 chrome://net-internals/#proxy 和 chrome://net-export。

  2. Chromium:用参数启动 Chromium

    官方文档 · 确认日期:

    2026 年 11 月 14 日读:先彻底退出浏览器(chrome://quit),再把参数加到 Windows 快捷方式的目标末尾,macOS 在终端里运行带参数的程序文件,Linux 用带参数的 chromium-browser 或 google-chrome 启动;chrome://version 会列出当前使用的完整命令行。

  3. Proxy302 测试说明

    本地示例 · 确认日期:

    撰写时的机器上没有浏览器程序,所以示例没有实际启动;参数写法和各系统的步骤来自上面两份 Chromium 文档。

    命令仅为示例,请在自己的系统上测试。

  4. Proxy302 产品信息与价格表

    产品观察 · 确认日期:

    网站产品信息表(2026 年 11 月 10 日核对):协议与端口、美元价格(1 PTC = US$1)、租期、数量上限、无免费试用。

准备好试试了吗?

注册账号、充值一次,就能选动态住宅、静态 ISP 或数据中心 IP,几分钟配进你的浏览器。