Clash Plus
Windows · x64 安装程序
适合从配置导入开始上手。运行安装程序后打开客户端,在配置页添加订阅并选中它,再开启系统代理。第一次连接先保留默认端口,避免与已有代理软件同时运行;需要修改规则时,先保存一份能正常连接的配置。
同一台设备先运行一个代理客户端。完成安装、导入配置、验证连接后,再决定是否启用 TUN 模式。标签可直接分享,重新打开链接仍能回到对应平台。
下列图形客户端提供 x64 安装程序。在“设置 → 系统 → 系统信息”中查看系统类型;ARM 设备先确认系统的应用兼容能力,不要把 x64 客户端与 ARM64 内核混为一谈。
Windows · x64 安装程序
适合从配置导入开始上手。运行安装程序后打开客户端,在配置页添加订阅并选中它,再开启系统代理。第一次连接先保留默认端口,避免与已有代理软件同时运行;需要修改规则时,先保存一份能正常连接的配置。
Windows · x64 安装程序
适合需要管理订阅、规则与网络接管设置的用户。导入订阅后先检查配置是否启用,再到代理页选择策略。若需要 TUN,按界面提示安装服务并授权;不要只打开开关就关闭窗口,应确认内核与服务均已正常启动。
Windows · AMD64 安装程序
适合希望在桌面与手机上使用相近操作习惯的用户。AMD64 在这里指常见的 64 位 x86 架构,也用于支持该架构的 Intel 处理器。安装后添加配置、选择节点,再启动连接;从其他客户端迁移时,单独检查自定义规则是否随订阅导入。
Windows · x64 安装程序
作为另一种桌面配置管理界面,可用于整理订阅和代理策略。不同客户端的设置目录与界面选项并不通用,迁移时通过订阅地址或导出的配置文件重新导入。首次运行如遇端口占用,先退出旧客户端,再检查连接日志中的具体提示。
Windows · 旧环境归档
保留给旧环境复现和配置迁移使用,新安装优先选择上方仍在维护的客户端。旧内核可能无法识别新协议或配置字段。迁移前记录规则、策略组名称和端口,再在新客户端逐项测试;不要将旧程序目录直接覆盖到新客户端目录。
| 检查项 | 选择与操作 |
|---|---|
| 系统类型 | 图形安装包为 x64;在系统信息中确认设备架构。具体最低系统版本以所选客户端发行说明为准。 |
| 安装权限 | 安装目录写入、辅助服务与 TUN 可能触发管理员授权,先确认提示对应当前安装程序。 |
| 安装之后 | 导入订阅并选中配置,先用系统代理验证浏览器。UWP 应用不通时再查回环限制。 |
遇到 UWP 应用无法连接时,不必反复重装客户端。先区分浏览器是否正常、应用是否受回环限制,再参考常见问题处理应用范围的网络限制。
打开“苹果菜单 → 关于本机”。看到“芯片 Apple M…”选择 Apple Silicon;看到“处理器 Intel”选择 Intel。下载 DMG 磁盘映像后打开它,将应用拖入 Applications,再从“应用程序”目录启动。
macOS · DMG 磁盘映像
按芯片选择对应包,拖入 Applications 后再启动,避免一直从磁盘映像内运行。首次打开后添加订阅,等待配置下载完成并选中它。先开启系统代理测试浏览器,再按实际需要设置开机启动或 TUN;辅助服务授权应在客户端提示时完成。
macOS · 当前清单为 x64
适合需要集中查看配置、规则与服务状态的桌面用户。Apple Silicon 入口目前也返回 Intel 包,不能据此判断为原生运行。完成拖拽安装后,先检查配置加载,再检查代理开关;启用 TUN 前确认服务安装成功,避免把授权失败误认为订阅失效。
macOS · 当前清单为 AMD64
可与手机端保持相近的配置操作习惯。当前下载文件标注 AMD64,即 x86 的 64 位架构,而不是 Apple 的 ARM 架构。升级前退出旧进程,拖入应用目录替换,再重新打开;若订阅能更新但浏览器不能连接,检查系统代理是否指向当前客户端的端口。
macOS · 旧环境归档
用于旧配置复现和迁移参考,当前两个入口均指向 x86_64 磁盘映像。新系统、新协议和新配置字段的兼容性需要单独确认。准备迁移时保留原始 YAML 与自定义规则,不要仅复制菜单栏中的选项;新安装优先使用上方仍在维护的客户端。
| 检查项 | 选择与操作 |
|---|---|
| 芯片架构 | Apple M 系列对应 arm64;Intel 对应 x64、AMD64 或 x86_64。下载文件名应与实际需要一致。 |
| 系统版本 | 在“关于本机”查看 macOS 版本,再对照客户端当前发行说明;不同客户端的最低要求可能不同。 |
| 安装位置 | 将应用拖入 Applications,退出磁盘映像内的程序,再从“应用程序”启动。 |
| 辅助服务 | TUN 等功能可能需要授权。保留系统安全机制,按可核实的应用提示处理,不要批量关闭安全设置。 |
升级后若提示应用仍在运行,先从菜单栏退出客户端,并确认后台服务已结束,再替换应用。具体安装过程可查看macOS 安装章节。
多数较新的手机使用 ARM64。旧设备可能需要 ARMv7;不确定时先查看系统信息,或使用提供通用包的客户端。安装完成后首次连接会请求 VPN 授权,这是 Android 用于交由客户端处理网络流量的系统机制。
Android · ARM64 APK
适合 ARM64 手机的首次安装。打开 APK 后,按系统提示为当前下载来源授予安装权限;安装完成后进入客户端添加订阅,再启动连接。先检查 VPN 授权与节点选择,若锁屏后连接中断,再查看系统对后台运行和电池优化的限制。
Android · ARM 与通用包
提供多个架构入口,适合需要明确选择设备架构的用户。导入配置后在配置列表中启用,再启动服务。通用包包含更多架构支持,但仍需满足应用的系统要求;不要把通用包理解为对所有旧系统都兼容。更换配置后检查代理组是否仍选中有效节点。
Android · ARM64 / ARMv7
适合同时使用桌面端与手机端的用户。选择与手机应用环境匹配的架构,安装后重新导入配置,不要直接复制桌面端设置目录。Android 通常只允许一个 VPN 服务处于活动状态;若另一款网络工具正在连接,先停止它,再启动当前客户端。
Android · 通用 APK
作为配置格式不同的备选客户端,安装后需要导入 Surfboard 支持的配置。不要把 Clash YAML 原样当作兼容文件;先向配置提供方确认是否提供对应格式。遇到导入失败时先检查格式,而不是立即判断链接失效,格式转换也应谨慎处理规则与策略组。
| 检查项 | 选择与操作 |
|---|---|
| 设备架构 | ARM64 对应 arm64-v8a;ARMv7 对应 armeabi-v7a。优先按设备信息选择,最低 Android 版本查看客户端说明。 |
| 安装授权 | 仅为实际使用的浏览器或文件管理器授权安装来源,完成安装后可按需要收回授权。 |
| 连接授权 | 首次启动连接时确认系统 VPN 请求,避免与其他 VPN 类工具同时启用。 |
| 后台运行 | 先测试亮屏连接,再测试锁屏;仅在确有断连时调整该应用的后台与电池设置。 |
在 App Store 打开应用详情页,先查看“兼容性”中的系统要求,再安装。首次连接时根据系统提示添加 VPN 配置;安装应用、添加订阅与授权连接是三个独立步骤,需要依次完成。
iOS · App Store
安装后打开配置页,导入服务提供方给出的兼容订阅,再选择配置与节点。第一次连接由 iOS 弹出 VPN 配置授权,确认后回到应用检查连接状态。若同时装有其他网络工具,先停止其他连接,再测试当前配置,避免反复切换导致判断混乱。
| 检查项 | 选择与操作 |
|---|---|
| 系统兼容性 | 以 App Store 详情页显示的最低系统版本与设备兼容信息为准。 |
| 订阅配置 | 确认导入的是应用支持的订阅内容,而不是服务商登录页或账户管理页。 |
| 连接权限 | 按系统提示添加 VPN 配置,连接后返回应用查看当前策略和节点。 |
首次验证时使用一个熟悉的网站,并观察应用中的连接记录。浏览器能打开网页并不必然说明所有流量都经过代理,应结合当前规则与策略判断,避免把规则模式下的直连当成故障。
先区分发行版包格式。Debian、Ubuntu 一类系统通常使用 DEB,Fedora 一类系统通常使用 RPM。下列桌面包均为 AMD64;无桌面环境、其他架构或路由器设备应查看内核区,不要强行安装图形包。
Linux · AMD64 桌面客户端
适合有桌面环境、需要图形配置管理的用户。使用发行版包管理器安装,出现依赖缺失时按包管理器提示处理,不要直接删除依赖项。安装后从应用菜单启动,再导入订阅;桌面系统代理是否被终端工具采用,需要另行确认,不能只靠开关状态判断。
Linux · AMD64 DEB
适合使用 DEB 包管理体系、希望保留跨设备操作习惯的桌面用户。安装前先退出其他客户端,避免代理端口冲突。远程服务器通常没有图形会话,不宜照搬桌面安装过程;需要常驻运行时,单独部署 mihomo 并配置服务管理和日志查看。
| 检查项 | 选择与操作 |
|---|---|
| CPU 架构 | 运行 uname -m 查看,x86_64 对应下列 AMD64 桌面包。 |
| 发行版格式 | 使用 DEB 或 RPM 对应的包管理器,不要只修改扩展名后安装。 |
| 桌面依赖 | 图形客户端依赖桌面运行环境,具体库版本以包管理器和客户端发行说明为准。 |
| 服务权限 | TUN 和路由修改需要相应权限;先确认服务运行身份,再处理网络接管。 |
若系统代理开启后终端仍未走代理,先检查该工具是否读取桌面代理设置或代理环境变量。需要服务化运行时,参考Linux 安装章节,分开处理配置路径、运行权限与开机启动。
面向服务器、路由器与需要自行管理服务的用户。内核负责读取配置、匹配规则和转发流量,不提供图形配置界面。普通桌面和手机用户优先选择上方图形客户端,不必再额外下载一份内核。
| 系统 | 架构 / 格式 | 适用环境 | 下载 |
|---|---|---|---|
| Windows | AMD64 · ZIP | 64 位 x86 命令行环境 | 下载 AMD64 ZIP |
| Windows | ARM64 · ZIP | Windows ARM 设备 | 下载 ARM64 ZIP |
| macOS | Intel · GZ | Intel Mac 命令行环境 | 下载 Intel GZ |
| macOS | Apple Silicon · GZ | Apple M 系列 Mac | 下载 Apple Silicon GZ |
| Linux | AMD64 · DEB | 匹配的 Debian 系包管理环境 | 下载 AMD64 DEB |
| Linux | AMD64 · GZ | x86_64 服务器与命令行环境 | 下载 AMD64 GZ |
| Linux | ARM64 · GZ | 64 位 ARM 服务器或设备 | 下载 ARM64 GZ |
| Linux | ARMv7 · GZ | 匹配的 32 位 ARM 环境 | 下载 ARMv7 GZ |
| Linux | MIPS softfloat · GZ | 匹配的软件浮点 MIPS 路由环境 | 下载 MIPS GZ |
| 检查项 | 部署要求 |
|---|---|
| 可执行文件 | ZIP 先解压,GZ 先解压得到二进制文件;类 Unix 系统还需按实际文件路径授予执行权限。 |
| 配置目录 | 准备兼容的 YAML 配置,确认运行用户有读取配置和写入所需数据目录的权限。 |
| 网络边界 | 明确监听地址与防火墙规则,不要直接向公网开放代理端口或管理接口。 |
| 常驻运行 | 先前台启动检查错误,再交由服务管理器运行;保留启动日志,确认停止服务后路由能恢复。 |
配置语法检查可使用 mihomo -t -f config.yaml,其中命令需要在可找到内核可执行文件的环境中运行。检查通过仅代表配置可解析,不代表节点服务、DNS 与路由已经可用,仍需分别验证。
安装程序完成不等于已经建立连接。按下面的顺序操作,遇到问题时能定位到具体一步,不必从头重装。
Windows 运行安装程序,Mac 将图标拖入 Applications,Android 打开 APK,Linux 使用对应包管理器。安装前退出旧客户端,安装后先确认程序能正常打开。系统提示不兼容时,先核对架构与系统版本,不要连续尝试多个不匹配的包。
订阅是由服务提供方交付的配置来源,不是客户端下载地址。复制订阅链接,在配置页添加并更新,随后明确选中该配置。本地 YAML 文件也需要导入后启用。订阅中含有账户相关信息,排查问题时不要公开完整链接或配置中的凭据。
选中一个可用节点,先使用规则模式与系统代理验证浏览器。规则模式会按条件选择直连或代理,全局模式则将匹配范围交给选定策略处理。遇到特定应用不通时,先看连接记录与规则命中,再决定是否启用 TUN,避免用更多开关掩盖原来的问题。
先确认安装包、架构和配置,再检查连接。以下答案也适用于更换客户端前的准备。
Windows、macOS、Android 与 iOS 从 Clash Plus 开始;Linux 从 Clash Verge Rev 开始。先使用一个客户端完成订阅导入和连接验证,再考虑更换界面。服务器或路由器用户才需要单独下载 mihomo 内核。
打开苹果菜单中的“关于本机”。芯片显示 Apple M 系列时选 arm64;处理器显示 Intel 时选 x64 或 x86_64。当前清单中部分客户端的两个架构入口指向相同的 x64 文件,下载前应检查文件名;Apple Silicon 运行 Intel 应用可能需要 Rosetta。
安装包只提供客户端,不附带订阅服务。打开配置页导入有效订阅或兼容的本地 YAML 文件,选中配置和可用节点,再开启系统代理或所需的网络接管方式。按配置、节点、代理开关的顺序检查,不要同时更改多个设置。
同一客户端升级时先导出配置、记录自定义规则,再退出程序和后台服务,按该版本的升级说明安装。更换不同客户端时不要直接覆盖配置目录。升级后确认配置、代理端口与辅助服务状态,验证正常后再清理旧文件。
首次使用先开启系统代理,验证浏览器能否按规则访问。只有终端、游戏或其他应用不遵守系统代理设置时,再考虑 TUN。TUN 通过虚拟网卡接管流量,通常需要辅助服务或管理员权限;切换后要重新检查 DNS 和网络连通性。
这两个客户端已停止维护,下载入口用于旧环境复现与迁移准备。新安装优先选择仍在维护的客户端。旧版本可能无法识别新的配置字段或协议,迁移时应保留原配置副本,并逐项测试规则与订阅兼容性。
订阅更新失败、UWP 回环或端口占用等问题,可继续查阅常见问题。安装包解决的是程序安装,订阅内容和节点可用性需要向对应服务提供方确认。