Clash 术语表
按设置所在的位置，查清内核、订阅、规则与 DNS 的含义。
先找分类，再读术语卡。每张卡都说明概念、作用与容易混淆的边界；遇到陌生字段时，可以直接分享卡片锚点。这里的配置解释以 mihomo 为主，不同客户端的界面名称可能略有差异。
config.yaml → 术语 → 操作
按步骤完成首次配置 ›
内核与客户端
先区分负责操作的界面、负责转发的内核，以及流量进入内核的方式。
- mihomocore / 代理内核
- 把它理解为实际处理连接的程序。mihomo 由 Clash Meta 更名而来，负责读取配置、处理 DNS、匹配规则与转发请求。客户端更新与内核更新不一定同步，判断某个字段能否使用时，应核对正在运行的内核及其版本，而不是只看应用名称。
- GUI 客户端graphical user interface / 图形界面
- 用它完成导入订阅、选择代理和查看日志等操作，不必手动输入每条命令。GUI 是图形用户界面的缩写，界面背后通常还要启动代理内核。两个客户端即使使用同一内核，也可能在配置合并、权限管理和设置保存位置上存在差别。
- 系统代理system proxy / 应用代理入口
- 先用它让遵循系统设置的应用连接本地代理端口。开启系统代理通常只是写入代理地址，不代表全部流量都会被接管；部分终端工具、游戏和自带网络栈的应用可能忽略这项设置。关闭客户端后若网络异常，可先检查系统是否仍保留旧的代理地址。
- TUN 模式virtual network interface / 虚拟网络接口
- 在应用不读取系统代理时，再考虑通过 TUN 虚拟网络接口接管流量。它配合系统路由把连接交给内核，通常需要管理员权限、服务模式或系统 VPN 授权。开启开关不等于接管成功，还要检查路由、DNS 与排除项，并留意它和其他 VPN 的冲突。
- 外部控制接口external-controller / 管理接口
- 通过这个接口，客户端或管理面板可以读取状态、切换策略与管理连接。字段
external-controller指定监听地址，例如127.0.0.1:9090；它不是浏览器填写的代理端口。只在本机管理时应保持本地监听，需要远程访问时再规划认证与访问范围。
配置文件字段
先认清文件结构，再核对当前实际生效的值，不要只改下载下来的原文件。
- YAMLconfig.yaml / 结构化文本
- 编辑配置时，先保持原有缩进层级。YAML 是一种结构化文本格式，常见于
config.yaml；缩进表示从属关系，短横线表示列表项，缩进应使用空格而不是制表符。含特殊字符的值可能需要引号，保存后应先检查语法，再重新加载配置。
- mixed-portlistener / 混合监听端口
- 把应用的代理端口填成这个字段的实际值。
mixed-port: 7890表示在同一端口接受 HTTP 与 SOCKS 代理连接，但数字可以修改，并非所有客户端都固定使用它。若端口被其他程序占用，内核可能无法正常监听，应先查日志再调整两端设置。
- allow-lanlocal network / 局域网访问
- 只有需要让同一局域网内的其他设备使用代理时，才考虑开启它。
allow-lan: true允许局域网连接，但实际能否访问还受监听地址与系统防火墙影响。开放前应确认网络可信，并按需要配置认证；它不是让本机正常联网所必需的选项。
- moderule / global / direct
- 日常使用通常先选择
mode: rule，让请求按规则选择出口。global把连接交给全局策略，direct则采用直连方式；这里的全局仍以进入内核的流量为范围。切换模式不能让原本绕过内核的应用自动进入代理。
- log-levellogging / 日志级别
- 排查问题时，用它调整日志的详细程度，常见值包括
info、warning、error与debug。更详细的日志有助于定位解析、规则和连接问题，但也会增加输出量。分享日志前应清理订阅地址、认证信息及不希望公开的访问记录。
代理协议
区分应用连接本地代理的方式，与内核连接远端服务所使用的协议。
- HTTP 代理HTTP / CONNECT
- 在支持手动代理的应用中，可以选择 HTTP 代理并填写监听地址。访问 HTTPS 网站时，通常通过 CONNECT 方法建立隧道；目标网站的 HTTPS 与客户端到代理之间是否加密是两回事。普通 HTTP 代理不会自动为所有链路增加加密，也不能直接替代通用 UDP 转发。
- SOCKS5TCP / UDP ASSOCIATE
- 在应用支持时，可用 SOCKS5 将连接交给本地代理。该协议支持 TCP，并定义了处理 UDP 的机制，但应用、客户端与远端链路都要具备相应支持。域名由本机还是代理端解析也取决于应用用法，不能仅凭选择 SOCKS5 就认定 DNS 一定走代理。
- ShadowsocksSS / 加密代理协议
- 导入此类节点时，核对服务端地址、端口、密码与加密方法。Shadowsocks 使用双方约定的参数传输代理流量，参数不匹配时通常无法建立可用连接。不同内核对具体加密方法和扩展的支持可能不同，不能仅根据节点名称判断兼容性或速度。
- VMessUUID / 传输参数
- 配置时，把用户标识 UUID 与传输设置一起核对。VMess 可配合不同传输方式使用，只有地址和端口正确，仍可能因路径、主机名或 TLS 设置不一致而连接失败。系统时间明显错误也可能影响认证，因此排查时应同时检查时间同步与内核日志。
- TrojanTLS / 服务器身份验证
- 连接这类节点时，同时核对密码、服务器名称与证书要求。Trojan 通常在 TLS 连接内承载代理流量，TLS 用于保护传输并验证服务器身份。遇到证书错误时，应先检查时间、域名与服务端配置，不要把跳过证书验证当成常规解决办法。
规则与分流
先看匹配条件，再看出口名称；规则顺序与数据文件都会影响结果。
- 规则分流rules / 按条件选择出口
- 在规则模式下，用域名、目标 IP 等条件决定请求走向。规则通常从上到下检查，先命中的条目决定出口，所以具体例外应放在宽泛规则前面。出口可以是
DIRECT直连，也可以是某个策略组；组名必须与配置中定义的名称一致。
- DOMAIN-SUFFIXdomain matching / 域名后缀匹配
- 需要同时覆盖域名及其子域名时，使用这类规则。例如
DOMAIN-SUFFIX,example.com,DIRECT可匹配example.com与www.example.com。它按域名后缀边界匹配，不会因为另一个域名中恰好包含相同文字就自动命中。
- GeoIPGEOIP / IP 地址归类
- 需要根据 IP 所属国家或地区分流时，查阅 GeoIP 数据。规则
GEOIP,CN,DIRECT表示把数据库归入 CN 集合的地址交给直连；匹配域名请求时可能涉及解析。数据库存在更新与归类误差，地址标签不能保证服务器的实际物理位置。
- GeoSiteGEOSITE / 域名集合
- 需要按服务或类别管理大量域名时，可引用 GeoSite 集合。与按 IP 归类的 GeoIP 不同，它主要依据维护好的域名条目匹配，类别名称取决于所加载的数据文件。写入规则前应确认该类别存在，并使用适合当前内核的数据来源。
- MATCHfallback rule / 兜底规则
- 在规则列表末尾，用 MATCH 为前面均未命中的请求指定出口。例如
MATCH,PROXY会把剩余请求交给名为 PROXY 的策略。它本身不判断网站属于哪个地区；如果放得过早，后面的规则将无法接到本应继续检查的请求。
DNS 与网络
把域名解析与建立连接分开检查，避免用一个开关解释所有网络现象。
- DNSdomain name system / 域名系统
- 访问域名前，应用通常先通过 DNS 查询 IP 地址等记录。解析与后续网页连接是两个环节，所以能访问某个 IP，并不能证明域名解析正常。系统、浏览器与代理内核都可能参与解析，排查时应先确定是谁发出查询、使用哪个解析器，再调整对应设置。
- Fake-IPenhanced-mode / 合成地址映射
- 启用这种 DNS 工作方式后，内核先向应用返回合成地址，并保存地址与域名的映射。应用连接该地址时，内核再结合域名处理请求，因此看到的地址不一定是网站真实公网地址。少数应用或局域网服务可能不兼容，可针对具体域名设置过滤，而不是反复更换节点。
- nameserverupstream resolver / 上游解析服务
- 在 mihomo 的
dns段中，用这个字段指定上游解析服务。列表可以采用内核支持的地址形式，但某次查询的实际去向还可能受到域名策略、代理节点解析设置等字段影响。不要把它理解为系统全部 DNS 请求的唯一出口，修改后还应检查接管范围与缓存。
- DNS 泄漏resolver path / 解析路径偏离
- 先明确预期的解析路径，再判断是否存在泄漏。这个词通常指查询发到了预期之外的解析器，例如网页走代理，而域名仍经本地网络解析。检测结果应结合浏览器安全 DNS、系统设置、TUN 接管和缓存一起分析；看到解析器所在地不同，不能单独证明全部流量的走向。
- DNS 劫持dns-hijack / TUN 内的 DNS 重定向
- 在 mihomo 配置语境中，
dns-hijack指把匹配的 DNS 请求重定向给内置解析模块。这与通常讨论的恶意篡改解析结果不是同一含义。它常配合 TUN 使用，但仅接管指定目标和协议，不能假定浏览器发出的加密 DNS 请求也会自动被识别并接管。
订阅与节点
区分配置来源、具体连接参数和出口选择方式，再理解测试结果。
- 订阅链接subscription / 配置来源
- 将服务提供方给出的订阅链接导入客户端，用于拉取配置或代理条目列表。不同链接可能返回完整 YAML、编码列表或其他格式，需要与客户端的导入方式匹配。链接常包含账户访问标识，应按凭据保管，截图与求助时不要公开；更新失败也不一定意味着所有节点已经失效。
- 节点proxy entry / 代理连接条目
- 把节点理解为一组可供内核使用的连接参数，通常包含服务器地址、端口、协议与认证信息。节点显示名称由配置提供方设定，不一定准确反映实际位置或出口。一个节点能否访问目标服务，还受线路、远端出口和目标限制影响，不能仅凭名称判断。
- 延迟latency / 指定测试的耗时
- 先看测试方法和目标地址，再比较延迟数值。客户端测试通常反映通过代理完成指定请求的耗时，会受到网络、连接建立与目标响应影响，并不等于单纯的 ICMP 往返时间。延迟低不代表下载带宽高，测试超时也可能只是该测试目标不可达。
- proxy-providersproxy collection / 代理集合来源
- 在配置里，用这个字段声明可独立更新的代理集合，来源可以是远程地址或本地文件。策略组引用集合后，便可使用其中的节点，并按配置执行更新或健康检查。它通常只管理代理条目，不直接替代包含 DNS、规则等内容的完整配置，因此不能把所有订阅链接都原样填进这里。
- 策略组proxy-groups / 出口组织方式
- 需要在多个节点之间选择时，用策略组统一提供出口名称。
select通常用于手动选择，url-test根据测试结果选择，fallback则按顺序寻找可用项，具体行为由参数决定。规则引用组名后，组内选择仍会影响实际连接，排查时要同时看命中的规则与最终节点。