配置参考 / macOS

Clash 名词解释

系统代理决定哪些应用会把连接交给内核,规则分流决定交给内核的连接走哪条路。按分类查阅设置项、配置字段与日志术语。

内核与协议

区分界面、内核和远端连接。

mihomo

mihomo 是延续 Clash.Meta 项目的代理内核,负责读取配置、监听本地入口、匹配规则和建立出站连接。Clash Verge Rev 等客户端提供操作界面,实际的网络处理由内核执行。诊断配置兼容性时,要区分客户端版本与内核版本:界面可以显示一个选项,但具体行为仍取决于内核如何实现。

代理协议

代理协议规定连接如何建立、认证以及传输数据,例如 Shadowsocks 和 Trojan。配置节点时,协议及其参数必须与服务端匹配,仅有服务器地址和端口并不足以建立连接。浏览器访问本地代理时使用的 HTTP 或 SOCKS5 入站协议,与内核连接远端节点时使用的协议,是两个不同的设置。

节点

节点是配置中的一条代理出站定义,通常包含名称、协议、服务器地址、端口和连接参数。代理组可以列出多个节点,也可以包含直连等其他策略。两个节点即使显示同一个地区名称,也可能使用不同的协议或线路;切换节点后,应使用原本出问题的应用重新验证。

延迟

客户端显示的节点延迟通常来自通过该节点访问指定测试地址的测量,单位为毫秒。测试地址、测试时刻和连接状态变了,数值也可能随之变化。延迟低不等于带宽高;若文件下载慢,应检查实际传输速度,而不是只看一次探测的结果。

代理模式

先看连接怎么进入内核,再看内核怎么处理。

系统代理

开启系统代理后,Clash 客户端会把本地代理地址和端口写入 macOS 的网络代理设置。读取并遵循该设置的应用才会将适用的请求发给内核,自行建立连接的程序可能不受影响。若浏览器已正常而终端仍连不上,先确认命令行工具是否读取系统设置,再决定是否为它单独配置代理。

TUN 模式

TUN 模式通过虚拟网络接口和系统路由,把匹配的流量送入代理内核,不要求应用主动读取系统代理。开启时可能需要系统授权,接管范围也受路由配置和排除项影响。若同时运行其他 VPN 或虚拟网卡工具,遇到连接异常时可逐个停用做对照,避免把路由冲突误判为节点故障。

出站模式

出站模式只决定已交给内核的连接怎样处理。规则模式按配置顺序匹配;全局模式通常使用全局组当前选中的策略;直连模式则让已接管的连接直接访问目标。切换到全局不会让未被接管的应用自动进入代理,切到直连也不等于关掉 TUN 或清除系统代理。

混合端口

混合端口是内核的本地监听端口,对应 mihomo 配置字段 mixed-port,可同时接收 HTTP 代理和 SOCKS5 请求。应用仍需按自身支持的协议填写代理类型,不能只填端口。端口号以客户端当前设置为准;复制教程中的数值前,应先核对本机实际监听的端口。

规则与分流

用日志里的命中规则解释连接走向。

规则分流

规则模式下,内核按配置顺序检查连接的域名、目的 IP 等特征,通常采用第一条匹配的规则。该规则可以把连接交给某个代理组,也可以指定直连或拒绝。新增规则没有效果时,先看连接日志命中了哪一条,再确认是否需要把新规则移到覆盖范围更广的规则前面。

DOMAIN-SUFFIX

这是按域名后缀匹配的规则类型。DOMAIN-SUFFIX,example.com,DIRECT 会在拿到相应域名时匹配 example.com 及其子域名 www.example.com,但不匹配 notexample.com。如果只想匹配一个完整域名,应使用 DOMAIN。

GeoIP

GeoIP 根据目的 IP 在归属数据中的分类结果匹配连接,不按网页使用的语言、域名后缀或 Mac 所在位置判断。如果目标最初是域名,且内核还不知道它的地址,检查 IP 规则时可能触发解析。同一网站由不同地区的 CDN 节点响应时,命中的结果可能随目的地址变化。

MATCH

MATCH 是无条件匹配规则,通常放在规则列表最后,用于处理没有命中前面任何一条规则的连接。比如 MATCH,DIRECT 表示剩余连接直连。若把它放在一条具体的域名规则前面,连接会先命中 MATCH,后面的域名规则就没有机会生效。

订阅与配置文件

区分配置来源、文件格式和可引用的策略。

订阅

订阅是客户端通过一个远程地址获取并更新配置或节点列表的方式。能在浏览器里打开链接不代表能导入:返回的内容可能是登录页面,也可能采用客户端不支持的格式。更新失败时,先确认链接是否还有效、返回内容是否适配当前客户端;向他人描述报错时不要附上完整订阅地址。

YAML

YAML 是一种文本数据格式,Clash 生态的配置常用它表达端口、代理组和规则列表。缩进表示层级,应使用一致的空格而不是制表符;列表项通常以短横线开头。文件通过 YAML 语法解析,也不代表每个字段都受内核支持,遇到报错还要核对字段名称和取值。

代理组

代理组由配置中的 proxy-groups 定义,让规则引用一个稳定的策略名称,而不必写死某个节点。手动选择组由用户指定成员,自动测速组则按其测试机制选择成员。修改策略时先核对连接命中的是哪个组,在另一个组里切换节点不会改变这条连接所用的策略。

规则集

规则集把一组域名、地址或其他匹配条件放在独立来源中,便于单独更新。在 mihomo 配置中,可通过 rule-providers 定义规则集来源,再用 RULE-SET 在规则列表中引用。匹配后的出站策略由引用它的那一行指定,规则集更新成功也不会改变那一行在列表里的优先级。

macOS 系统网络

确认设置属于本机、当前网络服务,还是单个应用。

回环地址

127.0.0.1 是常用的 IPv4 回环地址,指向发起连接的设备自身。macOS 代理设置填入这个地址时,应用连接的是 Mac 上监听的端口,不是远端节点服务器。把同一地址填进手机的代理设置会指向手机自身;如果 Mac 上的内核没有在指定端口监听,Mac 上的连接也无法建立。

网络服务

macOS 用网络服务管理 Wi-Fi、以太网等连接,每项服务可以有独立的代理和 DNS 设置。检查系统代理时,在「系统设置 → 网络」中打开当前使用的服务,再查看其代理设置。换用网线或扩展坞后,不要仅凭之前的 Wi-Fi 设置判断系统代理是否仍然生效。

代理绕过列表

系统网络设置中的绕过列表告诉遵循该设置的应用,访问哪些主机或域时不要使用系统代理,例如本机服务 localhost。绕过发生在应用把请求发给本地代理之前,与内核收到连接后执行 DIRECT 不是同一环节。开启 TUN 时,不应把绕过列表当作路由排除项。

代理环境变量

部分命令行程序会读取 https_proxy、all_proxy 或 no_proxy 来选择是否使用代理,具体支持情况以工具文档为准。在终端会话中导出的变量会传给从该会话启动的子进程,不会自动改写系统设置。排查终端与浏览器行为不同时,应分别核对两者的代理来源。

DNS 与域名解析

把查询交给谁,与连接从哪里出去分开看。

DNS 解析

DNS 解析用于查询域名对应的地址等记录。解析成功只说明拿到了记录,不能证明应用能连到该地址,也不能说明连接选择了哪条代理规则。排查时,先区分「没有返回地址」和「有地址但连接失败」:前者查解析路径,后者查连接日志、命中策略及节点状态。

Fake-IP

内核可以在 DNS 响应中返回一个合成地址,并在本地记录它与原域名的映射。后续连接进入内核时,内核可恢复域名用于规则匹配,因此看到合成地址并不等于解析故障。若某项局域网服务依赖真实地址,应先确认是否与此模式冲突,再考虑针对域名设置 fake-ip-filter。

DNS 泄漏

当原本预期由指定路径处理的 DNS 查询发给了其他解析服务,就可能发生 DNS 泄漏。网页连接走代理,并不意味着域名查询也走同一路径。排查时应核对客户端的 DNS 设置、系统当前使用的解析器,以及浏览器是否启用了独立的安全 DNS;测试结果要与预期的解析策略对照。

分流 DNS

分流 DNS 按域名或指定条件选择上游解析器,例如让内部服务域名交给能回答该域名的组织内解析器。mihomo 可用 nameserver-policy 为匹配的域名指定解析器。它解决的是「向谁查地址」,不是「连接地址时走哪个出口」;这两个阶段的判断条件要分别核对。