Windows
适合需要托盘管理、系统代理和可视化规则面板的桌面用户。下载页按 Clash Plus、Clash Verge Rev、FlClash 等客户端列出入口,也保留 Clash for Windows 的归档说明。
从旧客户端迁移时,优先备份订阅地址与自定义规则,不要直接复制整个程序目录。若安装后能启动但应用不走代理,先检查系统代理开关、实际端口与应用自己的代理设置,再考虑启用 TUN。
前往下载 Windows 客户端从客户端选型到规则分流,把 config.yaml 常用字段与实际操作放在一起查。
先分清输入、出口和匹配顺序,再改参数。端口负责接收连接,节点负责提供出口,策略组把出口组织起来,规则决定流量交给谁。
这些片段用于理解字段,不应逐段拼接后直接启用。节点名称、策略组名称与规则目标必须对应;不同内核和客户端的扩展能力,也要分别确认。
浏览器或其他应用需要一个本地代理入口,mixed-port 能在同一端口接受 HTTP 与 SOCKS 代理连接。先查看客户端显示的实际监听端口,再填写到应用设置中;端口不是节点服务器的端口。若启动日志提示地址已被占用,先退出另一个代理进程,再决定是否换号。仅在本机使用时保持局域网访问关闭。这里的 rule 表示按规则分流,并不代表系统已经把流量送进内核,系统代理或 TUN 仍需单独设置。
mixed-port: 7890
allow-lan: false
bind-address: "127.0.0.1"
mode: rule
log-level: info
ipv6: false
节点能连上、网站却打不开时,DNS 值得先查。开启内核 DNS 后,fake-ip 可以把域名与后续连接关联,方便按域名规则分流;但前提是应用的解析请求确实进入了这条路径。下面只是字段示例,不包含 TUN 的 DNS 接管设置。不要把多个来源的解析配置直接叠在一起,尤其要检查上游解析器是否依赖尚未建立的代理。遇到局域网设备名称或特殊应用不兼容,再按实际需求设置过滤,而不是一次排除全部域名。
dns:
enable: true
listen: 127.0.0.1:1053
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- 223.5.5.5
- 119.29.29.29
节点是一组连接参数,不是一条能随意替换协议名称的服务器记录。proxies 里的 type 决定后面需要哪些字段;地址、端口、加密方式和认证信息应以服务提供方给出的配置为准。下面使用教学地址与示例密码,不能建立实际代理连接。节点名称应保持唯一,因为策略组会通过名称引用它。udp 只是允许该节点处理相应流量,能否使用还取决于服务器、协议和系统接管方式。更新订阅时,也要留意手动添加的节点是否会被覆盖。
proxies:
- name: "示例节点"
type: ss
server: example.com
port: 443
cipher: aes-128-gcm
password: "your-password"
udp: true
规则通常指向策略组,而不是把某个节点名称写进每条规则。proxy-groups 提供这一层稳定的引用:select 由用户手选,url-test 按测试结果选择,fallback 按顺序寻找可用出口,load-balance 按算法分配连接。测试延迟低不等于下载速度快,也不说明目标业务一定可用。新手先保留一个手选组,确认节点正常,再引入自动策略。下面的节点名称需要与节点列表对应;组间也可以引用,但不能形成相互依赖的循环。
proxy-groups:
- name: PROXY
type: select
proxies:
- "示例节点"
- DIRECT
rules 按顺序匹配,通常命中一条就确定出口,所以具体的域名规则应放在宽泛的地理位置规则之前。DOMAIN-SUFFIX 会匹配域名本身及其子域名;DOMAIN-KEYWORD 的范围更大,容易把无关域名一起包含进来。GEOIP 依赖 IP 地理数据,并不能准确代表网站的业务归属。最后用 MATCH 接住剩余连接。修改后先看连接面板里的命中规则,再判断是否需要调整顺序;频繁切换全局模式会掩盖分流配置本身的问题。
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- DOMAIN-KEYWORD,example,DIRECT
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- GEOIP,CN,DIRECT
- MATCH,PROXY
直接编辑订阅下载的文件,往往会在下次更新后丢失修改。客户端提供的覆写、合并或脚本功能,可以把本地规则单独保存,再生成供内核读取的最终配置。prepend-rules 和 append-proxies 属于客户端合并约定,不是所有内核都能直接识别的通用字段。下面仅演示支持这些键的合并器结构,使用前应核对客户端文档。前置规则优先级更高;追加节点并不等于自动加入策略组。判断是否生效,要查看合并后的运行配置,而不只看编辑器里的源文件。
prepend-rules:
- DOMAIN-SUFFIX,example.com,DIRECT
append-proxies:
- name: "本地示例"
type: ss
server: example.com
port: 443
cipher: aes-128-gcm
password: "your-password"
先选操作系统,再确认处理器架构。图形客户端负责导入订阅、管理配置和控制内核;只有命令行内核时,还需要自行安排配置路径、启动参数和系统服务。日常桌面与手机使用,通常从图形客户端开始更容易定位问题。
适合需要托盘管理、系统代理和可视化规则面板的桌面用户。下载页按 Clash Plus、Clash Verge Rev、FlClash 等客户端列出入口,也保留 Clash for Windows 的归档说明。
从旧客户端迁移时,优先备份订阅地址与自定义规则,不要直接复制整个程序目录。若安装后能启动但应用不走代理,先检查系统代理开关、实际端口与应用自己的代理设置,再考虑启用 TUN。
前往下载 Windows 客户端先在“关于本机”中确认是 Apple Silicon 还是 Intel,再选对应安装包。Clash Plus、Clash Verge Rev 与 FlClash 提供不同的界面和配置管理方式,具体系统要求以下载页说明为准。
系统代理与终端环境变量是两条不同的路径。浏览器连接正常,不代表命令行工具也已经使用代理;终端访问异常时,应核对该工具支持的代理参数。安装辅助服务涉及权限,按客户端提示逐项处理即可。
前往下载 macOS 客户端手机用户可从 Clash Plus、Clash Meta for Android、FlClash 与 Surfboard 中选择。注意客户端支持的订阅格式并不完全相同,文件能下载成功,只说明获取完成,不说明其中所有字段都能被识别。
首次启动连接时需要确认系统的 VPN 授权。若锁屏后连接中断,先检查系统电池管理和后台运行限制;同时运行另一个使用 VPN 通道的应用,也可能产生冲突。按应用分流时,记得核对被选应用属于包含还是排除列表。
前往下载 Android 客户端下载页提供 Clash Plus 的 App Store 入口,并列出官网 clashplus.io。安装后按界面提示导入支持的配置,确认策略组中存在可选节点,再允许系统添加 VPN 配置。
切换无线网络和蜂窝网络后,解析环境与可用出口可能变化。遇到网页停留在加载状态,先区分是订阅无法刷新、节点连接失败,还是某个域名的规则不合适。不要把桌面客户端的扩展脚本默认视为手机端也能直接运行。
前往下载 iOS 客户端桌面环境优先查看 Clash Verge Rev 与 FlClash,服务器或路由器用户再考虑 mihomo 内核。软件包格式、处理器架构和发行版运行环境需要一起确认,不能只看文件名里是否有 Linux。
命令行工具通常需要单独设置代理环境变量;系统服务也不会自动继承当前终端的设置。启用透明接管前,先用本地代理端口验证基本连接,再检查路由、DNS 与防火墙,避免把多层网络变化混在一次修改里。
前往下载 Linux 客户端安装包解决的是运行环境,订阅解决的是连接参数。本站整理客户端与配置知识;安装软件后,仍需自行准备有效且获授权的节点或订阅。不要在公开截图、问题反馈和共享配置里暴露订阅地址或认证信息。
查看全部客户端 →这三个名字经常一起出现,但不是同一个东西。选客户端看操作体验,查字段看内核文档,排故障看实际运行配置。把层次分开,许多“换软件就好了”的问题才能找到具体原因。
查看 mihomo 开源仓库 ↗Clash 以规则驱动的代理内核和 YAML 配置形成了广泛使用的工作方式。原 Clash 项目及部分早期图形客户端停止维护后,社区沿着不同方向继续发展:有的专注界面和订阅管理,有的继续扩展内核协议与规则能力。因此,“Clash 配置”更像一个生态中的常用说法,而不是保证所有软件都支持同一组字段的兼容承诺。
Clash for Windows 停更后,替代方案应按正在维护的客户端、系统支持与配置迁移成本选择,而不是只按界面是否熟悉来判断。旧教程里的菜单位置、辅助服务安装方式和字段默认值,可能已不适用于当前客户端。保留旧配置作为参考是有用的,但重新导入后仍要检查解析结果、策略组引用与系统接管方式。
图形客户端通常负责订阅下载、配置切换、托盘操作和日志展示;mihomo 等内核负责解释配置、匹配规则、解析域名及建立连接。界面上看得到某个开关,不代表配置文件里一定存在同名字段;反过来,内核支持的扩展参数,也不一定能在每个客户端界面中直接编辑。查阅时应同时确认客户端名称和内核类型。
mihomo 在 Clash 生态的配置方式上继续扩展,项目采用 GPL-3.0 许可,源码、变更与问题讨论可以在仓库查阅。这个许可描述的是相应开源项目,不应被直接套用到所有第三方界面、商店应用或配套服务上。本站以社区资料整理为定位,客户端发行、商店信息和功能边界仍由各自项目决定。
客户端更新、内核更新和订阅刷新是三件不同的事。更新客户端可能改变界面与系统集成,更新内核可能影响字段解析和连接行为,刷新订阅则主要改变节点与规则来源。遇到异常时,先记录最近改变的是哪一层,避免把订阅错误归因于安装包,也避免为了一个失效节点反复重装软件。
比较稳妥的做法是保留当前可用配置,一次只改一类设置,重新加载后查看日志是否报错,再验证目标应用的实际请求。测试节点时固定测试条件,连接失败时记录时间、目标域名和命中规则。分享日志前移除服务器认证信息与订阅参数;可复现的步骤通常比一张只有红色报错的截图更有帮助。
源码查阅 · 需要本机已安装 Git
git clone https://github.com/MetaCubeX/mihomo.git
克隆用于阅读源码与文档,不会自动安装客户端,也不会提供可用节点。只想日常使用时,选择下载页里的图形客户端即可。
先判断问题发生在获取配置、解析配置,还是建立连接的阶段。文章按具体场景展开,不要求先读完全部字段文档;带着报错和实际配置去查,通常更容易找到下一步。
介绍各平台客户端的订阅导入入口,对比完整 YAML 配置、Base64 节点列表与单节点链接。先确认内容格式,再决定直接导入还是使用适配工具,避免把格式不兼容误判成链接失效。
阅读文章 →按网络、证书、链接过期和格式兼容性梳理刷新失败原因,再说明自动更新间隔与经代理更新的适用条件。已经导入的配置能连接,并不表示订阅服务器此时也能访问。
阅读文章 →从日志级别和每行结构讲起,拆解连接超时、DNS 解析失败与规则未按预期匹配的定位方法。先找到与目标请求对应的记录,再回溯端口、节点和规则,减少无关调整。
阅读文章 →