CONFIG / 工单队列
先分清“流量有没有进入内核”和“进入后走哪条规则”。下面的片段分别用于检查一个环节，不是可独立运行的完整订阅。代理组名称必须与现有配置一致；示例中的 PROXY 需要替换为实际存在的组名。
规则模式解决的是同一台设备上直连与代理并存的问题。将运行模式设为 rule，先写需要明确处理的域名，再写地理规则，最后用 MATCH 兜底。与全局模式不同，规则模式不会把所有请求交给同一个代理组；与直连模式不同，它仍会执行配置中的分流逻辑。访问目标站点后，打开连接记录核对命中的规则和最终出口。示例中访问其他未命中目标才会落到高亮行，不代表每次请求都走这里。
mode: rule
rules:
- DOMAIN-SUFFIX,github.com,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXYTUN 通过虚拟网络接口接管流量，适用于不遵循系统代理的程序，但不意味着开启后所有连接都会走代理，最终仍受规则控制。桌面客户端通常需要服务模式或管理员权限，移动端则通过系统的 VPN 授权入口工作。先确认普通系统代理能够访问，再启用 TUN、自动路由和接口检测，避免同时引入两个未知变量。若与其他 VPN 共存，先停用其中一个并复测；遇到内网地址不可达，应检查路由排除，而不是反复更换节点。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53DNS 配置解决域名如何解析、解析请求从哪里出去的问题。启用 fake-ip 后，内核可以先返回映射地址，再在连接阶段按域名分流；它与直接返回真实地址的方式不同。仅改增强模式并不能保证系统 DNS 被接管，还要检查 TUN 的劫持设置、浏览器安全 DNS 和应用内置解析器。下面列出基础字段，上游地址需要按网络环境选择。复测时同时查看解析记录和连接规则，检测站显示的解析器所在地只能作为线索，不能单独证明存在泄漏。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- https://dns.alidns.com/dns-query订阅导入解决配置来源与后续更新的问题。图形客户端中的远程配置通常包含节点、代理组和规则，而 proxy-providers 只负责提供节点，不能把两种入口混用。先在配置页导入服务方提供的地址，确认更新成功，再选为当前配置；不应把地址粘贴到浏览器公开分享或提交到陌生转换站。下面片段演示节点提供器的更新结构，示例地址需要更换，引用它的代理组也需要另行定义。更新失败时先看 HTTP 状态，再查有效期和本地缓存。
proxy-providers:
remote:
type: http
url: "https://example.com/proxies.yaml"
path: ./providers/remote.yaml
interval: 86400覆写用于保留本地端口、DNS 或规则调整，避免每次订阅更新后重新编辑。不同客户端的合并配置、扩展脚本和覆写入口并不相同，不能把某个前端的操作路径当作内核通用功能。先备份原配置，再只覆盖需要改变的字段，启动后检查最终生成的运行配置。列表字段尤其要确认是替换还是追加，否则自定义规则可能被放到兜底规则之后。与直接改远程缓存相比，独立覆写更便于回滚；出问题时临时停用覆写即可缩小排查范围。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: infoPACKAGES / 按系统选型
客户端负责界面、配置管理和系统集成，内核负责协议处理与规则执行。选择时先看操作系统和处理器架构，再看维护状态与功能支持。Clash教程站整理下载入口与配置方法，并非各客户端项目的官方站点，也不提供代理服务或订阅账户。
优先从 Clash Plus 开始，也可按使用习惯选择 Clash Verge Rev、FlClash 或 Clash Nyanpasu。下载前确认系统类型与安装权限；首次运行先导入配置，再打开系统代理。需要 TUN 时检查服务模式是否安装成功，避免把权限错误误判成订阅失效。
前往下载 →先在“关于本机”确认是 Apple Silicon 还是 Intel，再选择对应安装包。Clash Plus、Clash Verge Rev 与 FlClash 可按界面和维护情况比较。首次启动遇到系统安全提示时，按系统设置中的授权流程处理，不要为一个应用关闭整套安全保护。
前往下载 →可先看 Clash Plus，再比较 Clash Meta for Android、FlClash 与 Surfboard 的配置兼容性。首次连接需要系统 VPN 授权；若切到后台后连接中断，检查电池优化和后台运行限制。安装包架构应与设备一致，配置格式也要与所选客户端相符。
前往下载 →下载页提供 Clash Plus 的 App Store 入口及官网 clashplus.io。安装后导入受支持的订阅或配置，并允许添加 VPN 配置。系统显示 VPN 已连接仅代表隧道建立，仍需实际访问目标网页，确认规则与出口符合预期。
前往下载 →桌面环境可从 Clash Verge Rev 或 FlClash 选择，按发行版使用对应的软件包。无桌面的服务器与路由器更适合直接运行 mihomo 内核。图形界面的系统代理开关不一定影响终端程序，需要结合环境变量、应用代理设置或 TUN 判断实际流量路径。
前往下载 →归档客户端仍可用于理解历史配置，但不应只因熟悉旧界面就忽略维护状态。迁移到 mihomo 生态时，重点检查协议字段、代理组引用和 DNS 参数；能导入文件不等于每个字段都被采用。多个代理客户端同时运行也可能争用端口与路由，初次验证时只保留一个。
查看全部客户端 → · 查看客户端横向评测 →QUICKSTART / 最小连接流程
先跑通最简单的路径，再增加覆写、自定义规则和 TUN。准备好受支持的订阅地址、可正常联网的设备，以及一份原配置备份。客户端本身不会生成可用节点，安装完成与具备代理服务是两回事。
在客户端的配置或订阅页面添加远程地址，执行一次更新。看到节点与代理组后，再将这份配置设为当前使用项。若列表为空，先查看更新日志里的状态码和解析错误；订阅链接可能包含账户标识，不要把完整地址贴进公开截图。此时暂不修改 DNS，保留一个能够回退的起点。
选择规则模式，在代理组中选定可用出口，再开启系统代理。桌面浏览器通常可用这条路径完成首次测试；移动端按提示授予 VPN 权限。若某个应用不读取系统代理，再单独评估 TUN。不要一边切换全局模式、一边改端口和路由，否则一次成功也很难知道是哪项设置起了作用。
分别访问预期代理和预期直连的目标，观察连接页面中的域名、命中规则与代理链。网页失败时记录具体错误：解析失败、连接超时与证书异常的排查方向不同。测试结束后关闭代理再访问一次，确认系统代理能正常恢复。只看开关变色不算验证，配置文件也不会因为被保存就自动正确。
SOURCE / 内核与前端的边界
判断一个客户端是否适合长期使用，先看它依赖什么内核、如何更新配置、遇到错误能否查看运行日志。项目名称相近，不代表来自同一维护者，也不代表功能与更新节奏完全相同。
原版 Clash 项目停止维护后，社区继续围绕兼容的规则语法和配置结构发展。mihomo 延续了 Clash.Meta 这条技术路线，维护协议、路由与 DNS 等能力。教程中出现的 Clash、Clash Meta 与 mihomo 有历史联系，但不能简单当成同一个软件名：旧教程中的字段、专有功能和平台限制，仍需对照当前内核文档确认。
Clash Verge Rev、FlClash、Clash Nyanpasu 等前端提供订阅管理、托盘菜单、系统代理与服务集成。真正建立连接、解析规则和处理流量的是内核。前端更新不一定意味着协议实现也有变化；反过来，替换内核后界面可能没有变化，字段支持却已经不同。报错时应同时记录客户端名称、操作系统和内核信息，便于定位责任层。
mihomo 仓库以 GPL-3.0 许可发布代码，源文件、提交记录和问题讨论可用于核对功能来源。开源可审阅并不等于任意配置都安全：开放监听地址、开启局域网访问或暴露控制接口，仍需要使用者检查访问范围。规则与订阅也是输入数据，来源不明时不要直接覆盖长期使用的配置，更不要向他人提供控制接口凭据。
程序更新修复界面或内核问题，订阅更新同步节点与规则，GeoIP、GeoSite 数据更新则影响地理分流结果，三者不是同一个按钮。更新前保留可工作的配置，更新后检查启动日志和关键站点的命中结果。若只是订阅返回错误，反复重装客户端通常不会解决问题；若是字段不兼容，则应检查运行内核是否支持该配置。
FIELD NOTES / 最新排障笔记
快速教程负责建立第一次连接，下面的笔记处理连接之后的细节。阅读时先把自己的现象写成一句可验证的问题，例如“浏览器可访问但终端失败”或“规则正确但域名解析超时”，再按证据缩小范围，比一次复制整份配置更可靠。
从订阅是否过期、节点连通性、系统代理端口、TUN 权限、规则模式到 DNS 污染，按顺序逐项核对，定位无法上网的真实原因。
阅读排查笔记 →逐个字段说明 default-nameserver、nameserver、fallback、fallback-filter 与 TUN 下 dns-hijack 的作用，附可直接套用的配置片段。
阅读配置笔记 →从原版内核、Premium 到 mihomo 的演进脉络，梳理 Verge、FlClash、Nyanpasu 等前端与内核的依赖关系，方便选型时对号入座。
阅读生态笔记 →涉及 DNS 的调整，建议保留修改前后的解析结果，同时记录浏览器是否启用了安全 DNS；涉及规则的调整，保留目标域名和实际命中行。日志要能说明“哪里失败”，而不只是截下一个红色图标。分享前删去账户相关内容，复现步骤越短，问题越容易定位。
查看全部文章 →