概念查阅 · macOS 配置参考

Clash 术语表

从协议名称到系统设置，按配置时遇到的位置查阅。每个词条说明概念、作用与使用边界；理解术语后，再到客户端对应页面调整设置。

初次配置可先阅读快速上手；需要比较协议与内核时，参阅协议手册。本页词条均有独立锚点，可直接分享链接。

连接使用什么协议

代理协议

协议规定客户端与服务器如何交换数据。它与节点名称、出站模式不是同一概念；在客户端里改一个协议标签，不能让服务器自动支持另一种协议。

ShadowsocksSS: 以加密转发为核心的代理协议，常见配置包括服务器地址、端口、密码和加密方法。客户端与服务端必须使用兼容的参数；传统方法与 Shadowsocks 2022 的密钥要求存在差异，不能只改加密方法名称就直接迁移。导入后若提示方法不受支持，应先确认内核能力，而不是反复切换系统代理。

VMessVMess protocol: V2Ray 生态中的代理协议，通常用 UUID 标识用户身份，并可搭配不同传输方式。UUID 正确仍不足以保证连接成功，TLS、服务器名称、路径等参数也需要与服务端一致。系统时间明显偏差可能影响认证，在 Mac 上排查时可先检查「系统设置」中的日期与时间。

TrojanTLS-based proxy protocol: 通常借助 TLS 保护连接的代理协议，配置中常见密码、服务器地址和服务器名称。证书名称、有效期与信任链都会影响握手，出现证书错误时应逐项核实，而不是直接跳过验证。Trojan 本身不要求向 macOS 安装额外的根证书，遇到此类要求需确认具体用途。

VLESSVLESS protocol: V2Ray 与 Xray 生态中的轻量代理协议，本身不提供载荷加密，实际安全性依赖 TLS、REALITY 等机制及正确配置。客户端是否支持某种 VLESS 组合，要看内核版本和具体传输参数。订阅导入成功只表示文件被接受，不代表其中每种连接组合都能正常建立。

Hysteria2Hy2 · QUIC: 基于 QUIC 的代理协议，通常使用 UDP 建立连接，设计上关注不稳定网络中的传输表现。实际体验仍取决于线路质量、UDP 可用性与带宽配置，并非名称里带有新协议就一定更快。若切换到某个网络后无法连接，可先检查该网络是否允许相关 UDP 通信。

TUICQUIC-based proxy protocol: 基于 QUIC 的代理协议，可承载 TCP 与 UDP 流量，并通过复用连接减少部分建连开销。不同协议版本和实现之间存在兼容边界，客户端参数应与服务端要求对应。选择时除了看内核支持，还要考虑当前网络对 UDP 的限制；系统代理开关不能解决底层 UDP 不通的问题。

设置界面与执行逻辑

内核与客户端

菜单栏应用负责操作入口，代理内核负责实际处理连接。判断一个功能是否可用，需要区分应用版本、附带内核与 macOS 授权，不能只看客户端名称。

原版 ClashOriginal Clash core: Clash 生态早期的规则代理内核，定义了许多后续项目沿用的配置结构，原项目已停止维护。旧配置中的基础节点、策略组与规则可能被后续内核读取，但这不意味着新增协议和字段能反向兼容。阅读旧教程时，应将操作步骤与当前客户端文档交叉确认。

Clash MetaFormer name of mihomo: mihomo 的早期项目名称，因此旧教程、配置注释和部分应用名称中仍会出现 Meta。这个名称不是所有图形客户端的统称，也不能据此判断某个应用附带的内核新旧。遇到字段不识别或协议不支持时，应查客户端显示的实际内核信息。

mihomoRule-based proxy core: 由 Clash Meta 延续发展的规则代理内核，负责协议连接、DNS 处理、规则匹配和出站调度。它本身不是一套完整的 macOS 菜单栏界面，通常由图形客户端启动和管理。新配置能否使用仍取决于具体内核版本，不能将所有 mihomo 功能视为每个客户端都已支持。

图形客户端GUI client: 提供菜单栏、订阅管理、策略组选择与设置页面的应用，后台通常会调用独立的代理内核。系统代理写入、开机启动和辅助服务授权属于客户端与系统的协作范围，不完全由内核决定。同一份配置在不同应用中的操作路径可能不同，升级应用与升级内核也未必同步。

连接进入内核后如何选出口

规则与策略组

规则负责判断连接，策略组负责组织可选出口。排查分流结果时，先看连接命中了哪条规则，再看它引用的策略组最终选择了什么。

规则分流Rule-based routing: 根据域名、目标 IP、进程等条件，为连接选择直连、代理或拒绝等出站方式。常规规则按顺序匹配，前面命中的规则通常优先，末尾的 MATCH 用于承接未被前面规则覆盖的连接。调整规则位置会改变结果，因此新增规则后应查看连接记录，而不只是确认文件保存成功。

策略组Proxy group: 将节点或其他策略组组织成一个可被规则引用的配置单元，常见类型包括手动选择、自动测试与故障回退。自动测试关注测试目标的响应结果，故障回退则按设定顺序寻找可用出口，两者不是同一种策略。切换某个组只影响引用它的连接，未引用该组的规则不会随之改变。

出站模式Rule / Global / Direct: 常见选项为规则、全局与直连，用于决定已进入内核的流量如何选择出口。规则模式按配置匹配，全局模式通常交给全局策略，直连模式则不经远端代理转发。全局模式不等于 TUN，也不能让原本未进入内核的应用流量自动被接管。

GeoIPIP geolocation data: 将 IP 地址映射到地区信息的数据，常被规则用于按目标地址选择出站策略。它不是域名目录，数据更新滞后、共享地址和 CDN 调度都可能让结果与直觉不同。针对域名的连接，是否先解析地址还与规则参数有关，不宜只按网站名称推断匹配结果。

GeositeDomain classification data: 按地区、服务或用途整理的域名分类数据，规则可通过集合名称引用一批域名。它依据域名集合匹配，与依据目标 IP 地区的 GeoIP 不同；同一个网站还可能使用多个资源域名。集合名称和覆盖范围取决于数据源，看到某个分类名称并不代表所有相关服务都已收录。

macOS 流量入口与 DNS 路径

网络与系统

这一类设置决定应用如何把流量交给客户端，以及域名由谁解析。先确认接管路径，再检查出站结果，可以减少同时修改多个开关造成的判断混乱。

系统代理System proxy: macOS 为网络服务保存的代理入口设置，遵循系统设置的应用会将请求交给指定地址与端口。浏览器通常能使用这一入口，但部分终端工具、游戏或自带网络栈的应用可能忽略它。关闭客户端前若系统代理未恢复，应用仍可能请求已经停止监听的本地端口。

TUN 模式Virtual network interface: 通过虚拟网络接口与路由，将匹配的 IP 流量送入代理内核，常用于接管不读取系统代理的程序。macOS 上通常需要授权或安装辅助服务，实际覆盖范围由路由、排除项和 DNS 配置共同决定。开启后若与其他 VPN 冲突，应先核对路由与接口状态，而不是只更换节点。

Fake-IPSynthetic DNS mapping: 一种 DNS 处理方式，为查询的域名返回用于内核映射的虚拟地址，内核随后利用映射恢复域名并处理连接。这有助于保留域名信息进行分流，但地址本身不是网站的真实服务器地址。部分局域网服务或依赖真实解析结果的应用，可能需要加入 Fake-IP 过滤例外。

DNS 泄漏DNS leak: 指 DNS 查询没有按预期的解析路径发送，而被其他解析器处理的情况，重点是实际路径是否符合配置目标。浏览器安全 DNS、系统解析器、客户端 DNS 与 TUN 路由都可能影响结果。测试页面出现某个解析器名称不能单独定论，应结合预期配置与客户端日志判断。

混合端口mixed-port: 在同一个监听端口接收 HTTP 代理与 SOCKS 代理请求的入口，方便不同应用共用本地代理服务。7890 是常见示例，实际数值以客户端配置为准；修改后，手动填写代理的应用也要同步更新。是否允许其他设备访问还受监听地址、防火墙与局域网连接设置影响。

延迟Latency / URL test: 客户端对指定目标进行连通性测试所得的耗时，测试地址、连接建立过程与线路状态都会影响数值。低延迟不等于高下载速度，也不能代表所有网站访问正常，因为吞吐量和目标路由是不同维度。测试超时可能涉及节点、DNS 或测试目标，应结合实际访问和日志定位。

配置从哪里来、如何保存

订阅与配置文件

订阅是配置的分发方式，YAML 是常用文件格式，节点则是配置中的出站条目。三者处于不同层次，文件能导入与连接能建立也需要分别验证。

订阅Subscription: 通过链接获取节点或完整配置的分发方式，本身不是代理协议，也不是安装客户端后自动附带的连接资源。不同链接可能返回 Clash YAML、编码后的节点列表或其他格式，能否直接导入取决于客户端支持。订阅链接可能含有访问凭据，排查时不要将完整地址贴到公开页面。

节点Proxy entry: 描述一个代理出站连接所需参数的配置项，通常包含服务器地址、端口、协议与认证信息。节点显示名称只是便于识别的标签，不能据此确认实际位置、线路质量或所用协议。选择节点后仍需让规则引用对应出口；列表中出现节点并不表示当前连接已经经过它。

YAMLConfiguration data format: Clash 配置常用的文本数据格式，通过缩进、键值对和列表表示层级关系，缩进应使用空格而不是制表符。格式解析成功只说明语法可读，字段名称、引用对象与内核支持仍需另外检查。手动修改前保留副本，修改后先查看加载日志，避免把语法错误误判为网络故障。

订阅自动更新Scheduled profile refresh: 客户端按设定周期重新获取订阅内容，以更新节点、规则或其他配置，具体覆盖范围由订阅内容决定。它不等于更新应用或内核，也不保证 Mac 睡眠或断网期间仍能按时完成。直接写入订阅文件的修改可能被覆盖，持久调整宜使用客户端提供的覆写、合并或本地配置机制。