Clash之家 · 客户端与字段参考
Clash 下载
与配置手册
以 mihomo 内核 为线索,整理平台入口、YAML 配置 与规则分流 ,从安装步骤进入字段细节。
mihomo 内核
GPL-3.0 开源
YAML 配置
CONFIGURATION / FIELD MAP
config.yaml
port
port: 7890
mode
mode: rule
dns
enhanced-mode: fake-ip
proxies
type: ss
proxy-groups
type: select
rules
MATCH,DIRECT
YAML / 字段关系示意 · 非完整配置
配置能力索引 01 — 06 / FIELD NOTES
字段结构, 分流依据。
配置文件把入口、解析与出口连接起来。先辨认字段归属,再调整具体行为;客户端中的开关,最终仍需落到内核能够读取的配置。
下列索引以 mihomo 常用字段为参照。不同图形客户端对字段的开放程度、覆写方式与权限要求可能不同,配置迁移前应同时核对客户端说明。
规则分流 RULES
规则分流用有序列表决定连接交给哪个出口。域名后缀、目标地址与规则集合可分别描述不同匹配范围,通常由靠前的命中项决定处理结果。实际调整时,先确认客户端处于规则模式,再检查目标策略名是否存在,将兜底规则放到末尾。它与全局模式的区别不在于节点数量,而在于每条连接是否依据规则选择路径;排查异常时应查看连接记录中的命中规则,而不只看测速结果。
适用平台 具备相应内核能力的图形客户端
相关 YAML 字段 rules、rule-providers
阅读规则语法
策略组 PROXY-GROUPS
策略组在规则与节点之间提供一层可复用的出口名称。手动选择组适合保留明确的控制权,延迟测试组与故障转移组则按各自逻辑选择可用成员。配置时应让规则引用组名,让组再引用节点或节点提供器,避免把大量节点名直接写进规则。测试地址与测试间隔会影响选择结果,单次延迟也不能代表所有业务表现。组名必须保持一致,循环引用与已删除成员都可能造成配置加载失败。
适用平台 支持相应策略组类型的客户端
相关 YAML 字段 proxy-groups、type、use
阅读策略组字段
DNS 解析 DNS
DNS 配置决定域名如何得到地址,也会影响基于域名的分流。fake-ip 模式利用虚拟地址保留域名关联,具体兼容性还取决于应用与网络环境。修改前应区分系统解析器、客户端 DNS 监听地址和上游解析服务,避免把三者视为同一个设置。排查解析异常时,先确认请求是否进入内核,再检查上游能否连通及域名策略是否匹配。仅启用加密 DNS 并不能证明所有应用的解析流量都经过预期路径。
适用平台 支持内核 DNS 设置的客户端
相关 YAML 字段 dns、nameserver、enhanced-mode
阅读 DNS 配置
订阅管理 PROXY-PROVIDERS
订阅管理需要区分完整配置订阅与仅包含节点的提供器。前者可能同时携带规则和策略组,后者通常由本地配置通过引用组织起来。导入前应确认返回内容是客户端支持的格式,而不是登录页面或一组未经转换的链接。订阅地址可能包含账户标识,分享日志时应先移除相关内容。需要保留个人分流规则时,可将节点来源与本地规则分开维护,避免远程更新覆盖手工修改;刷新成功后仍应检查节点和策略组是否实际加载。
适用平台 支持订阅导入或提供器引用的客户端
相关 YAML 字段 proxy-providers、url、interval
阅读订阅字段
TUN 模式 TUN
TUN 模式通过虚拟网络接口接入流量,适合处理不读取系统代理设置的应用。它与系统代理的区别在于接入层级,并不意味着开启后所有路由与解析问题都会自动解决。桌面端通常需要服务模式或相应权限,移动端则受系统网络扩展机制约束。启用前先让普通代理路径工作,再逐项检查自动路由、DNS 接管及局域网访问。若与其他网络工具同时运行,应核对路由优先级,避免多个虚拟接口重复接管同一段流量。
适用平台 以客户端权限与网络栈实现为准
相关 YAML 字段 tun、auto-route、dns-hijack
阅读 TUN 字段
配置覆写 OVERRIDE
配置覆写把订阅提供的内容与个人设置分开,适合固定本地端口、追加规则或调整 DNS。覆写通常由客户端在加载阶段完成,不应假定所有客户端都支持同一个顶层字段或相同脚本接口。迁移时需要确认映射如何合并、列表是追加还是替换,以及最终生成文件的保存位置。每次只修改一类设置,并在重载后检查生效配置;直接编辑缓存文件虽然可能暂时有效,但下一次订阅刷新或客户端重启就可能将其替换。
适用平台 提供合并、覆写或脚本接口的客户端
相关 YAML 字段 依客户端实现;关注最终 rules 与 dns
阅读覆写与合并
01
选择客户端与安装包
从下载页选择操作系统,再确认处理器架构与安装格式。安装后先打开客户端的配置页和日志页,了解配置从哪里加载、错误在哪里出现。已有代理工具运行时,先记录其设置并退出,避免端口与系统代理相互覆盖。
初次使用不必同时开启全部网络选项。先保持默认监听范围,确认内核正常启动,再按实际应用需求选择系统代理或 TUN 接入。需要授权的步骤应在理解用途后完成。
02
导入配置并选择策略
在配置页粘贴可信来源的订阅地址,或导入已有 YAML 文件。下载完成后,将该配置设为当前使用项,检查是否出现节点和策略组。若只有导入记录而没有可用节点,应先检查格式与加载日志,而不是反复切换系统代理。
随后进入代理页,选中需要使用的策略组与节点,并确认运行模式为规则模式。配置导入只是建立规则与出口的对应关系,客户端本身不会凭空生成远程代理服务。
03
接入流量并检查路径
启用适合当前系统的接入方式后,访问一个已知可达的站点,再查看连接页中的域名、命中规则和实际出口。测速只反映测试请求的情况;网页访问、解析结果与连接日志共同构成验证依据。
出现异常时,从本地网络、系统时间、订阅内容、节点连接到 DNS 逐层排查。每次只调整一个变量并记录结果。退出客户端后,也应检查系统代理是否恢复,避免应用仍指向已经关闭的本地端口。
SOURCE / 开源生态
内核与界面的职责边界
客户端名称不是协议。 配置语法也不是服务来源。
Clash之家是中文资料整理站,不代表各客户端项目的发布机构。下载选项、字段说明与教程分别对应不同层级,阅读时应保留这些边界。
阅读开源生态全景 →
项目历史与延续
原版 Clash 与部分早期图形客户端停止维护后,生态并未变成一个统一的新产品。mihomo 延续并扩展了相关内核能力,Clash Verge Rev、FlClash 等图形项目则承担各自平台的界面与系统集成。历史教程中的截图、按钮名称与字段默认值不一定适用于当前客户端,遇到差异时应以所用项目的文档和实际生效配置为准。
因此,搜索“Clash 官网”时需要进一步确认对象:内核仓库、图形客户端主页和订阅服务商是不同来源。资料站可以提供索引与解释,但不能代替项目维护者作出兼容性承诺。归档客户端适合研究既有环境,新安装环境则应优先评估仍在维护的替代方案。
内核执行,客户端组织
内核负责协议连接、DNS 处理、规则匹配与出口选择;图形客户端负责配置导入、策略切换、日志展示以及系统代理等设置。同一个内核可以被多个界面使用,同一个界面也可能在更新中调整内核组件。判断某项功能是否可用,需要同时检查内核能力、客户端是否提供入口,以及操作系统是否授予必要权限。
配置文件处于两者之间:它描述期望行为,却不保证系统流量已经进入内核。客户端显示运行中,只能说明某些组件已启动;要确认实际接管效果,还需查看连接记录与系统设置。这也是教程把“导入成功”和“连接验证”拆成两个步骤的原因。
开源依据与问题反馈
mihomo 的源代码与许可说明可在公开仓库中查阅,内核采用 GPL-3.0 许可;各图形客户端的许可应分别阅读其项目说明。开源意味着实现与修改历史可以被检查,不等于所有分发文件、订阅来源和远程节点具有相同的维护主体。选型时可参考发布记录、问题讨论与文档变更,不以未经核实的下载量或评分替代判断。
提交问题前,先确认异常发生在界面、内核还是订阅内容。反馈可包含操作系统、客户端名称、复现步骤及已脱敏的错误信息。订阅地址、节点密码和控制接口凭据不应出现在公开截图或日志中;保留必要上下文,比粘贴整份配置更有助于定位。
更新与配置的独立维护
客户端更新、内核更新、订阅刷新和规则集合更新是四种不同操作。前两者改变程序能力,后两者改变程序读取的数据。某条规则更新成功,并不能说明客户端已经更新;界面升级后,也应重新检查个人覆写是否仍按原来的顺序合并。涉及行为变化时,先保留可恢复的配置副本,再分项调整。
本站首页不固定展示版本信息。安装包、可选架构与维护状态集中放在下载页,字段语义集中放在 YAML 手册。这样可以将“选哪个程序”和“如何表达网络行为”分开处理,减少因旧截图、旧文件名或跨客户端设置差异造成的误判。
git clone https://github.com/MetaCubeX/mihomo.git
复制命令
此命令用于获取源代码,需要本机已安装 Git;日常安装使用下载页中的客户端选项即可。
先选择平台,再比较客户端与架构。Clash Plus 是下载页中适用平台的首推选项;需要特定桌面交互或 Linux 安装格式时,可继续查看 Clash Verge Rev 与 FlClash。完整清单同时保留归档项目的维护状态说明,便于识别旧教程中出现的名称。
客户端与节点来源分开判断
安装客户端并不等于取得远程节点。搜索“Clash 免费节点”时,应先了解来源、更新方式与数据处理边界;公开地址的可用性和保密性不能由客户端保证。订阅中可能带有个人标识,导入、转换或跨设备同步时,应只使用可信渠道。
不确定配置里的节点、策略组与规则各指什么,可先阅读概念速查 ;已能启动但访问异常,可转到帮助中心 按现象排查。
文章按具体问题展开,补充手册中不适合放进字段定义的操作背景。首次安装可先完成快速上手,再根据遇到的现象阅读界面说明、同步方案或连接排查;不必在建立基本连接之前改动全部高级选项。
故障排查
给出节点测速超时、无法连接时的逐层排查清单,覆盖系统时间、端口占用、DNS 模式与协议参数。
2026-11-03 故障排查
入门指南
按侧边栏顺序逐页说明各区块的用途、常用按钮和设置项含义,帮助新用户快速认清界面布局。
2026-10-17 入门指南
多端同步
比较多设备同步配置的几条路线,分析各自的更新时效、隐私风险与平台兼容性,附推荐组合。
2026-09-29 多端同步