Clash Verge 设置 Bypass:域名、IP 直连与不生效排查
简答:先在 Clash Verge Rev 的“设置→系统代理→Bypass”中填写需要直连的地址:Windows 用英文分号分隔,macOS 用英文逗号分隔。若启用了 TUN 或想精确指定节点,应改用 TUN 排除或规则分流。
定义:Clash Verge 的 Bypass 是系统代理绕过列表,用于让指定域名、IP 或局域网地址不经过操作系统代理;它不等同于 Mihomo 的规则分流,也不等同于 TUN 流量排除。
先试这一步:确认你要改的是哪一层
与 Clash Verge Rev 项目及开发者无隶属关系。Clash Verge Rev 官方文档将代理绕过分为系统代理绕过、TUN 流量排除和自定义路由规则三类,先选对层级比直接填写 Bypass 更重要。参考 Clash Verge Rev Docs:Bypass。
| 你的目标 | 应使用的设置 | 典型写法或位置 | 判断标准 |
|---|---|---|---|
| 浏览器或普通桌面应用访问某地址时直连 | 系统代理 Bypass | 设置→系统代理→代理绕过 | 关闭或重新应用系统代理后,该地址不再进入系统代理 |
| 让不读取系统代理的应用绕过 TUN | TUN 流量排除 | TUN 配置中的排除地址或接口 | 应用仍由 TUN 接管时,指定目标不经过 TUN 路由 |
| 让某域名直连或强制走指定节点 | Mihomo 规则分流 | DOMAIN-SUFFIX、IP-CIDR 等规则 | 在规则模式下查看匹配到的策略组或出口 |
| 命令行工具、游戏、部分 UDP 应用不走系统代理 | 通常考虑 TUN 或应用自身代理 | 不要只修改 Bypass | 应用是否实际建立了 TUN 或代理连接 |
如果只是想让局域网打印机、路由器后台或公司内网地址直连,优先使用系统代理 Bypass;如果目标应用根本不读取系统代理,单独修改 Bypass 可能不会生效。
Clash Verge 设置 Bypass 的界面操作步骤
- 打开 Clash Verge Rev,确认已经导入并选中了要使用的配置文件。
- 进入“设置”,找到“系统代理”区域,打开“代理绕过”或“Bypass”输入框。官方文档说明,默认模式下该列表用于决定哪些请求不使用系统代理,参考 Bypass:系统代理绕过。
- 保留“使用默认绕过”或同类选项,除非你明确知道要完全替换默认列表。默认列表通常包含本机回环地址和局域网地址,但具体内容可能随版本变化。
- 按操作系统填写自定义地址:Windows 多个条目使用英文分号;macOS 多个条目使用英文逗号。不要使用中文分号、中文逗号或换行替代分隔符。
- 保存后,关闭再打开“系统代理”,或先关闭系统代理再重新打开,让操作系统重新接收绕过列表。
- 用目标浏览器或应用重新访问地址,并结合 Clash 的连接记录或系统代理状态验证。
界面名称可能因客户端版本、语言和系统不同而略有差异。如果找不到输入框,不要把 Bypass 内容直接粘贴到订阅配置;可以先确认当前使用的是系统代理模式,而不是仅启用了 TUN 或 PAC。
Windows 与 macOS 的 Bypass 填写示例
下面的域名和 IP 仅为格式示例,使用时请替换为你自己的地址。示例中的 internal.example.com 是示例域名,不代表真实服务。
| 用途 | Windows 示例 | macOS 示例 | 说明 |
|---|---|---|---|
| 指定主机名直连 | printer.internal.example.com | printer.internal.example.com | 适合单个内网主机 |
| 匹配子域名 | *.internal.example.com | *.internal.example.com | 具体通配符行为以系统代理实现为准,填写后必须实测 |
| 指定 IP 直连 | 192.168.1.100 | 192.168.1.100 | 适合固定地址的路由器、打印机或局域网服务 |
| 多个地址 | localhost;127.*;192.168.1.100 | localhost,127.0.0.1,192.168.1.100 | Windows 使用英文分号,macOS 使用英文逗号 |
| 局域网网段 | 192.168.*;10.* | 192.168.0.0/16,10.0.0.0/8 | 不同系统接受的网段表达方式可能不同,若不生效,改用具体 IP 验证 |
Clash Verge Rev 的源代码中,系统会根据 Windows 或 macOS 选择不同分隔符,并将 system_proxy_bypass 保存为字符串字段,而不是数组;可查看 Clash Verge Rev 系统代理设置实现 和 Clash Verge Rev verge 配置结构。
若你只是排查一个地址,建议先填写单个完整域名或单个 IP。确认生效后,再逐步增加通配符或网段,这样更容易定位是哪一项格式没有被系统接受。
想让指定网站强制走代理,不要把它加入 Bypass
Bypass 的作用是“不经过系统代理”。因此,如果你的真正目标是让某个域名强制走代理,把它加入 Bypass 会产生相反结果。此时应在 Mihomo 规则中设置对应的域名规则,并为它指定代理策略。
例如,规则配置可以使用以下结构,示例中的域名和策略组名称请替换为你的实际配置:
rules:
- DOMAIN-SUFFIX,example.com,Proxy
- DOMAIN-SUFFIX,internal.example.com,DIRECT官方 Bypass 文档给出的规则示例使用 IP-CIDR 处理网段、使用 DOMAIN-SUFFIX 匹配域名后缀;规则通常按从上到下的顺序匹配,因此更具体的规则应放在更宽泛的规则前面。参考 Clash Verge Rev Docs:自定义路由规则。
这类规则属于 Mihomo 配置层,不应写进系统代理 Bypass 输入框,也不应把应用级字段和订阅配置混在一起。修改规则后,应在配置文件对应的规则编辑入口保存,再重新载入配置。
TUN 模式下为什么 Bypass 可能不生效
系统代理 Bypass 只影响操作系统代理层。如果应用不读取系统代理,或者 Clash Verge Rev 已经通过 TUN 虚拟网卡接管流量,那么该应用的流量可能仍会进入 TUN。官方文档将 TUN 流量排除单独列为一种绕过方式,参考 Bypass:TUN 流量排除。
在 TUN 场景下,先确认你的目标是排除“地址”、排除“网段”,还是排除“网卡或接口”。Mihomo 的 TUN 配置文档提供了 route-exclude-address、include-interface 和 exclude-interface 等字段,但不同系统支持范围并不完全相同,具体以 mihomo TUN 配置文档为准。
排查时不要同时大范围修改 Bypass、规则和 TUN 排除。建议先暂时关闭 TUN,仅打开系统代理测试;如果系统代理下生效,再重新启用 TUN,并单独添加 TUN 排除项。
system_proxy_bypass 应该写在哪里
system_proxy_bypass 是 Clash Verge Rev 的应用级系统代理设置,不是订阅配置中的 Mihomo 规则字段。官方项目配置结构将它定义为字符串字段,并同时提供 use_default_bypass 这一默认绕过选项,参考 Clash Verge Rev verge 配置结构。
如果确实需要手动检查配置文件,应先退出客户端或至少备份文件,再确认编辑的是 Clash Verge Rev 自己的 verge.yaml,而不是下载的订阅 YAML。示例:
use_default_bypass: true
system_proxy_bypass: "localhost;127.*;192.168.1.100"上面的示例使用 Windows 分隔符。macOS 的分隔符应按客户端界面和系统代理实现填写。保存后重新启动客户端,或关闭再重新应用系统代理。若界面中已经有 Bypass 输入框,优先使用界面,避免手动编辑路径错误或 YAML 缩进错误。
Bypass 不生效或所有网站打不开:按顺序检查
- 检查是否改错层级:如果启用了 TUN,先关闭 TUN,只保留系统代理测试;如果目标应用不读取系统代理,则不要期待 Bypass 单独生效。
- 检查分隔符:Windows 看是否使用英文分号;macOS 看是否使用英文逗号。删除中文标点、换行和多余引号后重新保存。
- 检查默认绕过选项:如果关闭了“使用默认绕过”,本机和局域网地址可能不再自动绕过。可以重新启用默认绕过,再测试
localhost或局域网 IP。 - 检查目标是否被误加入 Bypass:如果某网站本应走代理,却被加入绕过列表,它可能直接连接失败或走到错误出口。删除该条目后重新应用系统代理。
- 检查系统代理状态:确认系统代理仍指向 Clash Verge Rev 当前使用的本机地址和端口。若客户端重启、端口变化或系统网络切换后状态异常,关闭再打开系统代理。
- 检查规则模式:如果系统代理已经接管,但规则将目标判定为
DIRECT,修改 Bypass 不会把它强制改成代理出口;应调整规则。 - 缩小测试范围:先只保留一个完整域名或一个 IP,确认后再加入通配符、CIDR 或更多条目。
判定是否正常时,至少观察三项:系统代理开关是否保持开启、目标地址是否出现在连接记录、规则模式下实际命中的策略是否符合预期。不要仅凭网页能打开就判断 Bypass 已生效,因为网页可能使用缓存、其他网络接口或应用自带代理。
设置前后的自查清单
- 目标明确:是让地址直连,还是让地址强制走代理。
- 层级正确:普通浏览器优先看系统代理;TUN 接管的应用看 TUN 排除;精确选出口看规则。
- 格式正确:Windows 使用英文分号,macOS 使用英文逗号;示例域名和示例 IP 已替换成真实目标。
- 配置位置正确:
system_proxy_bypass属于应用级配置,不要写入订阅配置。 - 应用已重新加载:保存后重新应用系统代理,必要时重启 Clash Verge Rev。
- 结果可验证:通过系统代理状态、连接记录和规则命中结果交叉确认。
如果你的问题仍然是订阅导入失败、节点连接失败或系统代理整体不工作,可以继续查看站内的连接问题排查指南;如果是特定订阅的连接问题,可参考订阅与连接排查步骤。
常见问题
Clash Verge 的 Bypass 在哪里设置?
通常进入 Clash Verge Rev 的“设置”,找到“系统代理”区域,再打开“代理绕过”或“Bypass”输入框。保存后关闭并重新打开系统代理,使系统重新应用列表。
Windows 和 macOS 的 Bypass 分隔符一样吗?
不一样。Windows 多个条目通常使用英文分号分隔,macOS 通常使用英文逗号分隔。不要使用中文标点;如果填写后无效,先用单个完整域名或单个 IP 测试。
为什么把网站加入 Bypass 后,网站反而打不开?
因为 Bypass 的含义是绕过系统代理。如果该网站需要通过代理访问,加入 Bypass 会让它尝试直连。请删除该条目,并改用 Mihomo 规则将域名指定到相应代理策略。
启用 TUN 后,系统代理 Bypass 还有效吗?
不一定。系统代理 Bypass 只控制系统代理层;TUN 会在网络层接管流量。启用 TUN 后,应根据目标地址使用 TUN 流量排除配置,并结合规则验证实际路由。
system_proxy_bypass 可以写进订阅 YAML 吗?
不建议也不应这样处理。它属于 Clash Verge Rev 的应用级系统代理配置;订阅 YAML 主要承载 Mihomo 的节点、规则等配置。优先使用界面中的 Bypass 输入框,手动编辑时确认修改的是应用配置文件。
相关阅读
参考资料
- Bypass - Clash Verge Rev Docs(clashverge.dev)
- Clash Verge Rev verge 配置结构
- mihomo TUN 配置文档