开源生态 · 全平台配置手册

Clash中文指南
客户端与配置教程

集中整理 全平台客户端订阅导入步骤mihomo 配置说明。从安装包选择开始,逐项完成代理模式、规则、DNS、系统代理和 TUN 设置。

  • 永久免费
  • 代码开源
  • 中文文档
  • mihomo 内核
PLATFORMS 05 CORE mihomo LICENSE GPL-3.0 CONFIG YAML MODES rule / global / direct

CONFIGURATION BROWSER

规则、订阅与系统接管

Clash 的主要功能集中在配置加载、流量识别和代理策略执行。下面按真实配置结构拆开说明,便于判断该先处理订阅、规则,还是系统网络接管。

DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
MATCH,PROXY

规则按顺序匹配

规则模式会从上到下检查连接目标。域名后缀规则适合处理明确站点,GEOIP 可按目标地址归类,MATCH 则放在末尾接住前面没有命中的连接。实际配置时应把范围小、意图清晰的规则放在前面,再安排通用规则与最终策略。这样既能减少误匹配,也便于从日志中的规则名称回查配置。修改后先确认语法有效,再重新加载配置,避免旧规则仍在内核中运行。

PLATFORM DOWNLOADS

按操作系统选择客户端

安装包需要与操作系统和处理器架构对应。下载页按平台列出可用客户端、适用场景与系统要求;这里先进入对应平台分组,再比较具体客户端。

Windows

适合需要托盘控制、系统代理、TUN 模式和图形化规则管理的桌面用户。进入下载页后可比较 Clash Plus、Clash Verge Rev、FlClash、Clash Nyanpasu 与归档客户端。安装前确认系统架构,并在首次启用 TUN 时处理权限提示。

前往下载

macOS

适合 Apple Silicon 与 Intel Mac。不同处理器对应不同安装包,不能只按文件名中的 macOS 字样判断。桌面客户端可处理菜单栏控制、系统代理和规则切换;启用网络扩展或 TUN 后,应在系统设置中确认权限已经生效。

前往下载

Android

适合手机、平板与部分 Android 设备。导入订阅后需要授予 VPN 连接权限,并根据系统的后台限制调整运行策略。若切换网络后连接中断,可先检查系统电池优化、常驻通知和 DNS 设置,再判断是否需要更换配置。

前往下载

iOS

iPhone 与 iPad 通过 App Store 安装对应客户端。首次建立连接时需要确认系统 VPN 配置,之后可在客户端中导入订阅、选择策略组并查看连接日志。移动网络与 Wi-Fi 的 DNS 行为可能不同,排查时应分别测试。

前往下载

Linux

适合桌面 Linux、服务器和需要直接运行内核的设备。图形客户端便于管理订阅与策略,mihomo 内核则适合由 systemd、容器或其他管理工具托管。部署前应明确配置目录、监听地址、日志位置和服务账户权限。

前往下载

QUICK START

从安装到规则模式的三步流程

首次配置不需要同时调整全部选项。先让客户端正确加载配置并建立连接,再处理规则、DNS、TUN 与局域网共享,排错路径会更清楚。

  1. 01

    安装客户端并确认内核启动

    从下载页进入对应平台,选择与系统及处理器架构匹配的客户端。安装完成后先打开客户端,观察配置目录、内核状态和日志入口是否可用。Windows 与 macOS 在首次启用系统集成功能时可能请求权限;Android 与 iOS 会出现 VPN 配置确认。此阶段只验证程序能够正常启动,不急于打开 TUN、局域网共享或复杂 DNS 选项。若客户端启动后立即退出,应先检查配置文件语法、端口占用和系统权限。

  2. 02

    导入订阅并检查代理组

    在订阅或配置页面粘贴服务提供方给出的订阅地址,执行下载或更新。导入成功后,应能看到代理组、节点与规则信息。先选择一个可用策略,再查看客户端日志中是否出现配置加载错误。订阅地址与节点内容由服务提供方维护,Clash 客户端负责读取并执行配置;两者需要分开判断。若更新失败,依次检查地址完整性、网络连通性、系统时间与本地缓存,不要反复覆盖仍然有效的基础配置。

  3. 03

    启用规则模式并验证系统代理

    将代理模式设为规则,开启系统代理,然后分别访问直连目标与需要代理策略的目标。规则模式根据连接目标选择策略,不代表所有流量都经过同一路径。若浏览器生效而某个应用不生效,先确认该应用是否读取系统代理;不读取时再评估 TUN 模式。验证完成后再调整 DNS、Fake-IP、健康检查和开机启动。每次只改一类设置,并保留修改前的配置,出现问题时才能准确回退。

系统代理已开启但浏览器没有生效

先确认客户端内核正在运行,再检查系统代理端口是否与配置中的 mixed-port 一致。浏览器若设置了独立代理或扩展,也可能覆盖操作系统配置。完整排查步骤可前往疑难解答

规则模式、全局模式怎么选择

日常使用优先从规则模式开始,让不同目标按规则进入直连或代理策略。全局模式适合短时间验证代理链路,直连模式适合确认问题是否由代理设置引起。模式切换后应重新测试同一目标。

什么时候需要启用 TUN

当目标程序不读取系统代理,或需要处理更广泛的网络流量时,再考虑 TUN。启用前记录原有 DNS 与路由状态;如果出现断网、解析异常或局域网访问问题,先关闭 TUN 并恢复到系统代理进行对照。

订阅更新会不会覆盖自定义规则

取决于客户端的配置组织方式。直接编辑订阅生成的完整配置,更新时可能被替换;使用 proxy-providers、覆写或独立规则文件,可以把远程来源与本地调整分开。修改前应先导出一份可用配置。

OPEN SOURCE CONTEXT

Clash 生态、mihomo 内核与配置兼容

从规则代理核心到多平台客户端

Clash 生态由代理内核、配置格式和不同平台的图形客户端共同组成。内核负责解析配置、建立连接、匹配规则并输出日志;图形客户端负责安装更新、订阅管理、系统代理、权限请求和可视化操作。理解这层分工后,排查问题会更直接:配置解析错误先看内核日志,托盘或菜单异常看客户端界面,系统流量没有进入代理则检查操作系统集成。

不同客户端可以采用相近的内核,但界面能力并不完全一致。有的客户端强调桌面端规则编辑,有的更适合跨平台使用,有的保留归档状态用于旧环境。选择时不必只比较界面,应同时确认当前维护状态、目标平台、处理器架构、配置兼容性以及是否需要 TUN、脚本、覆写等功能。

mihomo 与 Meta 功能路线

mihomo 延续了 Clash Meta 的功能路线,在规则类型、代理协议、DNS 增强模式、TUN 和 provider 等方面提供持续维护。许多现代 Clash 图形客户端把 mihomo 作为核心组件,因此相同的 YAML 配置可以在多个平台之间复用。不过,客户端可能为配置增加自己的覆写文件、数据库或界面字段,迁移时仍应先导出原始配置,再核对目标客户端的支持范围。

协议与内核不是同一个概念。协议决定客户端如何与服务端建立连接,内核负责实现协议并执行本地分流逻辑。选择协议时应关注服务端支持、网络条件、连接建立方式和设备资源;选择内核与客户端时则应关注配置语法、平台集成和维护状态。需要系统比较 SS、VMess、Trojan、VLESS、Hysteria2、TUIC 与内核家族时,可查阅协议手册

配置更新与问题定位

可靠的配置流程应保留三个层次:可恢复的基础配置、可单独更新的订阅来源、可追踪的本地规则调整。更新客户端时先阅读变更说明,再备份配置目录;更新订阅时检查代理组名称是否变化;调整规则时使用明确名称,并从日志确认命中结果。一次同时修改内核、订阅、DNS 和 TUN,会让错误来源难以区分。

日志是连接问题的主要证据。配置加载阶段关注 YAML 语法、字段类型和文件路径;运行阶段关注 DNS 解析、规则命中、连接超时与端口监听;系统集成阶段则检查代理设置、虚拟接口、权限和防火墙。按层次记录现象,比反复切换节点更容易找到根因。技术笔记会持续整理高频报错、移动端后台策略和局域网共享等具体场景。

TECHNICAL NOTES

近期配置与故障排查文章

围绕局域网共享、移动端后台运行和启动故障整理可执行步骤。文章先解释现象与边界,再给出检查顺序,适合在基础配置完成后按问题查阅。