CLASH / ECOSYSTEM
Clash
Clash 是基于规则进行流量转发的代理工具生态。常见客户端通常由图形界面、代理内核与配置管理功能组成，因此同为 Clash 客户端的软件，界面和内核版本可能不同。
遇到配置兼容问题时，应同时确认客户端名称、实际使用的内核以及配置语法，而不能只看软件标题。
CLASH CONCEPT INDEX
Clash 概念速查
按配置读取顺序整理内核、协议、节点、规则与 DNS 术语。用于看懂客户端设置、订阅内容、运行日志和 YAML 配置字段。
25 个核心术语
5 个分类
配置与排障参考
TERM_DB
STATUS: READY
ORDER: CONFIG_FLOW
术语分类导航
CATEGORY 01 / RUNTIME
内核与客户端
先区分图形客户端、代理内核、订阅来源与配置文件。它们处于同一运行链路，但职责不同。
MIHOMO / CORE
mihomo
mihomo 是持续维护的 Clash 兼容代理内核，负责解析配置、建立连接、执行规则匹配，并处理 DNS 与 TUN 流量。图形客户端启动代理服务时，通常会在后台调用内核。
内核支持的字段可能随版本变化。复制配置示例前，应确认当前客户端实际加载的是哪一种内核。
GUI / CLIENT
客户端
客户端是用户直接操作的图形界面程序，通常提供订阅管理、节点选择、系统代理控制、日志查看和内核更新入口。客户端本身负责交互，实际连接与分流多由内核完成。
不同客户端对配置覆写、备份路径和权限申请的处理并不完全一致，迁移时需要分别检查。
PROFILE / SUBSCRIPTION
订阅
订阅是服务提供方发布的远程配置入口。客户端读取订阅地址后，可获得节点、策略组以及部分规则配置，并在后续更新时重新拉取内容。
订阅链接不等同于单个节点，也不一定直接返回完整 YAML。导入失败时应先检查链接是否完整、是否过期以及客户端是否支持返回格式。
YAML / CONFIG FILE
YAML
YAML 是 Clash 配置文件常用的数据格式。字段层级由缩进表达，数组通常以短横线开头，冒号后需要保留正确的空格关系。
制表符、层级错位、重复字段和未闭合引号都可能导致配置解析失败。修改前可先保留一份可正常启动的配置。
CATEGORY 02 / TRANSPORT
代理协议
本地代理入口与远端节点协议属于不同层次。前者决定应用如何把流量交给客户端，后者决定内核如何连接服务器。
HTTP / LOCAL INBOUND
HTTP 代理
HTTP 代理接收浏览器或应用提交的 HTTP 请求，也可通过 CONNECT 方法转发 HTTPS 连接。它适合明确支持代理地址设置的浏览器、下载工具和开发环境。
这里只描述本地应用接入方式，不表示远端节点必须使用 HTTP 协议。
SOCKS5 / LOCAL INBOUND
SOCKS5
SOCKS5 是面向连接转发的通用代理协议，不要求理解上层网页内容。许多终端工具、浏览器扩展和开发软件都支持填写 SOCKS5 地址。
DNS 是否通过 SOCKS5 远程解析取决于应用实现和连接参数，不能仅凭端口类型判断。
MIXED-PORT / INBOUND
混合端口
混合端口可在同一监听端口接收 HTTP 与 SOCKS5 代理连接。它能减少需要记忆和维护的本地端口数量，适合多个应用共用一个入口。
应用仍需选择自身支持的代理类型，并把主机地址与端口填写正确。
OUTBOUND / PROTOCOL
代理协议
代理协议定义内核与远端服务器之间如何握手、认证和传输数据。不同协议在传输层、加密方式、UDP 支持和网络兼容性方面存在差异。
配置中的协议名称必须与服务端一致。只修改显示名称或端口，不能把一种协议转换成另一种协议。
UDP / DATAGRAM
UDP 转发
UDP 转发用于处理 DNS、实时通信和部分游戏产生的无连接数据报。是否能够通过节点转发，取决于节点协议、服务端能力和当前网络模式。
网页能够打开不代表 UDP 一定可用。排查时需要分别检查节点参数、策略选择与 TUN 路由。
CATEGORY 03 / OUTBOUND
策略组与节点
节点提供具体出口，策略组决定在多个出口之间如何选择。规则通常引用策略组，而不是直接绑定某一条节点。
PROXY / NODE
节点
节点是一条可供内核使用的代理服务器配置，记录服务器地址、端口、协议参数与认证信息。节点名称主要用于界面辨识，不会自动改变线路质量。
单个节点不等同于订阅。订阅通常包含多条节点及其分组关系，并可随远程配置更新。
DELAY / CONNECTIVITY TEST
延迟
延迟通常指测试请求从本机到目标地址并返回所需的时间。它会受到本地网络、测试地址、节点负载和线路路径影响，因此多次结果可能不同。
低延迟不直接等于高下载速度，也不能单独代表长期稳定性。选节点时还应观察连接成功率和实际访问表现。
PROXY-GROUP / POLICY
策略组
策略组把多个节点或其他策略组组织成一个可被规则引用的出口。常见类型包括手动选择、自动测试、故障转移和负载分配。
策略组可以嵌套，但循环引用会导致配置错误。修改组名后，还需要同步检查规则中的目标名称。
URL-TEST / AUTO SELECT
自动选择
自动选择策略组会按设定的测试地址与时间间隔检查候选节点。内核通常选择测试结果较低且能够连接的节点作为当前出口。
测试地址应稳定且能够代表主要使用场景。过短的测试间隔会产生额外请求，也可能造成频繁切换。
FALLBACK / FAILOVER
故障转移
故障转移按预设顺序检查候选节点，在当前节点不可用时切换到下一项。它强调连接连续性，通常优先保留顺序靠前且可用的节点。
因此，故障转移不等同于始终选择最低延迟。候选顺序应按稳定性和用途安排。
CATEGORY 04 / RULE ENGINE
规则与匹配
规则引擎按顺序检查连接属性。排查分流错误时，应先确认目标信息，再查看最先命中的规则。
RULES / ROUTING
规则分流
规则分流根据域名、IP、进程或网络类型，把连接交给不同策略。常见用途是让局域网与特定站点直连，其余连接按策略组处理。
规则通常从上到下匹配，命中第一条有效规则后停止继续检查。更具体的规则一般应放在更宽泛的规则之前。
MATCH / FINAL RULE
MATCH
MATCH 是规则列表中的最终兜底规则。当前面的域名、IP、进程和规则集都未命中时，连接会交给 MATCH 指定的策略。
它通常位于规则列表末尾。若提前出现，后续规则将失去实际匹配机会。
DOMAIN-SUFFIX / DOMAIN RULE
DOMAIN-SUFFIX
DOMAIN-SUFFIX 按域名后缀匹配目标。配置 example.com 时，可覆盖该主域名以及通常的子域名访问。
它与 DOMAIN 精确匹配不同，也不应把完整 URL 路径写入规则。规则目标只处理域名部分。
GEOIP / IP DATABASE
GeoIP
GeoIP 使用 IP 地址数据库判断目标地址所属地区。它适合处理已经得到目标 IP 的连接，但结果受数据库版本和地址归属变化影响。
域名规则与 GeoIP 规则可能在不同阶段参与匹配。排查时应结合 DNS 模式确认内核最终看到了域名还是 IP。
RULE-PROVIDER / RULESET
规则集
规则集把大量匹配条目拆分到独立文件或远程资源中，再由配置中的规则提供器加载。它便于复用、分类和单独更新。
规则集更新失败时，旧缓存可能继续生效，也可能导致对应规则不可用。应检查资源地址、行为类型、保存路径和更新日志。
CATEGORY 05 / NETWORK MODE
DNS 与网络模式
系统代理只影响遵循代理设置的程序；TUN 与 DNS 模块用于接管更广泛的系统连接并保留域名信息。
TUN / VIRTUAL INTERFACE
TUN 模式
TUN 模式通过虚拟网络接口接收系统流量，可覆盖未提供代理设置的应用。启用时通常需要系统权限，并由内核配置路由、DNS 劫持和接口参数。
连接异常时应依次检查权限、虚拟网卡、路由冲突、防火墙和 DNS 设置。仅打开界面开关并不保证所有流量都已进入 TUN。
FAKE-IP / DNS MAPPING
Fake-IP
Fake-IP 模式向应用返回保留地址，并在连接阶段把该地址映射回原始域名。这样能让规则引擎保留域名上下文，减少过早解析为真实 IP 带来的匹配偏差。
少数局域网设备、游戏或特殊应用可能不适合使用映射地址，可通过过滤列表排除对应域名。
REDIR-HOST / REAL IP
Redir-Host
Redir-Host 模式向应用返回真实的 DNS 解析结果，行为更接近常规网络解析。它不依赖 Fake-IP 地址池，但某些连接在后续阶段可能只保留目标 IP。
当规则依赖域名而连接只剩 IP 信息时，匹配结果可能与预期不同。切换模式后应重新测试 DNS 缓存与分流。
DNS LEAK / RESOLVER PATH
DNS 泄漏
DNS 泄漏是指域名查询绕过预期的 Clash DNS 路径，交由其他解析器处理。常见来源包括浏览器独立加密 DNS、系统服务缓存、其他虚拟网卡和不完整的 TUN DNS 劫持。
排查时应先确定查询由哪个进程发起，再核对系统 DNS、浏览器设置、监听端口和运行日志。
SYSTEM PROXY / OS SETTING
系统代理
系统代理是操作系统提供的代理地址设置。遵循该设置的浏览器和应用会把请求发送到 Clash 的本地监听端口。
部分程序会忽略系统代理，部分命令行工具还需要单独配置环境变量。需要覆盖这类流量时，可根据系统条件评估 TUN 模式。
继续查阅配置字段
术语用于理解概念；字段结构、规则语法和 YAML 示例可在配置参考中继续查询。