开源客户端 · 安装包按平台整理

Clash安装包下载多平台客户端与配置指南

下载Clash 查看教程

从平台安装包开始，按步骤完成订阅导入与规则分流设置。

平台与架构 中文操作说明 开源内核资料
Clash · 设置
运行设置界面示意
系统代理
TUN 模式
允许局域网连接
开机自启
混合端口7890
外部控制127.0.0.1:9090
模式规则全局直连
config.yaml
mixed-port: 7890
mode: rule

rules:
  - GEOSITE,cn,DIRECT
  - GEOIP,CN,DIRECT
  - MATCH,PROXY

按操作系统选择安装包

先确认设备系统，再核对处理器架构。安装包负责安装客户端，订阅配置负责提供代理与规则，两者需要分别准备。

Windows 安装包

适合桌面与笔记本电脑。进入“设置 → 系统 → 系统信息”查看系统类型，区分 x64 与 ARM 设备，再选择对应客户端。下载页先列 Clash Plus，再列其他图形客户端与归档项目。

安装完成后，先打开客户端的配置列表，不要只打开系统代理开关。配置未选中、内核未启动时，系统代理可能指向尚未监听的本地端口。首次验证建议只运行一个代理客户端，减少端口与系统设置相互覆盖。

前往下载

macOS 安装包

先在苹果菜单的“关于本机”中查看芯片信息。Apple Silicon 与 Intel 应分别选择对应架构，磁盘映像打开后，按客户端说明将应用放入“应用程序”目录，再从该目录启动。

系统代理、后台运行与网络扩展可能需要分别授权。若出现系统安全提示，应核对应用来源与提示内容，不要直接关闭整套系统防护。更换客户端前，先退出旧客户端并恢复原有代理设置，避免菜单栏应用仍在后台接管连接。

前往下载

Android 安装包

下载 APK 时应匹配设备支持的处理器架构；不确定时，先查看客户端是否提供通用包。允许安装的权限应授予实际打开安装文件的应用，安装结束后可按需要恢复原设置。

首次连接通常会出现系统 VPN 授权提示。这是客户端建立本地网络接管通道的步骤，不代表设备已经连到某个代理节点。授权后仍需选择有效配置与策略。若锁屏后断开，再检查电池优化、后台运行限制以及其他 VPN 应用是否同时启动。

前往下载

iOS 商店入口

下载页提供 Clash Plus 的 App Store 入口，并展示官网 clashplus.io。先阅读商店中的系统要求，再完成安装；订阅地址应从可信来源取得，并在客户端中单独导入。

允许添加 VPN 配置后，回到客户端检查所选配置与连接状态。系统 VPN 标识只能说明相关通道已建立，不能证明所有应用都采用同一分流策略。验证时先用浏览器访问测试目标，再根据实际需要检查应用连接，不要反复删除系统网络配置。

前往下载

Linux 桌面与内核

桌面环境优先选择图形客户端，服务器或路由器用户再考虑直接运行 Mihomo 内核。Debian 系与 RPM 系发行版应按各自包管理方式安装；AppImage 是常见的便携分发格式示例，具体可用文件以下载页实际入口为准，不代表每个项目都提供全部格式。

安装前记录发行版、架构与桌面环境。桌面代理设置通常只影响遵循该设置的应用，终端工具可能需要独立指定代理。直接运行内核时，还要自行管理配置路径、启动服务、日志与访问权限，不能把图形客户端的操作步骤原样套用到后台服务。

前往下载

新安装可从 Clash Plus 开始；已经有稳定配置的用户，则应先比较内核兼容性、订阅管理方式和系统接管方式。客户端名称相近，不等于配置支持范围完全相同。旧教程中的按钮位置也可能与当前界面不同，应按“配置、代理、设置、日志”这些功能入口定位。

归档客户端用于识别旧环境与迁移场景。遇到配置字段无法识别时，先确认内核是否支持，再考虑调整配置；反复更换安装包通常不能解决订阅内容本身的问题。下载页会将安装入口与维护状态分开展示，便于区分日常使用与历史兼容需求。

查看全部客户端 →

Clash 设置与配置位置

下方为静态设置示意。切换主题查看操作位置；具体名称以所选客户端为准，不会修改本机网络。

设置 · 系统代理
系统代理开启
混合端口7890
监听地址127.0.0.1
允许局域网连接关闭

让应用使用本地代理

系统代理把操作系统的代理地址指向客户端监听端口，适合遵循系统设置的浏览器与桌面应用。先启动内核并选中配置，再到设置页打开系统代理。浏览器扩展可能覆盖系统选择，终端也可能只读取环境变量，因此浏览器可用不代表终端已接管。与 TUN 相比，这种方式影响范围较容易确认。若修改混合端口，应同步检查系统代理地址，排查时先确认请求是否出现在客户端连接列表中。

示例用于说明字段与位置，不是可直接替换现有订阅的完整配置。实际运行前需确认策略组、规则数据与内核能力相互匹配。

安装后完成这三步

把“安装成功”和“连接可用”分开验证。先建立可恢复的基础设置，再逐项增加接管范围，出现问题时更容易找到变化来源。

  1. 导入并选中订阅配置

    打开“配置”或“Profiles”，选择从链接导入或从本地文件导入。链接需要包含完整路径与参数；导入完成后，点击配置条目使其成为当前配置，再查看代理页是否出现策略组。安装包本身不附带可用的代理服务，订阅内容应由可信来源提供。

    若列表里已有配置却没有策略组，先确认当前选中项，再打开日志查看解析提示。不要把订阅地址直接粘贴到节点服务器地址栏，也不要在公开截图里展示完整订阅链接；其中的访问参数可能与账户关联。

  2. 选择规则模式与可用策略

    第一次使用可先选规则模式，再在需要手动选择的策略组中指定一个可用条目。规则模式决定如何匹配流量，策略组决定匹配后交给哪个出口，两项不是同一个开关。全局模式可用来缩小某些排查范围，但不能替代正确的规则配置。

    测速结果仅反映特定测试条件，不等于所有网站的实际体验。若某个应用异常，记录目标域名、命中规则与报错时间，再检查相关策略组。只有一个目标失败时，应先排查该目标的解析与连接，而不是立即重置整个客户端。

  3. 开启接管并验证连接

    桌面端先打开系统代理，用浏览器访问目标并观察连接列表。终端不生效时，单独检查其代理环境变量。需要接管其他应用，再评估 TUN；移动端则按系统提示允许 VPN 连接，并确认当前配置已启用。

    验证完成后再设置开机自启。开机自启只代表启动应用，不一定同时启用系统代理或 TUN，应分别核对。退出客户端前先关闭接管开关；若退出后仍无法联网，检查系统是否残留指向本地端口的代理设置，再按教程恢复。

查看完整教程 →

开源生态、内核与更新

客户端界面、代理内核与订阅服务是三个不同层次。了解各自负责的部分，比单纯比较软件名称更有助于安装与排查。

查看客户端对比 →

Clash 名称与后续生态

Clash 最初形成了以配置文件、规则和策略组组织代理连接的使用方式。原项目与部分早期图形客户端停止维护后，社区继续围绕相关配置生态开发内核和界面。今天搜索 Clash，常会同时看到历史项目、后续内核和不同平台客户端，不能把它们视为同一个维护主体。

阅读旧教程时，应先确认教程针对的客户端和内核。界面里的相似开关可能采用不同实现，旧项目的配置支持范围也不一定覆盖新字段。对日常使用而言，优先选择仍有维护的客户端，保留原配置副本，再按当前文档迁移，比沿用历史截图更可靠。

Mihomo 与图形客户端的分工

Mihomo 是 Clash 生态中的代理内核，处理配置解析、规则匹配、出站连接和相关网络功能。图形客户端通常负责展示配置列表、策略组、日志与设置，并协调内核启动及系统接管。窗口可以打开，不代表内核已经启动；内核正常运行，也不代表应用流量已经进入代理。

因此排查应分层进行：先看配置是否被接受，再看监听端口是否建立，最后看系统代理或 TUN 是否覆盖目标应用。不同客户端可能采用不同内核构建与默认设置。遇到某项功能缺失时，应核对实际内核能力，而不是只依据客户端名称做判断。

开源资料的查阅方法

开源仓库可用于查阅实现、许可证、发布说明与已知问题。下面的命令只克隆 Mihomo 源代码，适合需要阅读实现或准备构建环境的用户；普通安装不需要先克隆仓库，直接从下载页选择图形客户端即可。仓库中的构建步骤应以项目自己的说明为准。

提交问题前，先用明确关键词检索已有讨论，并准备系统类型、客户端名称、触发步骤和必要日志。公开材料前应移除订阅地址、账户参数与私人服务器信息。社区资料可以帮助解释行为，但不应把某条讨论中的实验参数直接应用到所有设备。

应用、内核与订阅分别更新

客户端更新可能改变界面与系统集成，内核更新可能改变协议或配置字段的处理，订阅更新则主要改变节点、策略与规则来源。三者互不等同。订阅刷新成功，不代表应用已更新；重新安装客户端，也不会自动修复失效的订阅地址或远端服务。

更新前记录正在使用的配置与关键设置，阅读相关变更说明。更新后若出现异常，先判断是启动失败、配置解析失败还是特定连接失败，再缩小范围。旧客户端的迁移建议可查看已停止维护客户端说明；端口、DNS 与超时问题则交给疑难手册逐项处理。

获取 Mihomo 源代码

需要本机已安装 Git；此操作不是客户端安装步骤。

git clone https://github.com/MetaCubeX/mihomo.git

查看 Mihomo 开源仓库 →

配置与故障排查文章

已能完成基础连接后，再按具体症状阅读。每次只改变一个设置，记录修改前后的结果，避免端口、DNS 与路由同时变化而失去判断依据。

故障排查

Clash 端口 7890 被占用：查找占用进程与修改混合端口

客户端启动失败提示端口已被占用时，用 netstat、lsof 等命令找到占用进程，再修改 mixed-port 与外部控制端口并同步系统代理设置。

适合出现 address already in use 或多个代理客户端同时运行的情况。先识别占用进程再决定退出或改端口，不要只结束名称不明的系统进程。端口改好后，还需检查浏览器扩展与终端是否保留旧地址。

安全与证书

开启代理后网页提示证书错误？HTTPS 报错原因与处理办法

梳理系统时间偏差、中间人拦截、节点异常与 DNS 污染等导致证书报错的原因，说明哪些情况与代理有关，以及安全的处理顺序。

出现证书警告时，先停止提交密码或支付信息，核对系统时间、目标域名和证书提示。更换出口后恢复访问只是排查线索，不能据此认定证书可以忽略，也不应通过关闭浏览器证书验证来解决。

进阶配置

GeoIP 与 GeoSite 数据库更新方法及分流规则写法

说明 GeoIP、GeoSite 数据文件的作用与存放位置，手动与自动更新的配置方式，以及 GEOIP、GEOSITE 规则在 config.yaml 中的常用写法。

适合规则能加载但目标分流与预期不同，或日志明确提示规则数据读取失败的情况。先确认正在使用的数据格式和实际路径，再检查更新流程；增加规则前也应确认内核支持相应的规则类型。

查看全部文章 →