proxies
节点
节点是一组用于建立代理连接的服务器参数，通常包含地址、端口、协议与认证信息，并不只是一条 IP 地址。配置中的 proxies 可定义节点，策略组再引用节点名称。导入后若无法连接，应分别检查地址解析、端口可达性、认证参数及内核协议支持，不能仅凭列表中出现名称判断可用。
CONFIGURATION · TERM INDEX
Clash 配置术语表
从配置键名定位概念，再核对平台与适用条件。以下按六类整理 24 个常用术语；卡片标题可直接链接，便于对照日志、订阅内容与客户端设置。
首次配置建议先读上手教程；安装、权限与各平台差异见全平台指南。本页的字段说明以支持相关能力的 Clash 生态内核为前提，不代表所有客户端都提供相同选项。
PROTOCOLS
代理协议
先区分远端连接参数与本地代理入口，再检查认证和传输条件。
type: ss
Shadowsocks
Shadowsocks 是一种加密代理协议，常见配置字段包括 server、port、cipher 和 password。客户端与服务端需要使用相容的加密方法及一致的认证参数。不同内核对加密方法和扩展的支持可能不同，迁移配置时应对照实际内核文档，而不是只复制服务器地址。
type: trojan
Trojan
Trojan 使用 TLS 承载代理通信，连接时通常需要服务器、端口、密码以及用于 TLS 验证的服务器名称。服务器地址与证书域名可能不同，不能随意把相关名称字段替换成 IP。出现证书错误时，先核对系统时间、域名与证书链；关闭证书验证会改变安全边界，不应作为常规修复步骤。
mixed-port
SOCKS5 与 HTTP 代理
这两类协议常用于应用连接本机代理入口，与远端节点使用的协议不是同一层。mixed-port 可在一个端口提供 HTTP 与 SOCKS 代理入口，但应用仍需遵循系统设置或单独填写代理参数。端口冲突时应先检查本机监听程序，修改端口后也要同步更新使用该入口的应用设置。
RULES & ROUTING
规则与分流
规则负责决定流量去向，订阅负责提供配置内容，两者应分开核对。
rules
规则分流
规则分流根据域名、目标 IP 或其他连接属性选择出口，rules 通常从上到下匹配，首条命中后即采用对应策略。DOMAIN-SUFFIX 匹配域名后缀，其结果还取决于内核能否获取连接对应的域名。自定义规则宜放在会覆盖它的宽泛规则之前，保存后重新加载，并从连接详情核对实际命中项。
direct / reject / match
DIRECT、REJECT 与 MATCH
DIRECT 与 REJECT 是内置策略，分别用于直连和拒绝连接；MATCH 则是匹配其余流量的规则类型，不能把三者当作同一类字段。写作 MATCH,DIRECT 表示将剩余流量直连，写作 MATCH,PROXY 则要求配置中确实存在名为 PROXY 的策略组或出口。兜底规则通常放在列表末尾。
geoip
GeoIP
GeoIP 将 IP 地址映射到地区信息，常见写法 GEOIP,CN,DIRECT 表示把被数据库归入中国地区的目标 IP 设为直连。地区归类可能受数据库更新、地址重新分配及 CDN 调度影响，不能用它推断节点延迟或服务商身份。更新时还要核对客户端使用的数据库格式与来源，避免文件已替换但运行内核仍在读取旧数据。
subscription / proxy-providers
订阅与节点提供者
订阅链接用于获取可更新的节点或完整配置，proxy-providers 则是配置中加载节点集合的一种机制。客户端的订阅更新可能覆盖整个配置，而提供者更新通常只改变其节点集合，因此本地规则应放在客户端支持的覆写或合并入口。订阅地址可能带有访问凭据，排查时应隐藏完整地址，不要上传公开日志或截图。
PROXY GROUPS
策略组
规则引用策略组，策略组再选择节点；组类型决定手动、测试或顺序选路。
type: select
select 手动策略组
select 让用户从候选节点或子策略组中手动选择出口，适合需要固定线路的应用。规则引用的是组名称，不是界面上当前显示的节点名称，因此切换候选通常不必修改规则。是否记住上次选择取决于客户端及配置设置；重启后发生变化时，应先检查选择持久化与订阅更新行为。
type: url-test
url-test 与延迟
url-test 访问指定测试 URL，按结果自动选择候选出口，interval 控制测试间隔，tolerance 可用于减少小幅延迟差异引起的切换。测试值反映当时到该目标的路径状况，不等于下载带宽，也不代表所有网站都能打开。比较结果时应保持测试地址和网络环境一致，并区分测试超时与应用访问失败。
type: fallback
fallback 故障转移
fallback 按候选列表的顺序选择可用出口，适合先用固定线路、失效后再切备用线路的场景。它的核心是优先级，而不是从所有候选中持续挑选最低延迟节点。使用前应把主线路排在前面，并确认测试目标确实能反映需要访问的业务；切换出口也不保证原有连接可以继续。
type: load-balance
load-balance 负载均衡
load-balance 按所选分配策略将不同连接交给多个候选出口，具体算法需核对当前内核支持。它不是把多个节点合并为一条高速线路，单个连接通常仍由一个出口承载。对来源 IP 敏感的登录、支付或会话服务，宜使用固定选择组，避免不同请求的出口变化触发额外验证。
DNS & NETWORK STACK
DNS 与网络栈
区分流量如何进入内核与域名如何解析，不把代理出口测试当作完整网络验证。
tun
TUN 模式
TUN 通过虚拟网络接口与路由接管流量，可覆盖部分不读取系统代理的应用，但不保证接管所有连接。桌面客户端可能需要服务组件或管理员权限，苹果移动端则通常通过系统提供的隧道能力实现。开启后异常时，分别检查路由、DNS 与其他 VPN 的冲突，不宜在已有系统代理问题尚未定位时反复叠加接管方式。
enhanced-mode: fake-ip
Fake-IP
Fake-IP 为域名返回合成地址并保留映射，使后续连接进入内核时仍能关联原域名，帮助完成分流。合成地址并不表示网站实际部署在该地址，不能把它当作真实服务端 IP 查询归属。局域网服务或依赖真实解析结果的应用可能需要配置例外，调整后还应检查系统与应用缓存，避免继续使用旧映射。
dns routing
DNS 泄漏
当域名查询绕过预期路径、被其他解析器接收时，通常称为 DNS 泄漏；是否属于问题应以预设的解析策略为准。浏览器安全 DNS、系统解析、应用自带解析与内核 DNS 可能同时存在，访问网站的出口 IP 不能单独证明查询路径正确。排查应结合解析器测试与连接日志，确认查询实际发往何处，再调整接管范围。
system proxy
系统代理
系统代理把代理地址与端口登记到操作系统，供愿意遵循该设置的应用读取，它不是对所有流量的强制转发。浏览器、命令行工具和自带网络栈的应用可能采取不同设置，因此浏览器可用不代表全部软件已接入。退出客户端后若网络异常，应检查系统代理是否仍指向已停止监听的本机端口，再决定恢复或重新启动服务。
APPLE PLATFORM
苹果平台专有概念
安装包架构、网络权限与凭据访问分别处理；授权完成并不等于节点已连通。
network extension
网络扩展
Network Extension 是苹果提供的网络功能扩展框架，应用可利用相关能力实现隧道与流量处理。不同客户端可能采用不同实现，并不是每个 macOS 客户端都需要相同的扩展批准步骤。系统提示授权时，应核对应用与开发者信息，再按该系统版本的设置入口操作；若客户端使用其他辅助服务，应以它实际显示的权限要求为准。
vpn configuration
VPN 配置授权
iOS 客户端首次建立隧道时，通常会请求允许添加 VPN 配置，批准后才能创建系统连接入口。这项授权不代表远端节点有效，也不代表所有流量都会选择代理出口，具体去向仍由路由与规则决定。连接无法建立时，先检查系统 VPN 状态及其他隧道是否冲突，再核对客户端日志与当前配置。
keychain
钥匙串
钥匙串是苹果系统保存密码、证书等敏感数据的设施，客户端可能用它存储或读取连接所需的信息。看到访问弹窗时，应核对请求应用和具体项目，再选择适当的授权范围。钥匙串访问、网络扩展批准与管理员权限彼此独立，反复弹窗也可能与应用身份或已保存项目有关，不宜直接删除整个钥匙串。
arm64 / x86_64
Apple Silicon 与 Intel
macOS 安装包常区分 Apple Silicon 的 arm64 与 Intel 的 x86_64，选择前可在苹果菜单的“关于本机”中查看芯片或处理器。Apple Silicon 上部分 Intel 应用可通过 Rosetta 运行，但这不等于其辅助组件与网络功能同样兼容。优先选择匹配架构的原生包，并同时核对最低系统要求。
CORE & CLIENT
内核与客户端
先确认实际运行的内核，再判断字段能否解析及界面是否会覆盖配置。
mihomo
mihomo 内核
mihomo 承接 Clash Meta 分支演进，负责协议连接、规则匹配、DNS 与网络处理等底层功能。图形客户端可以集成它，但应用名称不能直接证明内核版本，配置兼容性应查看客户端的内核信息。遇到字段不识别时，先核对运行版本与文档适用范围，再确认客户端是否过滤、改写或重新生成了配置。
graphical client
图形客户端
图形客户端提供订阅管理、出口选择、日志与系统集成界面，内核负责实际处理连接，两者不是同一个组件。即便采用相同内核，不同平台的权限、后台运行方式和可用设置也可能不同。比较客户端时应分别核对操作系统支持、内核能力及配置管理方式，选择建议可查阅横向评测。
config.yaml
YAML 配置
YAML 用缩进表达映射与列表关系，是 Clash 生态常用的配置格式；同层字段应保持一致缩进，并使用空格而不是制表符。语法解析通过只表示结构可读取，不代表字段被当前内核支持，也不代表节点与策略引用有效。编辑前保留可恢复副本，修改后先读取解析错误，再核对实际生效配置，避免订阅刷新覆盖本地改动。
external-controller
控制接口
external-controller 供客户端或管理面板读取状态、切换策略与管理连接，其监听端口不是 HTTP 或 SOCKS 代理入口。一般应限制在本机访问，并设置认证保护；只有明确了解访问控制时才考虑向其他设备开放。若面板无法连接，先检查监听地址、认证与内核状态，不要将代理端口直接填入控制接口设置。