适合已经启动 v2rayN,但浏览器和终端表现不一致的用户。先用 curl 显式连接本地代理,确认端口和协议可用,再分别检查浏览器的代理来源与终端进程的环境变量。Windows 提供监听查询示例,macOS 和 Linux 可复用 curl 对照测试。
本地监听:确认应用连到哪个端口
系统代理向愿意读取系统设置的应用提供代理地址,不会自动接管每个进程。应用可能读取系统设置,也可能使用自己的代理设置或直接连接。只有请求到达 v2rayN 后,内核才会按路由规则决定走代理出站还是直连出站。所以“应用已连上本地端口”和“请求走了代理出站”是两个不同的结论。
打开 v2rayN 的「设置」→「参数设置」,查看本地监听端口。若当前版本的界面分别显示 HTTP 和 SOCKS 端口,按协议记录;只有明确配置为混合监听时,才用同一端口测试两种协议。下文用 127.0.0.1:10808 举例。请按实际设置替换,并在运行 v2rayN 的同一系统环境里测试。
在 Windows PowerShell 中查询监听。若结果只有 ::1,说明这条监听记录对应 IPv6 回环地址,不能用它证明 127.0.0.1 可用。若返回多个进程或改过端口,用实际端口和进程 ID 核对归属,不要仅凭端口号判断是 v2rayN 的内核。
Get-NetTCPConnection -LocalPort 10808 -State Listen |
Select-Object LocalAddress, LocalPort, OwningProcess
显式代理:用 curl 建立对照
以下命令使用 curl 8.x 的常见参数。先运行 curl --version 确认调用的是 curl;Windows 可在命令提示符运行下面三行,避免部分 PowerShell 环境把 curl 解析成别名,或在传参时丢掉空字符串。macOS 和 Linux 可在常见终端中直接运行。
curl --disable -v --max-time 15 --noproxy "" --proxy http://127.0.0.1:10808 https://example.com/
curl --disable -v --max-time 15 --noproxy "" --proxy socks5h://127.0.0.1:10808 https://example.com/
curl --disable -v --max-time 15 --noproxy "*" https://example.com/
前两行分别验证 HTTP 和 SOCKS,仅运行与实际监听类型对应的命令。--disable 放在首位,用于跳过 curl 默认配置文件。--noproxy "" 清空本次请求的目标排除列表。第三行让 curl 不使用应用层代理,作为对照;若系统另有流量接管,这一行不能证明数据包最终走了直连。
HTTP 代理处理 HTTPS 目标时,先接收 CONNECT example.com:443。代理返回的 200 Connection established 只表示隧道建立,仍需查看后续 TLS 握手和目标响应。socks5h 把目标主机名交给 SOCKS 代理解析;它与由 curl 先解析目标名的 socks5 不等价。若两者结果不同,应记录差异而不是同时调整端口、路由和 DNS。
结论:先用显式代理划定故障范围
若显式命令能拿到目标响应,但同一终端的普通命令失败,先查普通命令如何选择代理。若请求还没连上本地监听,就先核对地址、端口和监听进程,不必先改浏览器设置。
浏览器:区分扩展配置和系统设置
停用代理扩展
在当前浏览器配置文件的扩展管理页,临时停用具备代理控制功能的扩展。不要只看扩展图标,因为域名匹配规则仍可能让不同站点选用不同连接方式。受组织策略管理的浏览器应先查看是否有锁定项。
核对浏览器来源
Firefox 在「设置」→「常规」→「网络设置」→「设置…」查看当前来源。要测试系统代理,就选择使用系统代理设置;要测试手动配置,就按监听类型填对应地址和端口。不要把 SOCKS 端口填进 HTTP 代理栏。
核对系统代理
Windows 打开「设置」→「网络和 Internet」→「代理」。若 v2rayN 托盘的「系统代理」选择了「自动配置系统代理」,在系统页核对实际写入的代理地址、端口和例外项。若使用设置脚本,则核对目标域名是否被脚本判为直连。
重测同一网址
回到同一个浏览器配置文件,重新加载 curl 测过的网址,并在 v2rayN 日志中核对请求时间与目标域名。若需要恢复代理扩展,每次只恢复一个,再测同一目标,避免把系统设置和扩展规则的变化混在一起。
若浏览器能打开网页,但 v2rayN 日志中找不到对应请求,先确认当前日志级别是否记录连接,再排除页面缓存和已有连接的影响。网页能打开并不能证明浏览器使用了系统代理;请求也可能直接到达目标,或通过浏览器自己的手动代理设置发送。
终端:检查进程读取了哪些变量
浏览器读取系统设置时,命令行工具仍可能只读取自己的配置或环境变量。对 curl 而言,HTTPS 目标通常检查 https_proxy,没有适用的协议专用变量时可回退到 all_proxy。no_proxy 用于排除目标。curl 的 HTTP 目标代理变量应写成小写 http_proxy;不要把这一规则直接套用到所有工具。
在报错的终端里检查变量,而不是在另一个窗口里检查。下面两段命令只列变量名,避免把可能含凭据的代理地址直接复制进工单。
# Windows PowerShell
Get-ChildItem Env: | Where-Object {
$_.Name -match '^(http_proxy|https_proxy|all_proxy|no_proxy)$'
} | Select-Object -ExpandProperty Name
# macOS 或 Linux:在常见的 POSIX 兼容 shell 中执行
env | cut -d= -f1 | grep -Ei '^(http_proxy|https_proxy|all_proxy|no_proxy)$'
- 检查旧值。在本机查看变量里的主机、端口和协议。HTTPS 目标通过 HTTP 代理建立隧道时,
https_proxy的值可以是http://127.0.0.1:10808。变量名描述目标协议,值中的协议才描述怎样连接代理。 - 检查例外。普通命令失败而带
--noproxy ""的显式命令成功时,核对目标是否命中了no_proxy。*会让 curl 对所有目标跳过代理。不要为了测试而永久清空工作环境需要的例外列表。 - 检查继承。改完变量后,从已更新环境的父进程重新启动实际发请求的工具。编辑器内置终端、后台任务和独立终端可能继承不同的值。容器或远程终端中的
127.0.0.1也不一定指向运行 v2rayN 的主机。
常见报错:按失败阶段收尾
报错:curl: (7) Failed to connect to 127.0.0.1 port 10808
原因:curl 没有建立到示例本地端口的 TCP 连接。处理:查询相同地址和端口的监听记录,再核对 v2rayN 是否已启动内核,以及命令是否在同一个系统环境执行。
报错:curl: (56) CONNECT tunnel failed, response 407
原因:应答的 HTTP 代理要求认证。处理:确认 curl 是否连到了预期代理;如果连到了旧的代理地址,修正代理配置,如果确实需要认证,则按该代理的授权方式配置。
报错:curl: (6) Could not resolve host: example.com
原因:本次请求在 curl 需要解析目标域名时失败。处理:先看详细输出,确认请求是否因例外规则走了直连,或是否使用了由 curl 解析目标名的 SOCKS 模式。
若浏览器和显式 curl 都已连上本地端口,但访问同一目标仍失败,在 v2rayN 日志中按测试时间查找目标域名。先区分本地入站、路由匹配和出站连接,再检查匹配的规则或报错。此时更换浏览器扩展通常不能解决出站失败。
复测时保留三项结果:显式代理是否收到目标响应、浏览器采用哪处代理设置、原终端是否能复现。每次只改一项。问题消失后恢复临时停用的扩展或测试时调整的设置,再用原来失败的操作验证一次。