客户端下载 · 配置参考

Clash工具箱全平台客户端与配置教程

按系统选择客户端，查阅订阅导入、规则分流与TUN 模式的设置路径。

开源内核
中文文档
YAML 配置

5 个平台
mihomo · GPL-3.0
YAML 单文件配置

+ : # = - + : # = - + : # = - +
: DOMAIN-SUFFIX : + = # : - + :
# = - + : # = - + : # = - + : #
+ : DIRECT = + : # = - + : # =
- # + : = - # + : = - # + : =
MATCH : + = # : - + : DIRECT
: + = - # : + = - # : + = - #
# REJECT + : = - # + : = - #
+ : # = - + : # = - + : # = -
: DOMAIN-SUFFIX : + = # : - +
# = - + : # = - + : # = - + :
+ : DIRECT = + : # = - + : # =
- # + : = - # + : = - # + : =
MATCH : + = # : - + : DIRECT
: + = - # : + = - # : + = - #

+ : # = - + : # = - + : # = - +
: + = # : MATCH : - + : # = - :
# = - + : # = - + : # = - + : #
+ : DIRECT = + : # = - + : # =
- # + : = - # + : = - # + : =
DOMAIN-SUFFIX : + = # : - + :
: + = - # : + = - # : + = - #
# REJECT + : = - # + : = - #
+ : # = - + : # = - + : # = -
: + = # : MATCH : - + : # = - :
# = - + : # = - + : # = - + :
+ : DIRECT = + : # = - + : # =
- # + : = - # + : = - # + : =
DOMAIN-SUFFIX : + = # : - + :
: + = - # : + = - # : + = - #

Clash · 设置 CONFIGURATION

Clash

代理

配置

规则

连接

日志

设置

设置GENERAL

系统代理

应用遵循系统代理设置

开启

TUN 模式

虚拟网卡接管

开启

允许局域网连接

Allow LAN

出站模式

规则全局直连

混合端口

7890 TCP

外部控制

127.0.0.1:9090

config.yamlREAD ONLY

1mixed-port: 7890

2allow-lan: false

3mode: rule

4external-controller:

5 127.0.0.1:9090

6tun:

7 enable: true

8rules:

9 - DOMAIN-SUFFIX,example.com,DIRECT

10 - GEOIP,CN,DIRECT

11 - MATCH,DIRECT

配置参考 / Configuration

规则、流量接管与配置管理

客户端界面负责操作，内核负责处理连接。先确认流量是否进入客户端，再判断命中了哪条规则。两层分开检查，比反复更换模式更容易定位问题。

首次使用时，配置文件是起点。安装客户端并不等于已经具备代理出站，订阅地址通常需要另行准备。导入后先查看配置是否被选中、策略组是否存在，再按应用的实际需要开启系统代理或 TUN。下面的配置片段用于解释字段关系，不包含代理服务器，也不能代替可用的订阅。

rules · 从上到下匹配

按目标选择出站

规则模式按照配置中的顺序匹配连接，先命中的规则决定出站。域名后缀、目标地址与兜底规则各有用途，具体规则应放在宽泛规则之前。在客户端的「代理」或「设置」中选择规则模式，再到「连接」查看命中结果。与全局模式相比，规则模式保留直连与代理并存的路径，不必让每个请求经过同一出站。示例全部使用直连，仅展示语法；替换策略名称前，必须确认配置里存在对应策略组。

适用：支持 Clash 规则语法的桌面与移动客户端。

# 具体域名规则在前，兜底规则在后
mode: rule

rules:
  - DOMAIN-SUFFIX,example.com,DIRECT
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - GEOIP,CN,DIRECT
  - MATCH,DIRECT

# DIRECT：直连
# REJECT：拒绝连接
# 使用 GEOIP 前需具备对应地理数据

tun · 虚拟网卡

接管不遵循系统代理的流量

TUN 模式通过虚拟网卡和路由设置接管流量，适合不读取系统代理的应用。桌面端通常需要安装服务或授予管理员权限，再在「设置」中启用 TUN；移动端一般通过系统 VPN 授权建立接管。它与规则模式不是二选一：前者决定流量如何进入内核，后者决定进入之后如何出站。已有其他 VPN、虚拟网卡或企业网络策略时，应先记录原有设置。出现异常先检查路由与 DNS，不能只看开关是否处于开启状态。

适用：具备 TUN 支持及相应权限的客户端，字段以实际内核为准。

# mihomo TUN 配置片段
tun:
  enable: true
  stack: mixed
  auto-route: true
  auto-detect-interface: true
  dns-hijack:
    - any:53

# DNS 劫持还需要配合内核 DNS 配置
# 启用前检查其他 VPN 与虚拟网卡
# 客户端可能通过界面覆盖这些字段

profiles · 订阅与提供者

区分整份配置与代理提供者

整份订阅配置可以同时包含代理、策略组和规则；代理提供者只向现有配置提供代理条目。首次导入通常从「配置」中新建远程订阅，保存后选中该配置，再检查更新是否成功。定期更新会重新获取远程内容，直接修改下载后的文件可能在下次更新时被覆盖，长期调整应使用客户端的覆写或合并功能。右侧采用本地提供者语法，便于理解文件之间的关系；文件路径相对于内核工作目录，不是任意系统目录。

适用：远程配置管理取决于客户端；提供者片段适用于 mihomo。

# 本地文件需要包含 proxies 列表
proxy-providers:
  local:
    type: file
    path: ./providers/local.yaml

proxy-groups:
  - name: 手动选择
    type: select
    use:
      - local

# 不在公开截图或日志中暴露订阅地址

core · 配置兼容性

按字段支持选择内核

Clash、Clash Premium 与 mihomo 在配置能力和维护状态上有差异，界面名称相似并不代表支持同一组字段。mihomo 延续了 Clash Meta 的配置体系，许多当前客户端以它处理连接。只有部分客户端提供内核切换，其余会固定集成内核，不能套用同一操作路径。遇到未知字段或协议不支持，应先查看日志、确认客户端使用的内核，再对照配置文档处理。单独替换可执行文件可能与客户端接口不兼容，优先采用产品提供的更新方式。

适用：内核选型与配置迁移；不表示每个客户端均能切换内核。

名称	查阅重点
Clash	原始配置体系与基础规则语法
Clash Premium	历史配置中的专有扩展字段
mihomo	Clash Meta 后续项目，按当前文档检查字段支持

platform · 权限与系统入口

配置可以迁移，权限需要重设

同一份兼容配置可以在多个平台复用，但监听端口、文件路径与系统权限仍需分别检查。桌面系统通常先验证系统代理，再按需要启用 TUN；移动系统则先完成 VPN 授权。迁移时不要直接复制旧设备的绝对路径，也不要假设所有客户端都能读取同一种订阅。先确认目标产品接受的格式，再导入、选择配置并检查策略组。首次连通后再添加开机启动、后台运行等设置，可以把配置问题和系统限制分开定位。

适用：五个平台之间迁移配置，详细安装步骤见全平台指南。

平台	系统检查入口
Windows	设置 → 网络和 Internet → 代理
macOS	系统设置 → 网络 → 当前网络 → 详细信息 → 代理
Android	系统设置中的 VPN 与电池管理
iOS	设置 → 通用 → VPN 与设备管理
Linux	桌面代理设置、服务权限与终端环境变量

下载入口 / Platforms

按系统选择 Clash 客户端

先确定操作系统与处理器架构，再比较界面、配置支持及权限要求。下载中心集中列出安装包与系统要求；本页的平台入口直接打开对应分类。

Windows

从 Clash Plus、Clash Verge Rev、FlClash 等桌面客户端中选择。新安装优先考虑仍在维护的产品，Clash for Windows 仅作为归档参考。已有配置可以迁移，但旧客户端的扩展脚本、服务设置和绝对路径不应直接照搬。

安装后先导入配置并启用系统代理。浏览器能够访问而终端不能访问时，先检查终端环境变量，不必立即重装客户端。需要 TUN 的应用再单独检查服务权限和虚拟网卡。

前往下载 →

macOS

Apple Silicon 与 Intel 机型需要选择相应安装包，可在「关于本机」查看芯片信息。Clash Plus、Clash Verge Rev 与 FlClash 提供桌面操作界面；ClashX Meta 已停止维护，迁移前应保留原配置副本。

首次启动留意系统安全提示与网络权限。系统代理通常作用于当前网络服务，切换有线和无线网络后应再次检查；TUN 则需要客户端对应的服务或权限，不是单纯修改浏览器设置。

前往下载 →

Android

可比较 Clash Plus、Clash Meta for Android、FlClash 和 Surfboard。不同产品接受的配置格式并不完全相同，尤其不要把支持订阅等同于兼容全部 Clash 字段。安装包架构应与设备匹配，不确定时先查看下载页的选择说明。

首次连接需确认系统 VPN 授权。若锁屏后连接中断，检查电池优化与后台运行限制；若同时使用其他 VPN，应先确认系统当前启用的是哪一个服务，再判断配置是否有问题。

前往下载 →

iOS

通过 App Store 获取 Clash Plus，产品说明可查阅 clashplus.io。导入前确认客户端支持的配置格式；链接导入与本地文件导入的入口以产品界面为准，不能仅凭文件扩展名判断内容是否兼容。

保存配置后完成 VPN 权限授权，再选择出站策略并连接。Wi-Fi 与蜂窝网络的访问权限需分别留意；诊断时先确认配置已经选中，再查看连接状态，避免把单个网站的问题判断成整个客户端失效。

前往下载 →

Linux

桌面环境可选择 Clash Verge Rev 或 FlClash；服务器、路由器等场景再考虑直接运行 mihomo 内核。先确认发行版的软件包格式与处理器架构，不要把桌面安装包当作所有设备都能运行的通用文件。

终端程序通常不会自动读取桌面系统代理，需要按程序能力设置代理环境变量，或使用经过权限配置的 TUN。远程维护时先保留可恢复的连接路径，再修改默认路由和 DNS，避免配置中断管理会话。

前往下载 →

查看全部客户端 →查阅全平台安装指南 →

开源参考 / Source

客户端界面与开源内核

Clash 是一个生态名称，不是所有平台共用的单个安装包。查阅文档时应同时确认客户端名称、所用内核和配置来源，避免把某个产品的操作说明当作通用入口。

5 个平台平台入口

覆盖桌面与移动系统。安装形式、系统权限和后台策略各有差异，连接行为需要在对应设备上验证。

GPL-3.0mihomo 许可

mihomo 项目公开源代码与许可文本。该许可描述内核项目，不应据此推断每个客户端或商店产品的授权方式。

YAML单文件配置

代理、策略组和规则可在一份主配置中组织，也可引用外部规则集与提供者。缩进与字段支持同样重要。

项目历史与配置沿用

早期 Clash 客户端建立了以 YAML 描述代理与分流规则的使用方式。原有项目的维护状态发生变化后，社区客户端和后续内核继续演进，旧教程中的按钮名称、下载入口和扩展字段便可能与当前环境不同。迁移时可保留配置的基本组织思路，但应重新核对内核支持，尤其是 DNS、TUN 和外部资源路径。历史配置能够被导入，只说明解析通过，并不代表所有行为都与原环境一致。

界面操作与实际生效配置

客户端通常负责配置下载、策略选择、托盘菜单和系统服务，内核负责监听端口、匹配规则与建立连接。有些界面开关会在启动前生成配置，或在运行期间通过控制接口修改设置，因此编辑订阅文件后，界面显示值与实际值可能暂时不同。排查时优先查看当前选中的配置、运行日志和连接详情，再确认是否启用了覆写。不要同时修改订阅文件、界面端口和系统代理三处设置，否则很难判断哪一处改变影响了结果。

更新机制与配置副本

客户端更新、内核更新、订阅更新和规则资源更新是四个不同动作。更新客户端并不会自动修复过期订阅，重新下载订阅也不会让旧内核获得新字段支持。维护前先保存本地覆写与自定义规则，阅读产品发布说明，再一次只更新一个层次。更新之后用同一应用和同一目标复测，记录差异；若出现回退需求，配置副本比凭记忆恢复开关更可靠。订阅地址可能包含访问凭据，不应粘贴到公开讨论或截图中。

源代码与问题反馈

开源仓库适合查阅字段定义、许可与已知问题，不是直接下载任意客户端安装包的替代入口。mihomo 的仓库记录内核层面的变更；界面按钮失效、安装服务失败等问题应先对应到具体客户端。提交问题时提供系统、架构、复现步骤和脱敏日志，删去订阅地址、代理认证信息与外部控制密钥。若仅能复现某个应用无法联网，应说明系统代理或 TUN 的接管方式，而不是只写连接失败。

mihomo · 源代码访问仓库 ↗

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

该命令用于获取内核源代码，运行前需要安装 Git。

首次连接的检查顺序

先验证当前配置能正常加载，再确认目标应用的流量进入客户端，最后检查规则和出站策略。系统代理开启却看不到连接记录时，应先检查应用是否读取系统代理；能看到记录但目标不可达时，再检查命中规则、域名解析与所选出站。延迟测试只能反映测试目标与测试方法下的结果，不能单独证明网页、终端和其他应用都可以正常访问。按层次收集信息，才能避免把权限、配置与网络问题混在一起。

需要完整操作顺序时，从订阅导入与首次连接教程开始；遇到配置解析或连接问题时，查阅常见问题与排查说明。安装、系统权限与平台特有设置集中在全平台指南，便于按设备逐项核对。

操作记录 / Articles