开源内核 mihomo · 桌面与移动端客户端

Clash 客户端下载与配置文档

下载Clash 查看教程

按设备选择 Clash 客户端，从订阅导入开始，再设置规则分流与TUN 模式。基础连接和进阶配置分开查阅。

永久免费代码开源中文文档
先选平台，再选客户端

Clash 下载平台与安装选择

桌面端优先选择仍在维护的图形客户端。移动端先确认系统权限和订阅格式。下载页列出各平台的客户端、架构与安装要求，这里只保留选择入口，不把不同系统的安装包混在一起。

Windows

日常桌面使用可从 Clash Plus、Clash Verge Rev 开始选择。安装前查看“设置 → 系统 → 系统信息”中的系统类型，再对照下载页要求。首次运行先导入订阅并启用系统代理；只有部分应用不遵循系统代理时，再考虑 TUN 模式，避免一开始同时改动权限、路由和 DNS。

前往下载

macOS

先在“关于本机”确认芯片：Apple 芯片与 Intel 处理器使用的安装包不同。完成安装后，按系统提示授权网络相关功能。更换客户端时先退出旧程序并关闭其系统代理，再启动新程序；两套客户端同时修改代理设置，容易出现浏览器可用、其他应用连接异常的情况。

前往下载

Android

多数近期设备使用 ARM64，旧设备仍需核对处理器架构。Clash Plus、Clash Meta for Android 和 FlClash 的设置入口各有差异，但都应先完成订阅导入。连接时允许系统 VPN 请求；如果锁屏后断开，先查电池优化和后台限制，不要把所有后台问题都归因于订阅失效。

前往下载

iOS

下载页提供 Clash Plus 的 App Store 入口及官网 clashplus.io。安装后添加已有订阅，首次连接时按系统提示允许添加 VPN 配置。系统状态栏出现 VPN 标记只说明网络扩展已运行，还需要检查策略选择和实际网页访问；其他 VPN 应用也可能与当前连接相互影响。

前往下载

Linux

桌面环境可选择 Clash Verge Rev 或 FlClash，再按发行版选择软件包。服务器与路由器用户可查看下载页的 mihomo 内核区。图形客户端和命令行内核不是同一种安装方式；桌面代理变量、浏览器代理与 TUN 路由也分别生效，安装成功后仍需确认应用实际使用的网络入口。

前往下载
查看全部客户端 →

已有客户端但无法上网？先记录客户端名称、运行模式与日志错误，再查帮助中心，避免反复重装。

规则、DNS 与连接设置

按需要查一个设置项。以下 YAML 都是功能片段，不是可单独运行的完整配置；出现的 PROXY 策略名需要在实际配置中定义。不同客户端的菜单名称可能不同，最终以生效配置和内核日志为准。

规则分流：按顺序匹配目标

规则模式从上往下匹配，第一条命中后就交给对应策略处理。域名规则适合指定网站，IP 规则适合明确网段，MATCH 放在末尾作为兜底。需要让某个网站直连时，先查看连接记录里的实际域名和命中规则，再把更具体的规则放到通用规则之前。它与全局模式的区别在于每条连接可以走不同策略，而不是把所有流量都交给一个组。长期使用的修改应放进本地覆写，避免订阅更新后丢失。

config.yaml · 规则片段
mode: rule
rules:
  - DOMAIN-SUFFIX,github.com,PROXY
  - GEOIP,CN,DIRECT
  - MATCH,PROXY
规则集与匹配顺序 →
内核 / 客户端 / 配置

mihomo 内核与 Clash 客户端的关系

先分清负责转发流量的内核、负责操作的图形界面，以及提供连接信息的订阅。三者分别维护，更新节奏也不同。本站整理下载入口与配置文档，不提供代理订阅，也不代表各客户端的开发团队。

项目沿革与维护范围

Clash 最初以规则驱动的代理内核为基础形成生态，图形客户端在其上提供配置选择、系统代理和连接查看等操作。原始项目及部分早期桌面客户端停止维护后，社区继续发展不同分支。mihomo 延续了 Clash Meta 的开发方向，提供规则、DNS、TUN 与多种代理协议支持。名称相近不意味着它们是同一个软件，也不意味着某个旧教程里的按钮还能在当前客户端找到。

查资料时，先记录使用的是哪个图形客户端、它内置的是什么内核，再对照相应文档。只有界面名称相同还不够：有的客户端会自行生成配置，有的会合并覆写文件，有的会限制可编辑字段。把别的客户端的完整配置直接覆盖过来，可能绕过原有的订阅管理，也可能覆盖管理接口与监听设置。迁移之前保留旧配置和本地修改，确认新程序能够启动后再逐项搬家。

图形界面负责操作，内核负责连接

Clash 客户端通常负责托盘菜单、开机自启、系统代理、订阅下载与配置编辑；真正处理连接、解析域名和执行匹配的是内核。界面显示“运行中”，只表明进程处于运行状态，不代表订阅有效或所有目标都能访问。排查时应把问题拆开：客户端能否启动、配置能否加载、节点能否建立连接、规则是否命中预期策略、域名是否解析成功。

系统代理和 TUN 也处在不同层次。系统代理告诉愿意遵循这项设置的应用去连接本地端口，部分命令行工具需要单独配置代理环境变量。TUN 则通过虚拟接口与路由接管更多流量，但对权限和网络环境更敏感。浏览器能打开网页而某个程序不能，并不能直接推导出节点失效。先看该程序有没有出现在连接列表，再决定检查代理入口还是策略规则，会比同时打开所有开关更容易定位。

订阅提供配置，客户端不生成服务

安装完成后仍需要已有的订阅或自建连接信息。订阅可能包含节点、策略组、规则与 DNS，也可能只包含代理列表。导入时出现格式错误，应先核对返回内容是否为 Clash YAML；浏览器打开链接看到登录页或错误页面时，客户端自然也无法把它当作配置读取。订阅返回空列表、认证失败或超时，通常需要检查服务状态、链接有效性和下载路径，而不是修改本地代理端口。

订阅链接里的令牌应按凭据对待。分享截图时遮盖完整地址，导出配置前删除账户相关内容，公开求助时只保留必要的错误与脱敏片段。第三方订阅转换涉及把原始链接交给另一方处理，使用前先理解数据流向。订阅更新也不等于本地设置更新：客户端可能重新生成规则，所以个人分流需求应写进受支持的覆写机制，并在更新后检查实际生效内容。

开源记录用于查证，不代替运行验证

mihomo 采用 GPL-3.0 许可证，源代码与开发记录可在仓库中查阅。具体图形客户端有各自的项目、许可证和发布说明，应分别查看。开源的实际价值在于实现和变更能够被审阅，遇到兼容问题时可以定位相关讨论；它不保证某个网络环境、某条订阅或某种组合配置一定可用。本站不使用未经证实的下载量、评分或测速数字替代这些可核对的资料。

准备报告问题时，提供操作系统、客户端名称、相关设置和能够重复的步骤。日志只截取出错前后的必要部分，并遮盖订阅、密钥与个人访问目标。像“address already in use”指向监听端口冲突，“connection refused”说明目标端口拒绝连接，而解析失败需要继续检查 DNS 路径。保留真实错误原文比只写“无法上网”更有用，也方便区分客户端问题、配置问题与服务端问题。

更新顺序与可回退配置

客户端、内核、订阅和地理数据库是不同的更新对象。更新客户端可能改变界面和服务组件；更新内核可能影响协议与字段；订阅更新影响连接信息和规则；GeoIP 数据更新影响依赖地域数据的匹配结果。一次只改动一类对象，并记录修改前的状态。出现异常时恢复最近一次改动，通常比重置全部设置更容易找出原因。

首次配置建议先用规则模式完成浏览器访问，再验证其他应用，最后考虑 TUN、局域网共享与外部面板。验证时不仅看目标网页能否打开，还要看连接列表中的域名、命中规则与最终策略是否符合预期。连接成功但策略不对，同样需要调整。自定义配置先保存在独立文件中，修改 YAML 时使用空格缩进，避免同名顶层字段被重复定义；提交给客户端后检查日志，确认加载成功再继续下一步。

文档入口与排查顺序

第一次使用从订阅导入步骤开始，按导入、选择配置、切换规则模式和启用代理的顺序完成连接。已经能用但需要调整网站去向，转到进阶配置查策略组、规则集与覆写。遇到某个术语不熟悉，可先查术语表，不要只凭字段名字猜用途。这样可以保留一条清晰的配置主线，减少复制零散片段造成的相互覆盖。

如果开启后完全无法访问，先退出其他代理工具，确认普通网络可用，再依次检查订阅有效性、当前配置、策略组选择和 DNS 日志。只有个别网站异常时，优先看该连接的规则和目标，而不是立即重装。关闭客户端后仍不能访问，则检查系统代理是否残留以及原有网络设置是否恢复。更多按现象分类的答案放在帮助中心，这里保留操作顺序，不把所有故障混成一组开关建议。

配置知识与故障排查文章

订阅格式、证书错误和手机后台运行，分别涉及不同层次的设置。按具体症状阅读，先理解问题发生在哪一层，再修改对应选项。以下为最近发布的三篇文章。

查看全部文章 →