配置字段 · 协议概念 · 设置边界
Clash 术语手册
按设置场景查术语。先确认概念作用,再核对客户端中的字段、权限与生效配置。
本页收录 25 个常用条目。术语解释适用于理解配置;菜单名称和支持范围以实际客户端及内核版本为准。
内核与客户端
界面负责操作入口,内核处理连接。遇到功能差异时,两者都要核对。
- 客户端
- Client application
- 提供订阅管理、策略选择和系统设置的应用界面,常见桌面客户端还会管理托盘菜单、开机启动与日志。客户端负责组织操作,内核负责处理连接;两款应用即使界面相似,也可能采用不同的内核版本和配置合并方式。选型时应分别检查系统支持、维护状态和所需功能。
- mihomo
- Proxy core
- 由 Clash Meta 延续发展的代理内核,负责协议连接、规则匹配和 DNS 等处理,本身并不等同于某一款图形客户端。配置能否加载,取决于正在运行的内核版本及字段支持情况。查到新功能文档后,应先在客户端的内核信息或启动日志中确认版本,再决定是否调整配置。
- Clash Meta
- Historical core name
- Clash 生态中扩展内核的历史名称,后续发展为 mihomo,因此旧教程、订阅选项与应用名称中仍可能保留 Meta 字样。这个名称不能直接说明某个安装包的发布时间,也不能保证它具备当前 mihomo 的全部能力。迁移旧配置时,应关注字段兼容性,而不是只改文件名或客户端显示名称。
- TUN 模式
- Virtual network interface
- 通过虚拟网络接口接入流量的工作方式,可覆盖部分不遵循系统代理设置的应用。启用通常涉及管理员权限、虚拟接口、路由和 DNS 接管;具体覆盖范围由操作系统与客户端实现决定。开启后若出现断网,应检查路由冲突、其他 VPN 和 DNS 设置,不宜直接认定为节点失效。
- 系统代理
- System proxy settings
- 操作系统提供的代理地址设置,供遵循该设置的应用把请求送往客户端的本地监听端口。开启系统代理并不代表全部流量都会进入代理,游戏、命令行工具和部分应用可能使用自己的网络设置。退出客户端后若普通网页也无法打开,可先检查系统是否仍保留指向已关闭端口的代理地址。
代理协议
协议类型必须与服务端匹配。连接表现还受线路、传输方式与网络条件影响。
- Shadowsocks(SS)
- Shadowsocks
- 使用预共享密钥与指定加密方法建立连接的代理协议,节点条目通常需要服务器地址、端口、加密方法和密码。客户端与服务端必须使用兼容的协议代际及认证参数,不能仅把类型名称改成 SS 就让其他协议的节点工作。出现认证失败时,先核对订阅内容与内核支持,再排查线路连通性。
- VMess
- VMess protocol
- 使用用户标识进行认证、可搭配不同传输方式的代理协议;实际节点还可能包含 WebSocket、TLS 和服务器名称等参数。类型相同但传输层参数不同,仍会导致连接失败。排查旧配置时,应检查完整参数与系统时间是否正常,不要只比较节点名称或单独复制一段用户标识。
- Trojan
- Trojan protocol
- 通常依托 TLS 连接并使用密码认证的代理协议,连接时既要建立 TLS,也要完成协议认证。服务器名称、证书校验和密码需要与服务端一致,因此端口可访问并不表示节点一定可用。遇到证书错误应核对时间、域名和证书配置,关闭证书验证不应成为默认处理方式。
- VLESS
- VLESS protocol
- 将认证与外层传输安全分开的轻量代理协议,本身不提供数据加密,实际安全属性取决于搭配的传输设置。TLS、REALITY、传输类型与相关参数共同决定连接方式,不能只凭 VLESS 名称推断兼容性。导入后若字段被忽略或报不支持,应先确认当前内核是否实现了相应组合。
- Hysteria 2 与 TUIC
- QUIC-based proxy protocols
- 两种不同的基于 QUIC 的代理协议,都依赖网络允许相应 UDP 通信,但认证方式和配置字段并不通用。它们在部分丢包场景中有不同于 TCP 方案的表现,仍不能保证任何线路都更快。选择时应同时考虑服务端支持、网络对 UDP 的限制和移动设备续航,再用实际业务验证。
需要比较传输取舍?查看协议与内核技术参考。
规则与分流
规则决定连接交给谁,策略组决定出口如何选择。排查时先看实际命中项。
- 规则分流
- Rule-based routing
- 依据域名、IP 或其他连接属性,为流量选择处理策略的机制。规则通常自上而下匹配,首个命中项决定后续策略,因此更具体的条件通常要放在宽泛条件之前。某个应用走向不符预期时,应查看连接记录中的命中规则,再调整顺序或条件,而不是先反复切换节点。
- 策略组
- Proxy group
- 把节点或其他策略组织成可选择、自动测试或故障切换的集合,规则可以直接引用组名。这样可把业务分类与实际出口分开:规则保持不变,只在组内调整选择。不同类型的策略组具有不同切换条件,自动测试也只反映指定测试目标的结果,不代表所有应用都能正常访问。
- GeoIP
- IP geolocation database
- 通过 IP 数据库将目标地址映射到地区等分类的规则依据,例如
GEOIP,CN,DIRECT用于匹配数据库中对应的地址。数据库可能存在滞后,同一服务也可能使用多个地区的地址,因此不能用它替代全部域名规则。更新数据后仍分流异常时,还应确认实际解析结果和前置规则。
- GeoSite
- Categorized domain datasets
- 按服务或用途整理的域名集合,可供
GEOSITE规则引用,减少逐个维护域名的工作量。分类名称是否存在取决于所加载的数据文件,并不是所有数据源都提供相同集合。它处理的是域名分类,与 GeoIP 的地址分类不同;找不到分类时,应检查数据源与更新日志。
- DIRECT、REJECT 与 MATCH
- Actions and catch-all rule
DIRECT与REJECT是处理策略,分别表示直接连接和拒绝连接;MATCH是匹配剩余流量的规则类型,通常放在末尾。示例MATCH,PROXY中,PROXY 通常是配置自定义的策略名称,并非自动存在的节点。引用名称必须与配置中的定义一致。
网络与 DNS
域名解析、流量接入和节点连接是不同环节,需要分别确认。
- DNS
- Domain Name System
- 将域名解析为网络地址等记录的系统,应用通常先获得解析结果,再发起连接。客户端的 DNS 设置会影响请求路径、解析结果及部分规则判断,但更换解析器不会直接提高节点带宽。遇到域名无法访问而 IP 可连通的情况,可优先检查解析日志、缓存和应用是否使用独立 DNS。
- Fake-IP
- Synthetic address mapping
- 由内核向应用返回合成地址,并维护地址与域名映射的 DNS 工作方式;合成地址并不是目标服务的真实公网地址。连接回到内核后,可利用映射保留域名信息并进行分流。部分局域网服务或应用可能需要真实解析结果,出现兼容问题时应按需配置过滤项,并留意旧 DNS 缓存。
- DNS 泄漏
- DNS leak
- DNS 请求绕过预期解析路径、到达其他解析器的现象,判断前需要先明确期望由谁解析、通过哪条路径发送。浏览器安全 DNS、应用内置解析器和系统 DNS 都可能改变请求去向。检测页面显示的解析器地区只能作为线索,不能单独证明是否泄漏,应结合日志与实际网络设置核对。
- 延迟
- Latency
- 测试目标在特定方法下完成响应所需的时间,客户端常用的 URL 测试可能包含连接建立与请求响应,并不等同于 ICMP ping。数值受测试地址、缓存、网络状态和超时设置影响,因此不同工具的结果不宜直接比较。较低延迟通常有利于交互响应,但不能直接推断持续下载速度或视频稳定性。
- 允许局域网连接
- Allow LAN access
- 允许其他设备访问本机代理监听服务的设置,常对应
allow-lan,并不等同于让本机自动接管整个局域网。实际访问还受监听地址、防火墙、代理端口和无线网络隔离影响。使用时应限制在可信网络内,并按需设置认证与访问范围,避免把监听服务暴露到不必要的网络。
订阅与配置
订阅提供内容,配置描述运行方式,覆写决定最终合并结果。
- 订阅
- Subscription
- 通过链接获取节点集合或完整配置的更新机制,内容可能是协议链接列表,也可能是包含规则和策略组的 YAML 文件。客户端需要支持相应格式,文件能下载并不代表一定能导入。订阅链接可能包含访问凭据,应避免公开粘贴到截图、日志或问题描述中;自动更新间隔也应结合来源要求设置。
- 节点
- Proxy endpoint
- 描述一个代理出口所需连接参数的条目,通常包含协议、服务器地址、端口和认证信息,并可能附带传输与 TLS 参数。节点名称只是便于识别的标签,不足以证明服务器位置、线路质量或当前可用性。修改显示名称一般不会改善连接,排查应回到完整参数、服务状态与网络路径。
- YAML
- YAML configuration format
- 用于表示映射、列表和标量等数据的文本格式,Clash 配置常用它描述代理、规则与 DNS。缩进、字段层级和数据类型都会影响解析,同一行文字放到不同层级可能产生不同含义。编辑时应使用空格缩进并保留备份;语法能够解析之后,还需要由内核检查字段是否合法、引用是否存在。
- 配置覆写
- Configuration override
- 在订阅配置加载过程中合并或修改指定字段的机制,适合保留本地 DNS、规则或监听设置,减少每次更新后的重复编辑。不同客户端对合并顺序、列表追加和字段替换的处理可能不同,不能假设同名功能具有相同结果。修改后应查看实际生效配置,并确认订阅再次更新后仍符合预期。
- 代理集合与规则集合
- Proxy providers / Rule providers
proxy-providers与rule-providers分别用于独立加载节点集合和规则集合,使资源更新与主配置分开管理。声明集合后仍需由策略组或规则引用,否则资源存在也不代表参与处理。更新失败时,应区分主订阅与集合资源的日志,并检查格式、路径、更新间隔及本地缓存。