Clash 生态 · 中文配置文档

Clash知识库客户端下载与配置参考

下载Clash 查看教程

按平台选择客户端，从 mihomo 内核、YAML 字段到规则分流逐项查阅。

代码开源配置示例中文文档

配置字段与工作方式

先确认字段归属，再对照配置片段。示例展示结构，不能替代完整订阅。

Clash知识库config.yaml / general

CORE / mihomo

内核负责连接与路由

mihomo 是 Clash 生态中的代理内核，负责读取配置、接收连接、匹配规则与建立出站连接。客户端则提供订阅管理、托盘菜单和系统集成，两者不是同一个层级。原版 Clash、Clash Meta 与 mihomo 有演进关系，但新增字段不一定能被旧内核识别。排查配置问题时，应先确认客户端实际使用的内核，再查字段支持情况。示例中的混合端口可接收 HTTP 与 SOCKS 请求；仅在本机使用时，保持局域网访问关闭。

查阅通用字段 → 
# 顶层通用字段
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
ipv6: false

阅读配置时，可以沿着“入口 → 模式 → 规则 → 策略 → 出站”的顺序定位。端口与 TUN 决定连接怎样进入内核；mode 决定采用哪套处理方式；rules 决定流量交给哪个策略。把这些层次分开，比一次修改多个开关更容易确认原因。

按操作系统选择客户端

先核对平台与处理器架构，再比较界面、接管方式和维护状态。

Windows

从 Clash Plus、Clash Verge Rev、FlClash 等客户端中选择。日常浏览可先启用系统代理；游戏或命令行程序没有读取系统代理时，再评估 TUN 接管。安装前查看系统信息中的处理器类型，更新后确认服务模式仍可用。

前往下载

macOS

Apple Silicon 与 Intel 设备需要对应的安装包，可在“关于本机”查看芯片信息。首次运行按系统提示授权，随后检查菜单栏状态与网络代理设置。更换客户端时先退出旧程序，避免两个应用同时修改系统代理。

前往下载

Android

可比较 Clash Plus、Clash Meta for Android、FlClash 与 Surfboard，注意配置格式与内核能力的差别。首次启动连接时允许 VPN 请求；如果锁屏后中断，检查电池优化、后台活动和自动启动权限，不要反复重装订阅。

前往下载

iOS

下载页提供 Clash Plus 的 App Store 入口，并列出官网 clashplus.io。安装后导入兼容的配置，按系统提示添加 VPN 配置。移动系统对后台网络扩展有独立管理方式，桌面端的服务安装步骤不适用于手机。

前往下载

Linux

桌面环境可选择 Clash Verge Rev 或 FlClash，并按发行版选择软件包格式。服务器、路由器用户可查阅 mihomo 内核入口，自行管理启动服务、配置目录与权限。桌面代理设置不一定会传递给终端内的每个进程。

前往下载

安装包、订阅与客户端的区别

安装包提供运行程序，订阅提供代理配置，两者不能互相替代。完成安装后，还需要导入来自可信来源且与客户端兼容的配置。知识库提供软件入口与字段说明，不提供代理服务；下载客户端并不会自动生成可用出口。订阅链接通常关联账户权限，分享截图或日志前应遮盖完整地址。

Clash for Windows 已停止维护，适合识别旧教程或迁移现有设置，不宜只因名称熟悉就作为新设备的默认选择。迁移时保留订阅地址与自定义规则，再检查新客户端生成的配置。是否支持某项协议，取决于实际内核与客户端集成，而不是应用名称中是否含有 Clash。

查看全部客户端 →

Clash 使用教程：三步预览

先完成一条可验证的连接，再增加分流、覆写或 TUN 设置。

01 / PROFILE

导入订阅或本地配置

在客户端的配置管理页面添加订阅地址，或导入本地 YAML 文件。等待下载和解析完成后，将该配置设为当前使用项。若提示解析错误，先查看具体行号，区分网络请求失败与 YAML 结构错误；两者的处理方式不同。

订阅内容可能包含节点、策略组与规则，也可能只是节点集合。导入成功不等于结构一定完整。先确认界面中有可选择的策略，再继续开启连接；不要将 Base64 文本直接当作完整 YAML 保存。

02 / MODE

选择模式与流量入口

日常使用优先从规则模式开始，在对应策略组中选择可用出口，然后启用系统代理或移动端 VPN 连接。全局模式把进入内核的流量交给全局策略，直连模式则用于直接连接；它们不是速度档位。

系统代理与 TUN 是入口设置，规则与全局是处理模式。浏览器正常而其他程序没有连接时，先确认程序是否遵循系统代理，再判断是否需要 TUN。每次只改一个条件，并记录修改前的状态。

03 / VERIFY

检查连接与命中规则

打开一个明确需要代理的目标，回到连接页面检查目标域名、命中规则、策略组和实际出口。仅看到 VPN 图标或托盘图标变色，不能证明每个程序都已走预期路径；应以对应连接记录为依据。

若没有记录，优先检查流量入口；若命中了错误策略，检查规则顺序；若策略正确但连接失败，再检查出口与 DNS。验证完成后保存可用配置，后续更新出现问题时便能逐项对照，而不是同时重置所有设置。

常见的第一轮检查

浏览器能访问而终端不能访问，通常应先检查终端程序的代理设置；订阅能更新而网页不能打开，则要继续检查出口选择与目标连接。客户端的订阅下载过程、内核出站和浏览器访问可能使用不同网络路径，不能用其中一个成功来推断全部正常。

更改 DNS 后仍出现旧结果，可以先关闭相关连接并重试，必要时按平台清理缓存。若启用了其他 VPN、加速器或虚拟网卡工具，先逐一退出以缩小范围。操作前保留当前设置，测试结束后再决定是否长期保留变更。

查看完整教程 →

开源内核与配置来源

区分客户端、内核与服务提供方，才能判断一条说明适用于哪里。

Clash、Meta 与 mihomo

Clash 生态包含内核、图形客户端、配置工具与规则项目。原版 Clash 为规则代理提供了基础配置结构，Clash Meta 在此基础上扩展功能，后续沿用 mihomo 名称发展。旧教程中的 Meta 与当前文档中的 mihomo 经常存在关联，但不能据此认定所有字段、协议和默认行为完全相同。

查看教程时，先辨认它描述的是哪一个内核，再确认客户端是否允许直接设置对应字段。图形界面可能替用户生成端口、DNS 或 TUN 设置，也可能在启动前合并本地覆写。排查时应尽量查看最终运行配置，而不仅是订阅源文件；二者之间的差异往往就是行为变化的来源。

公开代码与许可证边界

mihomo 的源代码公开，内核采用 GPL-3.0 许可证。公开仓库可用于查看实现、阅读变更和定位问题，许可证则规定代码使用与分发条件。图形客户端是独立项目，可能采用不同许可证；内核的许可信息不能直接当作所有客户端的许可声明，更不能据此判断订阅服务的可用性。

开源仓库中的问题记录适合核对已知行为，但单个讨论不等于所有设备都会遇到同样的问题。提交问题时，应附上操作系统、客户端名称、内核信息、复现步骤与经过脱敏的日志。不要公开订阅完整地址、账户凭据或带有私人网络信息的配置文件。

更新客户端与更新订阅是两件事

客户端更新可能改变内核能力、界面入口和系统集成；订阅更新通常改变远程配置内容。遇到更新后异常，先确认发生变化的是哪一层。保留更新前可用的配置，查看客户端发布说明，再比较生成后的规则与 DNS 设置。不要仅通过文件名判断内核是否已被同步更新。

本知识库的配置片段用于解释字段与语法，不包含可直接连接的代理出口。复制示例前应阅读注释，检查策略名称是否已定义，以及对应功能是否受当前平台支持。YAML 使用空格表达层级，列表前的短横线、逗号和字符串引号都有实际含义；把多个片段直接拼接，可能产生重复键或缺失依赖。

文档查阅顺序

首次使用从使用指南完成导入与验证；需要选客户端时查看选型指南；已有明确字段名时进入配置参考。内核原理与场景分析放在专题文章中。按当前问题选择资料，比一次开启全部功能更有利于判断设置是否生效。

近期配置文章

围绕代理模式、流量接管与移动端系统权限，补充配置背后的工作机制。

查看全部文章 →
Clash下载