问题诊断排错 · 约 10 分钟
浏览器能上、软件不走代理怎么办:终端、游戏、桌面软件逐个处理
浏览器能上、软件不走代理怎么办:浏览器能上而软件不行,说明节点和订阅都没问题,问题在于这个软件没有把流量交给代理。系统代理只是登记在系统里的一个地址,软件可以不理。解决办法按省事程度排:开 TUN 模式一次解决全部;不想开 TUN,就给终端设环境变量,给 git、npm、pip 单独配代理。
浏览器能上、软件不走代理怎么办,先搞清楚:系统代理只是一个“建议”
客户端打开“系统代理”时,做的事情很简单:在系统设置里登记一个地址,比如 127.0.0.1 加某个端口,意思是“有需要的软件,请把流量交给这里”。
浏览器会遵守这个建议,所以浏览器能上。
但这只是建议,不是强制。软件可以有三种反应:
- 遵守系统代理:浏览器、大部分常见桌面软件。它们开着代理就能用。
- 有自己的代理设置:比如部分聊天软件、下载工具、开发工具,在软件设置里有单独的代理选项,不看系统的。
- 完全不理:终端里的命令行程序、很多游戏、后台服务。系统代理对它们无效。
所以“浏览器能上、软件不行”恰恰说明机场本身是好的。不要去换节点、更新订阅,那些都不是问题所在。
下面按“由省事到精细”的顺序给出解决办法。原理的完整说明见 TUN 模式与系统代理。
排查顺序一览
| 软件类型 | 优先试 | 其次 |
|---|---|---|
| 有自带代理设置的桌面软件 | 在软件设置里选“使用系统代理”或手动填本地地址 | 开 TUN |
| 终端里的命令行程序 | 开 TUN | 设置代理环境变量 |
| git、npm、pip 等开发工具 | 开 TUN | 给工具单独配置代理 |
| Windows 商店应用 | 开 TUN | 添加回环豁免 |
| 游戏 | 开 TUN,并选支持 UDP 的节点 | 用游戏自带的代理设置(少数游戏有) |
| 后台服务(如 Docker) | 开 TUN | 按官方文档给服务单独配置 |
办法一:开 TUN 模式,一次解决大部分
TUN 模式会在系统里创建一块虚拟网卡,从网络层接管流量。
软件不需要知道代理的存在,流量自然会经过客户端,再按规则分流。对于“软件不走代理”这类问题,它是最省事的办法。
- 安装服务TUN 需要管理员权限。Clash Verge Rev 要先在设置里安装服务模式,v2rayN 要以管理员身份运行。不同客户端和版本的入口位置略有不同。
- 打开 TUN 开关服务装好后打开开关。系统代理可以保留,也可以关掉。
- 重启那个软件已经打开的软件可能还在用旧的连接,重启一次再试。
- 验证在终端里用 curl 访问一个国外网站,能返回内容就说明 TUN 生效了。
手机上的客户端本身就是以 VPN 方式运行的,相当于一直开着 TUN,所以手机上很少遇到这个问题。各平台的具体操作见 Windows 怎么用机场 和 Mac 怎么用机场。
开了 TUN 反而上不了网,常见原因是和其他 VPN、加速器冲突,或者 DNS 设置有问题。先退出其他网络类软件再试,DNS 相关见 DNS 设置与 DNS 泄漏。
办法二:给终端设置代理环境变量
不想开 TUN,或者公司电脑不方便装服务,可以给终端设置环境变量。大多数命令行程序启动时会读取这几个变量,看到了就把请求交给代理。
先在客户端的设置里找到本地代理端口。Clash Verge Rev 默认的混合端口是 7897,其他客户端以设置页显示的为准。下面的例子都用 7897,换成你自己的数值。
macOS 和 Linux
export http_proxy=http://127.0.0.1:7897 https_proxy=http://127.0.0.1:7897 all_proxy=socks5://127.0.0.1:7897
Windows PowerShell
$env:HTTP_PROXY="http://127.0.0.1:7897"; $env:HTTPS_PROXY="http://127.0.0.1:7897"
Windows 命令提示符
set HTTP_PROXY=http://127.0.0.1:7897,再用同样的格式设置 HTTPS_PROXY。
这些设置只对当前窗口有效,关掉窗口就失效。验证方法同样是用 curl 访问国外网站。
有一点要注意:不是所有程序都认这些变量,个别程序只认小写或只认大写的变量名,不行的话两种都设上。
办法三:给开发工具单独配置代理
git、npm、pip 都支持自己的代理设置,好处是只影响这一个工具,不用每次开终端都设变量。
| 工具 | 设置 | 取消 |
|---|---|---|
| git | git config --global http.proxy http://127.0.0.1:7897,https.proxy 同理 | git config --global --unset http.proxy |
| npm | npm config set proxy http://127.0.0.1:7897,https-proxy 同理 | npm config delete proxy |
| pip | 安装时加 --proxy http://127.0.0.1:7897 参数 | 不加参数即可 |
几个容易踩的坑:
- git 的 SSH 地址不受影响。http.proxy 只管 https 开头的仓库地址,git@ 开头的 SSH 地址不读它。改用 https 地址,或者开 TUN。
- 关掉客户端后记得取消。全局写进配置的代理,客户端一关,这个工具就完全连不上了,连国内的镜像源也一样。很多“git 突然不能用了”就是这么来的。
- 国内镜像源不需要代理。如果你已经把 npm 或 pip 切到了国内镜像,就不要再给它们配代理,否则反而绕远。
用 Claude Code、Codex 这类终端 AI 工具的,设置方法类似,还要额外注意出口地区,见 Claude Code 终端代理 和 Codex CLI 终端代理。
Windows 商店应用:回环限制
从微软商店安装的一部分应用运行在隔离的沙盒里,Windows 默认不允许它们访问本机的回环地址 127.0.0.1。
而系统代理正是把流量交给 127.0.0.1 上的端口,所以这类应用即使遵守系统代理,也连不上客户端,表现为“显示无网络”。
解决方法有两种:开 TUN,它不依赖回环地址;或者给这些应用添加回环豁免。
Windows 自带的 CheckNetIsolation 工具可以做豁免,部分客户端也集成了图形化的 UWP 回环工具,勾选需要的应用保存即可。
详细说明见 Windows 怎么用机场 的相关小节。
游戏:UDP 和服务器位置
游戏是最特殊的一类。大多数游戏完全不读系统代理,要走代理只能开 TUN。开了 TUN 之后还要注意两件事:
- 游戏的实时数据很多走 UDP。节点和协议要支持 UDP 转发,否则能登录、进不了对局,或者语音不通。不确定的话问机场客服哪些节点支持。
- 服务器在哪就选哪里的节点。国服游戏应该直连,走代理只会更卡;海外服选离游戏服务器最近的地区。延迟高低主要取决于节点到游戏服务器的距离,不是节点本身。
部分游戏的反作弊系统对虚拟网卡和代理软件比较敏感,这类情况请以游戏官方的说明为准,不要为了绕过检测去改系统设置。
软件自带的代理设置怎么填
有代理选项的软件,设置界面大同小异,一般要填下面几项。名称可能写成“网络代理”“连接设置”等,位置以软件为准。
| 项目 | 填什么 | 说明 |
|---|---|---|
| 代理类型 | HTTP 或 SOCKS5 | Clash 系的混合端口两种都接受;单独开的端口,类型要和端口对应 |
| 地址 | 127.0.0.1 | 指的是本机,不要填节点的服务器地址 |
| 端口 | 客户端设置页显示的本地端口 | 不是节点的端口,也不是订阅里的任何数字 |
| 用户名和密码 | 留空 | 本地端口默认不需要认证,除非你自己设置过 |
最常见的错误是把节点信息抄进去。软件应该连的是本机的客户端,由客户端再去连节点。
如果选项里有“使用系统代理”,直接选它最省事。以后客户端改了端口,这个软件也不用跟着改。
让终端代理设置一直生效
前面的 export 和 set 只在当前窗口有效。不想每次都重新输入,可以写进配置文件或系统设置。
macOS 和 Linux
macOS 默认的 shell 是 zsh,把 export 那一行追加到用户目录下的 .zshrc;用 bash 的写进 .bashrc。保存后新开的窗口生效,当前窗口可以执行 source ~/.zshrc 重新读取。
Windows
在“系统属性”的“环境变量”里,新建用户变量 HTTP_PROXY 和 HTTPS_PROXY,值填本地地址加端口。只有之后新开的终端窗口才会读到。
用 NO_PROXY 排除本机和内网
设了代理变量之后,访问本机服务或公司内网的请求也可能被送去代理,结果连不上。可以再设一个 NO_PROXY,值写 localhost,127.0.0.1 和内网域名,用逗号隔开。
不同程序对这个变量的支持程度不完全一样,有的只认小写的 no_proxy,不生效时两种都设。
怎么确认变量已经生效
macOS 和 Linux 用 env | grep -i proxy,PowerShell 用 Get-ChildItem Env:*proxy*,能看到刚才设的值就说明当前窗口读到了。
看到了值但程序仍然不走代理,说明这个程序不认环境变量,换用它自己的代理设置,或者直接开 TUN。
什么都看不到,就是变量没写对位置,或者需要新开一个窗口。
写进配置文件也有代价:客户端一关,终端里所有联网命令都会失败。可以把开启和取消写成两个简短的别名或函数,比如 proxy_on 和 proxy_off,需要时再开。
常见报错是什么意思
终端和开发工具的报错往往直接说明了流量去了哪里。看到下面这些字样,可以直接对号:
| 报错里出现的文字 | 意思 | 怎么处理 |
|---|---|---|
| Connection refused,地址是 127.0.0.1 加你的端口 | 程序在找代理,但这个端口上没有程序在监听 | 确认客户端在运行,核对端口号有没有变 |
| Failed to connect、Connection timed out,后面跟着国外域名 | 请求没有交给代理,直接出去了 | 检查变量是否在当前窗口生效,或开 TUN |
| Could not resolve host | 域名解析失败 | 开着 TUN 时检查 DNS 设置;没开时先确认网络本身正常 |
| npm 报 ETIMEDOUT 或 ECONNRESET | 连接超时或被中断 | 检查 npm 的代理配置和镜像源是否互相冲突 |
| pip 报 ProxyError | pip 连不上你指定的代理 | 核对 --proxy 里的端口,确认客户端在运行 |
一个简单的判断:报错里出现了 127.0.0.1,说明代理设置被读到了,问题在本机客户端;报错里只有国外域名,说明程序根本没走代理。
编辑器、IDE 和个别浏览器的例外
不少人遇到的“软件不走代理”,其实出在这几类常用工具上。它们都有自己的代理设置,优先级往往高于系统代理。
- VS Code。设置里有 http.proxy 一项,可以填本地地址加端口。留空时它通常会跟随系统代理。部分扩展自己发起网络请求,不一定遵守这个设置,遇到这种情况开 TUN 最省事。
- JetBrains 系列 IDE。在设置里搜索 proxy,能找到 HTTP 代理页面。可以选自动检测,也可以手动填写,页面上通常有“检查连接”按钮,能直接验证。
- Firefox。它有独立的网络设置,默认是“使用系统代理设置”。如果被改成了“不使用代理”或手动填了旧端口,就会出现“别的浏览器能上、只有 Firefox 不行”。
- 各种插件市场和更新程序。编辑器能打开,但扩展装不上、更新检查失败,往往是下载这一步由单独的进程完成,没读到代理设置。
判断方法和前面一样:打开客户端的连接页面,在编辑器里触发一次联网操作,看有没有对应的连接出现。
没有出现就是没接入,有出现但失败就是规则或节点的问题。
手机上某个 App 不走代理:检查分应用代理
手机客户端以 VPN 方式运行,正常情况下所有 App 都会被接管。
但安卓客户端普遍有“分应用代理”或“访问控制”功能,可以指定哪些 App 走、哪些不走。常见的坑有这几个:
- 名单模式选反了。设成“只有名单里的 App 走代理”,之后新装的 App 不在名单里,自然不走代理。
- 以前排除过,后来忘了。为了省流量把某个 App 设成了绕过,过一段时间自己都不记得。
- 客户端被系统省电策略关掉了。状态栏的钥匙或 VPN 图标消失,所有 App 都不走代理。在系统设置里允许客户端后台运行,并把它从电池优化里排除,各品牌手机的入口名称不同。
- 别的 VPN 类 App 抢了位置。手机同一时间只能有一个 VPN 生效,加速器、广告拦截类 App 都可能把客户端顶掉。
Clash Meta for Android 和 v2rayNG 都有类似功能,名称随版本不同,在设置里找带“应用”“访问控制”字样的选项。具体见 安卓怎么用机场。
iPhone 上的客户端一般不按 App 区分。某个 App 不行时,多半是规则把它用到的域名分到了直连,切全局试一次就能判断,见 iPhone 怎么用机场。
虚拟机、WSL 和局域网里的其他设备
客户端默认只在本机监听。其他设备和虚拟环境里的“127.0.0.1”指的是它们自己,连不到你电脑上的客户端。
- 局域网里的其他设备。在客户端里打开“允许局域网连接”之类的开关,其他设备填电脑的局域网 IP 加端口。同时确认电脑防火墙放行了这个端口。这个开关只在可信的家庭网络里开。
- WSL2。默认是一个独立的虚拟网络。可以把代理地址换成 Windows 主机在这个网络里的地址,并允许局域网连接;较新的 WSL 版本还提供镜像网络模式。不同版本行为有差别,以微软的文档为准。
- 虚拟机。NAT 模式下,虚拟机的流量经过宿主机,宿主机开 TUN 通常能覆盖;桥接模式下,虚拟机相当于局域网里的另一台设备,按上一条设置。
- Docker 容器。容器里的 127.0.0.1 也是容器自己,容器内的程序要填宿主机的地址,或者在宿主机上开 TUN。
不确定该怎么配时,先在宿主机上开 TUN,再到虚拟环境里用 curl 访问一个国外网站。能通就不用另外配置,不通再按上面逐项设置。
用完记得恢复,避免“关了客户端就断网”
排查时到处设了代理,过几个月就忘了。等客户端一关或者换了端口,这些地方会一起失效,而且很难想到原因。下面这份清单值得保存:
- 终端配置文件.zshrc、.bashrc 里写进去的 export 行。
- git 的全局代理用
git config --global --get http.proxy查看,不需要就取消。 - npm 的代理用
npm config get proxy查看,https-proxy 同理。 - 系统环境变量Windows 用户变量里的 HTTP_PROXY、HTTPS_PROXY。
- 软件里手填的代理以及浏览器里的代理切换插件。
换了客户端、改了端口之后,把这份清单过一遍。开 TUN 的另一个好处,就是不用在这么多地方各配一次。
还是不行:怎么进一步定位
- 看客户端的连接列表Clash 系客户端有“连接”页面,打开那个软件后看看有没有它的连接出现。没有出现,说明流量根本没进客户端,是接入方式的问题;出现了但失败,是规则或节点的问题。
- 切到全局模式试一次全局能用、规则不能用,说明这个软件用到的某些域名被分到了直连。可以在扩展配置或覆写里给它加一条走代理的规则,原理见 规则模式与分流。
- 检查软件自己的代理设置有的软件在设置里写死了“不使用代理”,或者填了一个早就不用的旧端口。
- 排除其他代理软件同时开着两个代理客户端或公司 VPN,会互相覆盖。只留一个再试。
如果连浏览器也时好时坏,那就不是本文的问题了,先按 机场连不上 的顺序排查。
节点本身经常不稳、需要换一家的话,从 机场推荐总表 里挑支持通用客户端的,这样 TUN 和规则都能自己掌控;做开发、用 AI 工具多的,参考 AI 机场推荐。
参考来源
本文涉及的客户端功能、协议和服务规则,以下面的官方文档和项目页面为准:
- everything curl:Proxy environment variables:终端代理环境变量与 NO_PROXY
- Git 文档:git-config(http.proxy):git 单独配置代理
- npm 文档:config(proxy):npm 的 proxy 配置项
- Microsoft Learn:启用回环并排查网络隔离(CheckNetIsolation):商店应用的回环限制与解除
常见问题
为什么 ping 国外网站不通,但网页能打开?
ping 用的是 ICMP 协议,不是 TCP 或 UDP,系统代理和代理环境变量都管不到它,大多数客户端在 TUN 模式下也不会把它转发到节点。
所以 ping 不通不能说明代理坏了。验证代理请用 curl 访问一个国外网站,看能不能拿到返回内容。
开了 TUN 之后还需要设置终端环境变量吗?
一般不需要。TUN 在网络层接管流量,终端程序不用做任何配置就会经过代理。同时设了环境变量也不冲突,只是多一层。
反过来,如果你同时设置了环境变量却关掉了客户端,终端里的程序会连不上,记得取消。
git clone 用 SSH 地址时设置了 http.proxy 也没用?
对。git 的 http.proxy 只管 https 开头的仓库地址,git@ 开头的 SSH 地址走的是 SSH 协议,不读这个设置。
要么改用 https 地址克隆,要么开 TUN 模式,要么在 SSH 的配置里为对应主机单独设置代理。最省事的是开 TUN。
游戏开了 TUN 还是连不上或延迟很高?
先确认游戏服务器的位置:国服游戏走代理反而会变卡,规则模式下应该直连。
海外服的游戏要选离服务器近的节点,并确认节点支持 UDP,很多游戏的实时数据走 UDP。
部分游戏的反作弊对虚拟网卡敏感,这类情况以游戏官方说明为准。
Docker 拉镜像不走代理怎么办?
Docker 拉镜像是由后台服务完成的,它不读你终端里的环境变量,也不读系统代理。
开 TUN 是最简单的办法;不想开的话,需要按 Docker 官方文档为它的服务单独配置代理,改完要重启服务才生效。
Claude Code、Codex 这类命令行 AI 工具怎么走代理?
它们和其他终端程序一样,读代理环境变量,开 TUN 也能直接生效。除了网络,还要注意出口地区是否在服务的支持范围内。
具体设置分别见 Claude Code 终端代理 和 Codex CLI 终端代理。
终端的代理设置怎么永久生效?
macOS 和 Linux 把 export 那一行写进用户目录下的 .zshrc 或 .bashrc;Windows 在系统属性的环境变量里新建 HTTP_PROXY 和 HTTPS_PROXY 用户变量。之后新开的终端窗口都会读取。
代价是客户端关闭后终端里的联网命令会失败,记得需要时再取消。
WSL 里的程序怎么走代理?
WSL2 默认是独立的虚拟网络,里面的 127.0.0.1 不是 Windows 本机,所以照抄本机地址连不上。
可以把代理地址换成 Windows 主机在虚拟网络里的地址并在客户端里允许局域网连接,或者使用较新版本 WSL 的镜像网络模式。
具体以微软文档为准。