开源项目 · 全平台客户端持续更新

Clash入门指南 下载与配置

下载Clash 查看教程

从设备平台与使用方式出发，集中说明 客户端选择、订阅导入 和 系统代理配置。先完成可用的基础连接，再按需要处理 TUN、DNS 与规则细节。

永久免费 代码开源 中文文档 规则分流
CONFIGURATION WORKSPACE

从配置文件到系统接管

Clash 客户端的图形界面主要负责管理配置、切换运行模式和控制系统网络入口。内核按配置文件处理连接，客户端则把常用操作整理成可见设置。下面按实际配置顺序拆解几个容易混淆的部分。

配置文件 Profiles
当前文件 config.yaml
自动更新
覆盖设置
设为活动配置 已启用

配置文件导入与更新

配置文件通常包含代理提供方、策略组、分流规则、端口和 DNS 参数。首次使用时，应先确认订阅链接来源，再通过客户端的配置或订阅页面导入。导入成功只代表文件可以读取，还需要把该文件设为活动配置。更新订阅时，客户端会重新获取远端内容；本地手工修改可能被覆盖，因此长期使用的自定义规则更适合放入覆写或合并配置。遇到订阅更新失败，应依次检查链接是否完整、网络是否可访问、系统时间是否准确，以及远端服务是否返回了有效 YAML 内容。

建议配置顺序

先导入并启用配置文件，再在策略组中选定常用出口，然后打开系统代理验证浏览器访问。只有应用不遵循系统代理时，才继续配置 TUN。DNS 调整应放在基础连接稳定之后，这样出现问题时可以明确区分是订阅内容、代理入口、路由还是解析链路导致。

规则模式与全局模式

规则模式按配置文件逐条决定直连、代理或拒绝，适合日常使用。全局模式会把大多数连接交给当前全局策略，适合短时间排查规则是否漏匹配。直连模式则绕过代理。模式切换不会修复失效的订阅，也不会自动解决系统代理未开启的问题，判断时应把配置状态和入口状态分开检查。

PLATFORM DOWNLOADS

按操作系统选择客户端

不同平台的安装格式、系统权限和代理入口并不相同。下载页按平台列出仍可使用的图形客户端、停止维护的归档客户端和面向服务器的内核文件。首页只提供平台入口，不直接分发安装包。

Windows

适合需要图形界面、系统代理开关和 TUN 接管的桌面用户。安装前先确认系统架构，并避免同时运行多个会修改代理或虚拟网卡的客户端。若 UWP 应用不经过本机代理，还需要单独检查回环限制。

前往下载

macOS

下载时需要区分 Apple Silicon 与 Intel 处理器。首次运行可能涉及应用安全确认、网络扩展或管理员授权。系统代理适合浏览器和常规桌面软件，命令行工具或独立网络应用则可能需要环境变量或 TUN 模式。

前往下载

Android

Android 客户端通常通过系统 VPN 接口接管连接。导入订阅后，需要在系统弹窗中允许创建 VPN 连接。后台运行限制和省电策略可能导致客户端被暂停，长期使用时应根据设备系统设置允许必要的后台活动。

前往下载

iOS

iPhone 与 iPad 通过系统网络扩展建立代理连接。下载入口会指向可用的商店客户端，并说明订阅导入位置。首次连接需要确认系统 VPN 权限；切换配置后，应回到客户端检查策略组是否仍符合当前用途。

前往下载

Linux

桌面环境可以使用图形客户端，服务器、路由器和旁路由更常直接运行 Mihomo 内核。部署前要区分处理器架构、包格式和服务管理方式。透明代理还涉及 TUN 或 TProxy、转发规则、DNS 与开机自启，不宜直接照搬桌面配置。

前往下载

图形客户端与内核的区别

图形客户端提供配置导入、策略切换、日志查看和系统开关，适合个人设备。内核负责读取配置并处理连接，适合熟悉命令行、服务管理和网络路由的用户。两者并非同一安装形态，首次使用通常从图形客户端开始更容易定位问题。

查看全部客户端 →
OPEN SOURCE CONTEXT

开源生态与配置边界

Clash 不是单一平台上的一个固定安装包，而是一套由内核、图形客户端、规则项目和配置工具共同组成的生态。理解这些边界，有助于判断更新来自哪里，也能避免把客户端界面问题和内核配置问题混在一起。

项目历史

早期 Clash 内核建立了基于 YAML 配置、规则匹配和策略组选择的使用方式，随后出现了 Windows、macOS、Android 等平台的图形客户端。部分早期项目已经停止维护，但它们留下的配置结构和操作习惯仍广泛存在。当前使用时不应只根据旧教程中的客户端名称判断可用性，而应同时查看项目维护状态、目标系统支持和所使用的内核分支。

内核与客户端

Mihomo 延续并扩展了 Clash Meta 相关能力，负责解析配置、建立监听端口、处理规则、运行策略组和执行 DNS 逻辑。图形客户端在其外层提供操作界面，不同客户端可能使用不同的更新方式、配置覆写结构和系统集成方案。因此，同一份订阅在不同客户端中的入口名称可能不同，但排查主线仍然一致：确认配置有效、确认内核运行、确认系统流量进入监听入口、确认规则命中预期策略。

规则与订阅生态

订阅通常由服务提供方生成，规则集合则可能来自独立维护的开源项目。客户端只是读取和执行这些内容，不负责修复远端订阅中的格式错误。导入前应确认链接来源和用途，不要把包含个人访问信息的订阅地址公开到日志、截图或代码仓库。需要长期维护自定义规则时，应将个人覆写与远端订阅分开保存，避免每次更新订阅后重复修改。

更新机制

客户端更新、内核更新和订阅更新是三条独立链路。客户端更新改变界面和平台集成；内核更新可能增加配置能力或修复网络处理问题；订阅更新则改变代理提供方、策略组和规则内容。排查更新后出现的异常时，应先确认具体变化发生在哪一层，再查看对应日志和配置差异。稳定使用期间不必同时改动所有层级，分步更新更容易回退和定位。

A

配置可审阅

YAML 文件可以明确写出监听端口、DNS、策略组和规则顺序。修改前保留可工作的副本，每次只调整一类参数，出现错误时更容易判断是哪一段配置导致。

B

日志可定位

连接失败并不等同于节点问题。日志可以帮助区分配置解析失败、DNS 解析异常、规则匹配结果、端口冲突和系统入口未接管。排查应以具体错误信息为起点。

C

组件可替换

订阅、规则集合、内核和图形客户端彼此有边界。某个图形客户端停止维护时，可以迁移到兼容客户端；迁移前应导出个人覆写，并重新检查平台权限与系统代理设置。

TECHNICAL NOTES

近期配置与故障排查笔记

技术笔记围绕首次使用、DNS、端口冲突和平台特有问题展开。文章给出操作位置、命令用途和判断顺序，适合在基础教程之外按具体现象查阅。

入门指南

Clash 新手第一周最常问的十个问题：从订阅导入到系统代理一次讲清

集中回答客户端怎么选、订阅链接如何导入、规则与全局模式有什么区别、系统代理为什么没有生效，以及切换策略后应从哪里验证。每个问题都对应到客户端中的实际设置位置。

阅读全文 →
故障排查

Clash DNS 泄漏怎么查：检测方法与 fake-ip、nameserver 防泄漏配置实操

从浏览器检测和命令行查询开始，确认 DNS 是否绕过客户端，再逐项说明 enhanced-mode、nameserver 与 fallback 的关系。修改过程强调一次只动一个参数，避免解析链路和代理链路同时变化。

阅读全文 →
故障排查

Clash 端口 7890 被占用怎么办：定位冲突进程与修改 mixed-port 的完整步骤

说明如何在 Windows、macOS 与 Linux 中定位监听端口的进程，判断是残留客户端还是其他网络工具，并同步修改客户端监听端口与系统代理设置，避免只改一处后仍然无法连接。

阅读全文 →

需要先完成基本连接时，从入门教程开始；遇到明确错误信息时，优先按错误关键词查找对应笔记。复杂的平台安装、TUN 路由和服务部署集中放在安装大全中。

查看全部文章 →