2026-10-21 · 故障排查 · 约 8 分钟

V2Ray 系统代理不生效:浏览器与终端命令行分开排查的方法

浏览器能翻墙但终端不行,或者正好反过来?本文把两条路径拆开讲:浏览器扩展冲突和 PAC 设置,终端则检查 http_proxy 环境变量与本地端口,逐项定位系统代理失效的原因。

本文速览

桌面端出现浏览器和命令行结果不一致时,先用 curl 显式连接 v2rayN 的本地代理,再分别检查浏览器的代理来源和终端进程的环境变量。这样可以区分应用没有使用代理、本地端口无法连接,以及请求进入内核后出站失败三类问题。

先确认本地代理入口

系统代理不是全局流量接管。它提供一套代理配置,只有读取并采用这套配置的应用才会按它发送请求。浏览器可能读取操作系统设置,也可能使用自己的代理配置;命令行工具则可能只读取参数、环境变量或自己的配置文件。v2rayN 的系统代理状态与内核的监听状态也要分开看:系统里填了代理地址,不代表该端口上有服务。

应用请求代理选择本地监听路由匹配连接目标

在 v2rayN 的「设置」→「参数设置」中核对本地监听相关字段,并查看内核启动日志。以下是两种示例配置,不是对当前版本默认值的判断。使用混合监听时,HTTP 和 SOCKS 请求可能共用一个端口;使用分开的监听时,要按实际协议填写,不能只看端口数字相近就替换。

10809
示例 HTTP 监听端口
10808
示例 SOCKS 监听端口

下面用 HTTP 监听做一次基线请求。先把示例端口换成实际端口;如果在 Windows PowerShell 中执行,使用 curl.exe,避免把命令交给同名别名。用同一个目标地址做后续测试,并记下请求时间,方便和客户端日志对应。

curl -v --max-time 15 --noproxy "" --proxy http://127.0.0.1:10809 https://example.com/

--noproxy "" 用于排除已有绕过列表对这次测试的影响。详细输出中的 Connected to 127.0.0.1 只表示连上本地端口;之后还要看 CONNECT 是否成功,以及目标是否返回响应。即使目标返回响应,也不能仅凭这一点判断请求由远端节点转发:内核仍可能按路由规则选择直连。

浏览器不生效:检查扩展和 PAC

如果显式代理请求成功而浏览器失败,先找出浏览器实际采用的代理来源。扩展、浏览器自身设置与操作系统设置可能同时存在。一次只改一项,否则恢复访问后也很难判断究竟是哪条配置在起作用。

  1. 确认代理来源

    Windows 先看「设置」→「网络和 Internet」→「代理」,分开记录设置脚本与手动代理。Firefox 可在「设置」→「常规」→「网络设置」→「设置」中确认当前选择的是系统代理、手动配置还是自动配置地址。

  2. 隔离代理扩展

    在有权限的浏览器配置中,暂时停用管理代理或切换规则的扩展,再重新打开同一目标。不要把隐私窗口当成隔离证明,因为部分扩展可以获准在其中运行。受组织策略管理的设置应交由管理员检查。

  3. 核对 PAC 规则

    如果使用自动配置脚本,检查脚本地址能否加载,再核对目标域名命中的是代理条目还是 DIRECT。后者表示该规则要求浏览器直连;如果返回代理条目,则确认其中的地址和端口仍与本地监听一致。

  4. 复测同一目标

    关闭旧标签页后重新发起请求,结合客户端可用的访问日志核对时间和目标。只在一个域名上失败时,先查该域名的绕过名单或 PAC 匹配条件,不要把局部匹配问题当成系统代理整体失效。

PAC 和客户端路由分流发生在不同位置。PAC 返回直连时,请求通常不会进入本地代理;客户端路由选择直连时,请求已经进了内核,只是出站没有走节点。要判断是哪一层做出的选择,不能只比较页面能否打开,还应核对浏览器的代理来源以及客户端日志记录的出站结果。

终端不生效:检查环境变量和协议

浏览器正常、curl 不正常时,先比较同一终端里的显式代理请求和普通请求。如果只有显式代理可用,本地监听通常不必调整,先看当前进程是否收到代理设置。桌面代理开关不会自动为每个 shell 设置环境变量;从编辑器、终端或服务启动的进程,也可能继承不同的环境。

配置curl 中的作用排查重点
http_proxy为 HTTP 目标指定代理在区分大小写的环境中使用小写,curl 不接受大写 HTTP_PROXY
https_proxy为 HTTPS 目标指定代理变量名指目标协议,变量值的前缀指连接代理所用的协议
all_proxy未配置对应协议时提供回退代理检查是否仍指向已停用的旧端口
no_proxy列出绕过代理的目标确认测试域名或通配项是否让请求改走直连

例如,本地入口是普通 HTTP 代理时,即使目标是 HTTPS,https_proxy 的值也可以是 http://127.0.0.1:10809。curl 会向 HTTP 代理发送 CONNECT,再通过隧道与目标建立 TLS 连接。不能因为目标地址以 HTTPS 开头,就把本地代理地址也改成 HTTPS。

# macOS、Linux:变量只应用于这一次 curl 调用
https_proxy=http://127.0.0.1:10809 curl -v --noproxy "" https://example.com/

# Windows PowerShell:先列出当前会话中的代理变量
Get-ChildItem Env: | Where-Object Name -Match '^(http|https|all|no)_proxy$'

结论:先修生效范围,再写持久配置

单次变量测试成功后,再把经过验证的设置加到实际启动该工具的环境中。只在交互式终端有效的设置,不应被当成后台任务或编辑器集成终端的配置。

若使用 SOCKS 入口,可单独用 --proxy socks5h://127.0.0.1:10808 替换基线命令里的代理参数。对 curl 而言,socks5h 把目标主机名交给代理处理,socks5 则由 curl 在本地解析。两者结果不同,说明应检查解析位置及代理端的解析配置,不足以单凭此结果断定某个 DNS 服务故障。

按报错判断失败阶段

判断时优先看第一条失败信息和它之前的连接目标。相同的超时提示可能发生在连接本地端口、等待代理建立隧道或等待目标响应时。把详细输出与同一时间的内核日志放在一起看,比反复切换节点更能缩小范围。

Connection refused

原因与解法:如果拒绝发生在连接 127.0.0.1 时,先核对该端口是否由内核监听。检查启动日志和监听地址,尤其注意命令若在虚拟机或容器中运行,其回环地址通常不是桌面宿主机的回环地址。

Could not resolve proxy

原因与解法:curl 无法解析代理地址里的主机名,而不是无法解析目标网站。检查代理变量是否保留了旧主机名;如果内核在同一网络环境的 IPv4 回环地址监听,可用实际端口配合 127.0.0.1 复测。

CONNECT tunnel failed, response 502

原因与解法:HTTP 代理响应了 CONNECT,但返回了 502,隧道没有建立。先核对监听进程是预期的内核,再查同一请求对应的出站、目标解析和连接日志;状态码本身不能确定是哪一步失败。

复测与配置恢复

如果两边都无法经显式配置完成请求,回到连接故障排查核对内核与出站;如果请求已经进入内核,但直连与代理路径不符合预期,再查看路由分流说明。提交排查记录时保留端口类型、报错阶段和必要的日志片段,移除订阅地址、认证信息以及日志中不必公开的请求内容。

客户端下载安装