Clash Wiki / 配置词典
Clash 术语手册
从 mihomo 内核到 TUN、Fake-IP、策略组与订阅更新，按配置链路拆解常见概念。每个词条说明它解决什么问题、与哪些设置相关，以及排查时容易混淆的边界。
5 类配置主题
27 个核心词条
面向移动端与桌面端
分类入口
按配置环节定位概念
先从遇到问题的环节进入，再沿词条中的关联概念继续查阅。内核负责执行，模式决定接管范围，规则选择出口，DNS 保留域名信息，客户端负责导入与控制。
Core / Protocol
内核与协议
这一组概念决定配置由谁执行、文件怎样解析，以及远端连接采用什么通信方式。遇到配置无法载入、字段不受支持或内核启动失败时，应先检查这里。
- Clash
- 一类使用规则匹配、策略组与代理协议完成流量分流的客户端及其生态名称。日常所说的 Clash 可能指客户端界面、配置格式，也可能泛指兼容该配置体系的内核。排查问题时应先确认具体客户端名称与实际内核。
- mihomo
- 由 Clash Meta 延续发展的代理内核，负责连接建立、规则匹配、DNS、TUN 和策略调度。客户端界面通常通过配置文件或控制接口管理它。某个设置能否使用，最终取决于客户端集成的内核版本与暴露出的功能。
- 代理协议
- 客户端与远端服务器建立连接时采用的通信规范，配置中会包含服务器、端口、认证和传输参数。协议名称只描述连接方法，并不直接代表线路质量。参数必须与服务端一致，否则节点会载入但无法建立有效连接。
- YAML
- Clash 配置文件常用的数据格式，通过缩进表示对象层级，通过短横线表示列表项。制表符、错位空格、缺少冒号或重复键都可能导致载入失败。编辑长配置时应保持统一缩进，并注意字符串中的特殊符号。
- Rule Provider
- 将规则集合拆分到本地文件或远程地址的机制，中文常称规则集或规则提供器。主配置只需声明来源、更新间隔与行为类型，再通过对应规则引用。它适合维护体积较大的域名和地址集合，也便于单独更新规则。
Traffic Capture
代理模式
代理模式包含两层含义：流量如何进入内核，以及进入后是否执行规则。系统代理和 TUN 解决接管范围，规则、全局和直连模式决定后续处理方式。
- 规则模式
- 按照规则列表自上而下匹配连接，并把流量送往指定策略组、代理或直连。它可以让不同网站和应用走不同路径，是日常使用中最常见的模式。如果同一目标命中意外策略，应检查较靠前的规则是否提前截获。
- 全局模式
- 忽略常规分流规则，把已接管的连接统一交给全局策略。它适合临时测试某个节点，或判断访问异常是否由规则造成。全局模式不会自动扩大接管范围，没有进入内核的应用仍不会被处理。
- 直连模式
- 让内核接管到的连接直接访问目标地址，不经过代理节点。切换到直连后若访问恢复，问题可能位于节点或代理路径；仍然失败时，应继续检查本地网络和 DNS。直连模式与关闭客户端并不完全相同，因为接管和解析链路可能仍在运行。
- 系统代理
- 把操作系统的 HTTP 或 SOCKS 代理地址指向 Clash 的本地监听端口。浏览器等遵循系统设置的程序会自动使用该入口，但部分游戏、命令行程序和独立网络栈可能忽略它。此时需要单独设置应用代理，或评估是否启用 TUN。
- TUN 模式
- 通过虚拟网络接口接管 IP 流量，可覆盖不读取系统代理设置的程序。移动端通常表现为 VPN 常驻连接，桌面端可能要求安装服务、网络扩展或提升权限。启用后应同时检查路由、DNS 接管及其他 VPN 工具是否发生冲突。
Rules / Policy
规则与策略
规则回答某条连接应当交给谁，策略组回答当前由哪个节点或动作执行。两者分开设计后，可以更新节点而不改规则，也可以调整规则而不重建订阅。
- 规则分流
- 依据域名、IP、端口或进程等条件决定连接使用代理、直连还是拒绝。规则通常按书写顺序匹配，命中后不再继续向下查找。较具体的条件应放在通用集合和最终兜底规则之前，以免被提前覆盖。
- 策略组
- 把多个节点或其他策略组合成可选择、可测试或可故障转移的逻辑入口。规则通常引用策略组名称，而不是直接绑定某一个节点。这样更换订阅节点时，规则结构仍可保持稳定。
- select
- 由用户手动选择当前出口的策略组类型，适合需要明确控制连接路径的场景。客户端一般会记住选项，但重新导入配置、策略组改名或节点消失后可能回到默认值。订阅更新后应检查关键策略是否仍指向预期节点。
- url-test
- 按指定测试地址周期检查候选节点，并依据测试结果自动选择连接路径的策略组类型。测试只反映访问该目标时的响应情况，不等同于所有网站的速度。过短的检测间隔还会增加后台网络活动和移动端耗电。
- fallback
- 根据候选顺序和健康检查结果选择可用节点的策略组类型。它优先处理连接可用性，在当前节点失效时切换到后续候选。与 url-test 相比，fallback 不以持续选择最低响应时间为主要目标。
- GeoIP
- 依据目标 IP 在地理数据库中的分类执行规则匹配。域名连接通常要先获得地址，才能参与这类判断，因此解析路径会影响结果。数据库内容存在更新周期，不能把 GeoIP 结果视为服务器实际位置的绝对证明。
- GeoSite
- 按域名分类集合进行匹配的数据形式，常用于组织地区、服务或用途相关的规则。它处理的是域名归类，不是 IP 地理定位。站点使用多个域名或第三方资源时，可能需要多个分类共同覆盖。
DNS / Network
DNS 与网络
DNS 不只是把域名转换成地址，还会影响规则能否获得原始域名、查询经由哪条网络路径，以及连接最终落到哪个地址。已连接但网页打不开时，这一组最值得优先检查。
- DNS
- 把域名转换为网络地址的基础服务。Clash 可以接管查询、选择上游解析器，并把域名信息交给规则系统。解析失败、返回地址不可达或查询未进入预期链路，都可能表现为网页长时间等待。
- DNS 泄漏
- 域名查询绕过预期的 Clash 解析链路，转而由其他网络接口或解析器处理的现象。它可能造成域名解析路径与代理连接路径不一致。排查时应同时检查系统 DNS、浏览器加密 DNS、TUN 接管和回退解析设置。
- Fake-IP
- 本地 DNS 模块先向应用返回映射地址，再由内核恢复原始域名并执行规则匹配的增强模式。它有助于在连接阶段保留域名信息，并减少先解析再匹配造成的歧义。局域网设备、连通性检测和少数特殊应用可能需要加入 Fake-IP 过滤列表。
- redir-host
- 先完成真实 DNS 解析，再依据域名和实际地址处理连接的兼容模式。它的工作方式更接近传统网络解析，对部分局域网和特殊应用更容易理解。与 Fake-IP 相比，域名信息的保留时机和规则命中路径有所不同。
- nameserver
- Clash DNS 模块用于处理常规域名查询的上游解析器列表。条目可以是传统 DNS，也可以是受内核支持的加密 DNS 地址。选择上游时要同时考虑其可达路径、解析结果和是否需要经过代理。
Client Control
客户端功能
客户端负责接收订阅、展示节点、写入系统设置并向内核发送控制指令。界面显示已连接，只代表本地接管状态已经开启，实际访问还需经过解析、规则、策略和节点四个环节。
- 订阅
- 通过远程链接向客户端分发节点、策略组或完整配置的方式。更新订阅会重新读取上游内容，节点增删和名称变化可能随之进入本地。手动修改能否保留取决于客户端是否支持覆写、合并或单独的本地配置层。
- 节点
- 配置中可供策略组调用的单个代理连接项，通常包含服务器地址、端口、协议和认证参数。节点名称只是方便识别的标签，不能单独说明其可用性。载入成功也不代表服务端可达，仍需通过实际连接或健康检查确认。
- 延迟
- 客户端向测试目标发起请求后得到的响应耗时，用于观察当前网络路径。结果会随测试地址、线路负载、本地网络和测试方式变化。较低延迟不等于较高下载速度，也不能替代对稳定性和目标站点可达性的判断。
- mixed-port
- 同时接受 HTTP 与 SOCKS 代理连接的本地监听端口。应用可以根据自身支持的代理类型连接同一个端口，简化本地设置。若客户端无法启动监听，应检查端口是否已被其他代理工具或后台进程占用。
- External Controller
- mihomo 提供给客户端界面或外部控制面板的管理接口，可以读取连接、切换策略和重载配置。它通常只需监听本机地址。需要允许局域网访问时，应配置访问控制并限制接口的网络可达范围。