2026-09-04 · 故障排查 · 约 8 分钟

v2rayN 系统代理不生效:浏览器与终端两条线分开排查

系统代理已开启但网页打不开、命令行不走代理?按浏览器扩展冲突、系统代理设置、终端环境变量三个方向逐项定位原因。

本文速览

在 Windows 上,浏览器和终端不一定读取同一份代理设置。先用 PowerShell 确认 v2rayN 的本地监听,再让 curl 显式连接该端口。显式请求成功后,浏览器查扩展和 Windows 代理,终端查环境变量和工具自身配置。测试期间保持节点、路由和目标网址不变,避免同时改动多处设置。

先确认 v2rayN 的本地监听

系统代理负责告诉应用把请求交给谁,路由规则则决定内核收到请求后怎样处理。托盘已显示「自动配置系统代理」,只说明选择了相应模式,不能证明系统设置已写入、端口正在监听,或目标请求最终走了代理出站。排查普通系统代理时,若同时启用了 TUN,可先记录原状态并暂时关闭 TUN,避免应用未读取系统代理却仍能访问目标,干扰判断。

应用请求代理地址本地监听路由匹配出站连接

在 v2rayN 主窗口查看底部状态栏的本地监听信息;需要核对配置时,打开「设置」→「参数设置」,查看核心的基础设置。不同版本的字段名和端口分配可能有差异。以下示例仅适用于 HTTP 可用的本地监听为 127.0.0.1:10808 的情况;如果状态栏列出了不同的 HTTP 和 SOCKS 端口,命令应使用 HTTP 端口。

127.0.0.1
本机回环地址
10808
示例 HTTP 可用端口
15 秒
单次 curl 请求总时限
Test-NetConnection -ComputerName 127.0.0.1 -Port 10808
curl.exe -v --max-time 15 --noproxy "" --proxy http://127.0.0.1:10808 https://example.com/

浏览器线:核对 Windows 设置和扩展

显式请求能通、浏览器却失败时,先让浏览器使用系统设置作为基线。Edge 和 Chrome 通常沿用系统代理,但扩展、启动参数和组织策略都可能改变实际行为。不要仅凭无痕窗口的结果排除扩展:获准在无痕模式运行的扩展仍然可能接管代理。

  1. 在 v2rayN 托盘的「系统代理」菜单选择「自动配置系统代理」。随后打开 Windows「设置」→「网络和 Internet」→「代理」,查看手动代理的地址和端口是否与当前 HTTP 可用监听一致。也检查「使用设置脚本」是否存在旧配置。先记录原值;组织下发的设置交由管理员核对。
  2. 在浏览器扩展管理中暂时停用代理切换类扩展,再开一个新窗口访问同一网址。恢复正常后逐个启用扩展;启用某个扩展就复现故障时,检查它是否指定了旧端口、旧脚本或直连规则。
  3. Firefox 可在「设置」→「常规」→「网络设置」→「设置」中选择「使用系统代理设置」做对照。如果原来是「不使用代理」或「手动代理配置」,Windows 里的开关并不会替换该选项。
  4. 只有少数域名表现不同,就分别核对 Windows 的代理例外、扩展的匹配规则和 v2rayN 的路由。前两者可以让请求不进本地代理;内核路由只有在收到请求后才生效。

判断:显式代理成功而浏览器失败,先查浏览器如何选代理

先修正扩展或浏览器使用的代理地址,再用同一网址复测;此时更换节点会引入额外变量,也不会修复浏览器里残留的旧端口。

终端线:用显式参数和环境变量做对照

浏览器能打开网页,不代表终端程序会读取 Windows 系统代理。下面用 curl.exe 明确调用 curl,而不是依赖 PowerShell 对 curl 的名称解析。以 v2rayN 实际端口替换示例端口,在新开的 PowerShell 窗口中运行,避免覆盖日常会话里的变量。

Get-ChildItem Env: | Where-Object Name -Match '^(HTTP_PROXY|HTTPS_PROXY|ALL_PROXY|NO_PROXY)$'

$env:HTTPS_PROXY = 'http://127.0.0.1:10808'
curl.exe -v --max-time 15 --noproxy "" https://example.com/
curl.exe -v --max-time 15 https://example.com/

按报错定位失败的连接阶段

同一句「打不开」可能发生在解析代理地址、连接本地端口或校验目标证书时。保留 curl 详细输出和同一时段的 v2rayN 日志,先看请求到达了哪一层。分享日志前移除订阅地址、凭据和代理授权头。

curl: (5) Could not resolve proxy: proxy.invalid

原因:curl 无法解析当前选中的代理主机名。解法:检查显式代理参数、环境变量和 curl 配置中是否残留旧地址,再用实际的本地回环地址和端口重测。

curl: (60) SSL certificate problem: unable to get local issuer certificate

原因:curl 无法用当前信任库验证对端提供的证书链。解法:检查失败是在 CONNECT 之前还是之后,再核对相应的代理或目标证书链,以及当前 curl 使用的信任库;保持证书验证开启。

修正后分别验证浏览器和原终端工具,不要只看一次 curl 成功。若仍失败,记录浏览器是否使用系统设置、curl 实际连接的地址、CONNECT 是否成功,以及内核日志有没有对应请求。这样可以区分应用选错代理、本地监听异常和请求进入内核后的故障。

客户端下载