Windows
优先查看 Clash Plus,也可比较 Clash Verge Rev、FlClash 等图形客户端。先在“设置 → 系统 → 系统信息”确认系统类型;安装后若无法启动,再检查运行环境与安全提示,不要反复覆盖配置目录。
前往下载六个常用设置,先看字段,再看答案。示意内容不会修改本机配置。
订阅地址 · 示例
导入成功却没有代理?
先确认当前配置已启用。
全局模式会不会更快?
模式改变流量走向,不是线路质量。
mixed-port: 7890
allow-lan: false
7890 被占用怎么办?
改端口后同步系统代理。
enhanced-mode: fake-ip
nameserver:
- 223.5.5.5
拿到虚拟地址是出错吗?
fake-ip 返回映射地址属于预期行为。
DOMAIN-SUFFIX,google.com,PROXY
GEOIP,CN,DIRECT
MATCH,PROXY
为何后面的规则不生效?
规则按从上到下首次命中执行。
infoStart initial configuration in progress
infoMixed(http+socks) proxy listening at: 127.0.0.1:7890
监听成功不等于远端连接成功。
继续查阅
按系统选择
安装包先看操作系统,再看处理器架构。桌面图形客户端适合日常操作,独立内核适合服务器与路由器;两者不是同一种安装方式。下载中心列出客户端、系统要求和归档状态,首页只保留平台入口。
优先查看 Clash Plus,也可比较 Clash Verge Rev、FlClash 等图形客户端。先在“设置 → 系统 → 系统信息”确认系统类型;安装后若无法启动,再检查运行环境与安全提示,不要反复覆盖配置目录。
前往下载在“关于本机”确认是 Apple 芯片还是 Intel 处理器,再选对应安装包。首次启动与系统代理授权是两件事;应用能打开,不代表系统流量已经交给代理。需要接管更多应用时,再按文档配置网络扩展或 TUN。
前往下载可从 Clash Plus、Clash Meta for Android 等客户端中选择。导入配置后还需确认系统 VPN 授权;锁屏断连优先检查电池优化和后台限制。同一时间启用其他 VPN 类应用,可能导致当前连接被系统替换。
前往下载通过下载中心进入 Clash Plus 的 App Store 页面,官网为 clashplus.io。导入前先确认订阅格式兼容;添加 VPN 配置时按系统提示授权。若配置内容缺少代理或策略组,仅打开连接开关也无法补齐。
前往下载桌面环境可查看 Clash Verge Rev 与 FlClash,并按发行版选择软件包。纯命令行环境则查看 mihomo 内核区,另行设置配置路径、服务权限与日志输出。不要把桌面应用的安装步骤直接套到路由器系统上。
前往下载常用字段答疑
先分清客户端界面、实际运行的内核和当前配置文件。相同菜单在不同客户端里可能换了名称,但端口、模式、DNS 和规则仍可以回到字段逐项核对。下面的片段用于解释局部设置,不是可直接连接的完整订阅。
先确认订阅确实更新成功,再确认当前配置已被选中。在客户端的“配置”或“订阅”页面添加服务方提供的地址,更新后查看是否出现代理和策略组。地址能在浏览器打开,不代表返回内容就是兼容的 Clash 配置;登录页面、过期提示和纯文本报错都不能直接当作 YAML。若更新失败,先看状态码与日志,不要急着改 DNS。订阅链接通常带有个人访问凭据,截图和提交问题前应遮盖完整链接,公开示例只保留域名与参数名称。
还要区分“配置导入成功”和“线路可用”:前者说明客户端接受了内容,后者需要实际发起连接才能判断。切换配置后,检查策略组是否仍选着预期线路;本地改过的内容也可能在下一次订阅更新时被替换。
查看订阅导入步骤 →日常使用通常先选规则模式,让不同请求按配置分流;临时判断是否为规则问题时,再切全局做对照。全局模式并不会让线路本身更快,而且仍要选择 GLOBAL 对应的代理。直连模式让进入内核的请求按直连路径处理,适合检查本地网络是否正常。三个模式改变的是已进入内核的流量走向,不会自动接管所有应用;没有遵循系统代理的程序,还要单独设置代理或按需使用 TUN,不能只靠切换模式解决。
mode: rule
mode: global
mode: direct
可以改端口,但要先确定占用者是不是旧实例。同一台设备同时启动多个代理客户端,最容易出现监听冲突;结束不需要的实例,往往比随意改配置更清楚。确实需要改端口时,可将 mixed-port 改为未占用的值,然后重载配置,确认日志出现新的监听地址。接着同步系统代理和应用代理端口,否则浏览器仍会访问旧地址。allow-lan 控制是否允许局域网访问,不是解决本机冲突的开关;仅本机使用时保留 false 更便于控制访问范围。
查看端口占用排查 →config.yaml · 本机混合端口示例
mixed-port: 7891
allow-lan: false
mode: rule
先判断是域名解析失败,还是解析后连接失败。检查 dns.enable、当前内核支持的字段,以及应用是否真的使用了这套解析路径。fake-ip 返回映射地址是正常机制,不能只看地址像不像公网 IP 就判断配置错误。nameserver 是解析上游,fallback 也不是“所有请求都备用一次”的简单开关,其参与方式要结合过滤条件与内核行为理解。浏览器自带加密 DNS 还可能绕开预期路径。排查时一次只改一个变量,记录修改前后的日志,比同时替换所有解析服务器更容易找到原因。
下面只是字段结构示例:本地 DNS 监听在回环地址,不能据此认为系统已经自动使用它。是否需要 DNS 劫持、如何与 TUN 配合,应继续核对客户端的接管方式;配置更新后也要留意应用和系统缓存。
查看 DNS 字段与解析路径 →config.yaml · DNS 局部结构
dns:
enable: true
listen: 127.0.0.1:1053
enhanced-mode: fake-ip
nameserver:
- 223.5.5.5
先确认当前确实在规则模式,再从规则列表顶部查起。匹配逻辑是首次命中即停止,前面的宽泛规则可能已经接走请求;MATCH 通常用于兜底,放在过早的位置会让后面的规则失去机会。规则末尾的策略名称必须与配置中的代理或策略组完全一致,PROXY 在这里只是示例名称,并不是任意配置都自带的保留策略。排查时打开连接详情,核对实际请求域名、命中规则和最终出口,而不是只凭网页显示结果猜测。还要注意已有连接可能沿用旧路径,修改后应重新发起请求。
查看规则语法与顺序 →config.yaml · 需先定义名为 PROXY 的策略组
rules:
- DOMAIN-SUFFIX,google.com,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXY
“已连接”通常只说明本地服务或网络接管已启动,不代表远端线路可用。先关闭代理确认本地网络能访问普通网站,再查看启动日志有没有配置解析、端口监听或权限错误。随后打开一个目标页面,检查连接列表是否出现请求:没有记录,优先查系统代理或 TUN;有记录但超时,再查策略组选择、DNS 与远端连接。Clash 节点测速只能反映指定测试地址的响应,延迟低不等于所有网站都通。遇到闪退则先保留错误日志,再处理配置、内核文件和系统运行环境,不要直接清空整个数据目录。
提交问题时建议附上系统类型、客户端名称、内核信息、操作步骤和报错前后几行日志。隐藏订阅凭据与服务器认证信息,但保留字段名及错误原文;只有一张“无法连接”的截图,通常不足以定位故障层级。
按故障现象继续排查 →项目与文档依据
下载前看维护状态,修改前看内核文档。本站整理客户端入口与使用问答,不把不同项目的功能、授权方式和发布节奏混为一谈,也不把社区客户端统一称为同一个官方应用。
Clash 生态中常见的桌面和移动应用,往往在图形界面之外集成代理内核。订阅管理、托盘菜单、系统代理开关属于客户端层面;协议解析、规则匹配和 DNS 处理则主要由内核完成。因此,换一个界面不一定改变线路质量,相同 YAML 在不同内核中也不一定支持完全相同的扩展字段。遇到配置报错,应先确认运行的内核,再查对应文档。
原 Clash 项目停止公开维护后,社区仍有不同方向的后续项目。mihomo 是其中持续发展的内核项目,部分客户端界面和旧教程仍会使用 Clash Meta 等历史名称。名称相近不代表发布主体相同;选择客户端时,应结合系统支持、实际维护情况和所需协议判断。归档应用可以用于旧环境参考,但不应把旧截图中的菜单和新内核参数一一对应。
图形客户端与内置内核可能分别更新,修复界面问题和调整规则行为也不是同一件事。更新前备份本地覆写、规则文件和必要的设置,阅读项目发布说明中的兼容性变化。若更新后出现异常,先用原配置做最小化对照,确认问题来自配置、内核还是网络接管方式。订阅提供方发布的内容与客户端升级同样独立,升级应用不能修复已经失效的订阅地址。
近期配置笔记
需要完整操作过程时,从下面的专题继续阅读。模式问题先看流量走向,后台断连先看系统授权与省电限制,端口冲突先查占用进程;不要把不同层级的故障都归结为节点不可用。
对比规则、全局、直连三种代理模式的流量走向与适用场景,说明为什么日常推荐规则模式,以及临时切换全局时需要注意什么。
阅读模式选择说明 →讲清 Android 端 VpnService 授权弹窗、常驻通知、电池优化白名单与各厂商后台管理设置,解决锁屏后连接自动断开的问题。
阅读后台断连排查 →用系统命令找出占用 7890 等端口的进程,判断该结束进程还是改端口,并说明修改 mixed-port 后系统代理与浏览器设置的同步方法。
阅读端口处理步骤 →