教程 2026年10月9日

开发者用 Clash TUN 模式让终端命令自动代理的工作流指南

终端里的 Git、SSH 或 Homebrew 经常连接超时?本指南从开发者日常工作流出发,讲解如何配置 Clash TUN 模式,让命令行流量按规则自动代理,并检查 DNS、路由和内网访问问题。

Docker代理 GitHub加速 进阶配置 YAML

为什么浏览器能用,终端里的 Git、SSH 和 Homebrew 却超时

开发者电脑上的网络并不是一个统一的开关。浏览器可能读取操作系统的系统代理设置,而 git、ssh、curl、Homebrew、语言包管理器和 IDE 子进程则可能各自使用不同的网络库。于是常见情况是:浏览器打开代码托管网站没有问题,终端执行 git clone 却一直等待;IDE 能登录,集成终端中的包管理命令却报连接超时;或者 HTTPS 请求正常,SSH 克隆仍然失败。

这类问题不一定是节点不可用。应用可能根本没有读取系统代理,也可能只代理了 HTTP 请求,DNS 解析却仍由本机网络完成;还有一种情况是命令行确实连上了代理,但规则把目标域名送往了直连策略。要定位原因,先把请求拆成几层:进程是否把流量交给代理、域名由谁解析、连接命中了哪条规则,以及最终出站是否能完成 TLS 握手。

Clash TUN 模式的作用,是通过虚拟网络接口接收一部分或大部分系统流量,再交给 Mihomo 内核按规则处理。这样一来,不必要求每个 CLI 都理解 HTTP_PROXY 等环境变量。不过,TUN 不是“任何程序必定自动代理”的保证:路由范围、权限、DNS 行为、容器网络和企业 VPN 都会影响实际结果。合理的目标是让目标流量有一致、可观测的处理路径,而不是不加区分地把整台机器所有连接塞进代理。

先选合适路径:TUN、系统代理还是终端变量

如果只有一两个遵循标准代理变量的命令需要出站,临时设置环境变量通常最容易验证,也最容易撤销。如果问题只出现在浏览器或支持系统代理的桌面应用,开启系统代理往往已经足够。反过来,当多个工具都不读取系统代理、而你又不想逐个配置时,TUN 才更适合成为统一入口。

方式适合场景主要限制
系统代理浏览器及支持系统代理的桌面程序许多 CLI、SSH 和容器不会自动读取系统设置
终端环境变量少量 HTTP、HTTPS 或 SOCKS 客户端只影响继承变量的进程,SSH 等协议还需单独处理
TUN多个不遵循代理变量的本机进程涉及虚拟网卡、路由、DNS 和权限,需要关注内网例外

实际操作建议从影响范围最小的路径开始。先确认浏览器和系统代理工作正常,再对单个终端命令设置代理变量进行对照测试;只有确认命令行工具不遵循代理设置,或者需要多个工具共享同一套规则时,再启用 TUN。这样可以避免一开始同时更改代理变量、DNS、路由与节点,最后无法判断是哪项改动解决或引入了问题。

阅读提示:Clash Verge、Clash Verge Rev 和其他 Mihomo 客户端的开关位置、字段名称可能随版本和内核而变化。请以当前客户端配置编辑器及其所用 Mihomo 内核文档为准,不要直接把某个版本的配置片段覆盖到所有客户端。

在 Clash 客户端中启用 TUN,并保留清晰的回退方式

开始之前,记下当前使用的配置、模式和端口,并确认你有权限启用虚拟网卡或网络扩展。Windows 上可能需要管理员权限;macOS 上可能会出现系统网络扩展授权;Linux 上则可能受到权限、路由管理器或 NetworkManager 设置影响。若电脑同时运行公司 VPN、容器网络、其他代理客户端或安全软件,先检查它们是否也会接管默认路由。多个工具同时修改路由时,可能出现环路、DNS 失效或局域网断连。

  1. 在客户端选择正在使用的配置与可用策略组,先确认普通代理连接正常,并将规则模式作为初始测试模式。
  2. 打开 TUN 开关;若客户端提供自动路由或自动设置 DNS 的选项,先记录原值,再按客户端说明启用必要项目。不要同时启用多个未经确认的路由接管功能。
  3. 等待系统完成网络扩展或虚拟网卡授权,观察客户端状态与内核日志,确认 TUN 已启动且没有权限、接口创建或路由冲突错误。
  4. 用一条简单的 HTTPS 请求测试命令行流量,然后分别验证 Git、包管理器和 SSH。每次只增加一种测试,方便从日志中定位进程、域名与策略组。
  5. 确认内网、局域网设备和本机服务仍可访问后,再决定是否让 TUN 随系统启动。保留关闭 TUN、恢复网络设置和切回原配置的方法。

配置文件中的 TUN 参数应以当前 Mihomo 版本和客户端界面为准。不要把网上的整段 YAML 直接粘贴到已有配置里:字段可能不受当前内核支持,覆盖合并后的配置还可能删除订阅所需的规则或 DNS 设置。若需要检查配置,重点核对 TUN 是否启用、路由是否接管预期流量、DNS 是否由预期组件处理,以及内核日志中是否出现对应连接。

启用后,先不要急着切换全局模式。TUN 负责把流量送入内核,最终去向仍由规则和策略组决定。若需要临时定位问题,可以对比规则模式下的日志和全局模式下的结果;全局仅适合作为短时诊断手段,不宜拿来掩盖一条具体规则写错或 DNS 路由不一致的问题。

规则、DNS 与局域网:让自动代理可解释而非一刀切

终端流量进入内核后,规则顺序仍然重要。规则通常从上到下匹配,先命中的规则决定连接交给哪个策略组。可以为开发工具维护一个独立策略组,并把确实需要代理的目标规则放在宽泛直连规则之前。以下仅展示结构;策略组名称、域名和规则类型要根据自己的配置与日志调整,不能假设所有开发服务共用相同域名。

rules:
  - DOMAIN,code.example.com,DEV
  - DOMAIN-SUFFIX,packages.example.net,DEV
  - DOMAIN-SUFFIX,corp.example, DIRECT
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - MATCH,FINAL

示例中的 DEV 和 FINAL 只是占位名称,应替换成配置里真实存在的策略组;域名也只是示意。注意规则项之间不要随意插入空格,最终以 Mihomo 对应规则语法为准。尤其不要将整个大型域名后缀无差别送进代理:这可能把公司内部服务、云存储或原本应直连的开发资源一起带入隧道,增加延迟并扩大故障范围。

DNS 与规则要一起观察。若启用了 fake-ip 或 DNS 分流,应用得到的地址、内核日志记录的主机名和规则匹配结果可能不完全直观。测试时优先查看客户端连接日志:确认目标域名有没有被解析、连接是否进入 TUN、命中的规则是什么、策略组选择了哪个出站。不要只根据一次 nslookup 输出就判断代理没有生效,因为本机解析与代理内核的解析路径可能不同。

内网例外应明确且尽量精确。办公室服务、局域网打印机、开发板、虚拟机和 NAS 可能使用私有地址,也可能使用公司内部域名;在规则中为已知网段或域名保留直连路径,避免连接请求被送进无法访问内网的远端节点。不要把整个私有地址范围或企业域名加入规则,除非你确认范围和影响。完成配置后,实际访问一台内网设备,并验证 DNS 名称和 IP 地址两种方式是否都符合预期。

用 Git、SSH 和 Homebrew 做分层验证

先用 HTTPS 请求判断终端是否进入代理路径。端口号应从客户端当前的混合端口或 HTTP 端口设置中读取,不要假设所有安装的默认值相同。下面的环境变量只对当前 shell 及其子进程生效;开启 TUN 后,也可以先在不设置变量的情况下对照测试。

export HTTP_PROXY="http://127.0.0.1:7890"
export HTTPS_PROXY="http://127.0.0.1:7890"
export ALL_PROXY="socks5://127.0.0.1:7890"

curl -I --max-time 15 https://目标主机名/

把示例主机名换成你实际使用的目标。若环境变量测试成功、TUN 单独测试失败,优先检查 TUN 的路由范围、DNS 与进程连接日志;若两者都失败,则检查节点、目标规则和远端服务状态。收到 HTTP 401、403 或 404,至少说明请求已经到达某个 HTTP 服务端点,问题可能转向鉴权、路径或服务权限;连接超时、解析失败和 TLS 握手错误则需要继续调查网络路径。

Git over HTTPS通常可以沿用 HTTP 代理配置,但 Git 也可能保存了独立代理设置。检查当前生效项:

git config --show-origin --get-regexp 'http\..*proxy|https\..*proxy'
git ls-remote https://目标仓库地址.git

如果 Git 配置里有旧代理地址,它可能覆盖当前 shell 环境变量。确认来源后再有针对性地修改或取消,不要直接清空所有 Git 配置。遇到证书错误时,也不要用关闭 TLS 校验的方式绕过;先确认系统时间、证书存储以及代理链路是否被企业证书或其他安全软件检查。

SSH 与 HTTPS 是两条不同的协议路径。HTTPS_PROXY 一般不会自动让普通 SSH 连接走 HTTP 代理,因此 TUN 未捕获连接时,SSH 仍可能超时。先使用详细输出观察连接卡在哪一步:

ssh -vvv -T git@目标代码托管主机

如果连接尝试已经出现在 Clash 内核日志中,按命中的规则与策略排查;如果日志完全没有该连接,检查 TUN 路由、终端所在环境和目标地址解析。也可以在支持的环境中为 SSH 单独配置经过验证的代理跳转方式,但要确保跳板地址、密钥和访问策略可信。不要把访问令牌或私钥写进共享配置文件、命令历史或公开日志。

Homebrew、npm、pip 和容器工具也可能拥有自己的代理配置或独立网络命名空间。以 Homebrew 为例,先用 brew config、实际安装日志和 Clash 连接日志交叉判断,而不是只看图形界面是否显示代理已开启。容器内运行的命令尤其要区别宿主机与容器网络:宿主机 TUN 正常,不代表容器 DNS、默认路由或代理端口映射也必然正确。

常见故障如何定位,以及怎样长期维护这套工作流

如果浏览器可用但所有 CLI 都超时,先确认 TUN 是否真的启用、操作系统是否授予权限,再观察一条 CLI 请求是否出现在内核日志里。若请求没有进入日志,检查虚拟网卡、路由范围、容器或远程开发环境;若已进入日志,则检查域名解析、命中规则、策略组和节点可用性。这样的分界比连续更换节点更能缩小问题范围。

如果只有某个域名失败,比较它与成功目标的 DNS 结果和日志记录,确认是否存在遗漏的认证域名、下载域名或 API 子域。按实际日志逐条添加最小规则,并在注释中记录服务用途与验证日期。不要因为一次请求失败就把整个顶级域名加入代理,也不要仅凭浏览器地址栏判断后台服务的真实连接目标。

如果开启 TUN 后内网失效、网络出现循环或 DNS 突然异常,先关闭 TUN,恢复到已记录的原始状态,再逐项检查公司 VPN、虚拟机、容器、DNS 劫持与路由冲突。不要在故障状态下同时更改系统 DNS、静态路由和代理配置;一次只恢复或调整一项,才能知道哪个设置造成了影响。公司设备还应遵循组织的网络与安全策略,尤其不要试图绕过终端管理或强制 VPN。

稳定的开发者代理工作流,通常不是“把所有流量交给代理”,而是让每类请求都能解释:浏览器由系统代理处理,遵循标准变量的 CLI 按需使用环境变量,无法逐个设置的本机应用交由 TUN 捕获,SSH、容器和内网则分别验证。配置发生变化后,保留一组小型回归测试:一次 HTTPS 请求、一次 Git 查询、一次 SSH 握手和一次内网访问。节点、客户端或内核更新后重复测试,就能尽早发现路由语义变化。

有些只提供系统代理开关的工具配置简单,但遇到不读取系统代理的 Git 子进程、SSH 客户端或包管理器时,仍需要逐个补环境变量;而长期全局代理虽然看似省事,却容易把内网和本地开发流量也带入远端。Clash 的规则分流、TUN 捕获和内核日志可以把这些差异拆开验证:既让需要代理的终端请求有统一入口,也为内网直连和故障回退保留空间。如果你正准备为开发环境搭建这套工作流,可以先查看客户端选项,再从一条命令开始逐步验证。

前往下载 Clash →

准备好开始了吗?

选择适合你设备的 Clash 客户端,再按本文思路验证终端代理、TUN 与内网规则。