DEV 00 / WINDOWS
Windows 客户端
适用于 Windows 桌面设备。下载页按 GUI 客户端区分当前维护状态,并提供与常见 x64 设备对应的安装入口。首次安装后先导入配置,再启用系统代理;需要接管更多应用流量时,再检查服务模式与 TUN 权限。
[ Windows 前往下载 ]按设备选择可用客户端,再依次完成订阅导入、策略组选择与系统代理设置。站内集中整理免费客户端、开源内核和中文配置文档,便于安装后继续查询字段与故障现象。
BIOS SETUP / CLIENT FUNCTIONS
从左侧选择功能。右侧说明处理对象、适用场景、操作顺序与容易忽略的配置边界。
PROFILE INPUT / YAML
Clash 客户端通常从订阅地址读取配置,也可以导入本地 YAML 文件。订阅地址提供的是配置获取入口,YAML 文件则保存端口、代理节点、策略组、规则和 DNS 等具体内容。首次使用时,应先把完整地址加入配置管理页,等待客户端完成解析,再将新配置设为当前配置。直接把网页地址当成节点、遗漏链接字符或导入了普通文本,都会导致配置无法识别。
导入成功后不要立刻反复添加同一地址。先检查配置名称、更新时间和代理组是否出现,再进入策略页选择节点。远程配置更新会替换提供方管理的部分内容,本地手工修改可能在下一次更新时被覆盖;需要长期保留的规则更适合写入客户端的覆写、合并或脚本配置。完整操作顺序可在使用指南中继续查看。
POLICY GROUP / PROXY
策略组决定一类连接交给哪个节点或子策略处理。常见类型包括手动选择、自动测速、故障转移与负载分配。客户端主界面显示的可选项不一定都是单个服务器,其中也可能包含另一个策略组。首次连接应先找到承担主要代理流量的选择组,再从组内选定可用节点,避免只在配置列表中切换文件却没有改变实际出口。
延迟测试只能反映测试目标在当时网络环境下的响应,不等同于下载速度、稳定性或所有网站的访问质量。节点地区、线路倍率、协议支持和服务端负载都可能影响结果。更稳妥的判断方式是先测试一组候选节点,再用实际网页或应用验证连接,并观察运行日志中是否出现超时、握手失败或连接被拒绝。节点选择方法可参考站内的节点筛选文章。
RULE ENGINE / MATCH ORDER
规则模式会从配置中的规则列表顶部开始检查请求,命中第一条符合条件的规则后停止继续匹配。常见规则类型包括域名、域名后缀、关键词、IP 地址段、进程名和最终匹配项。顺序直接影响结果:范围过宽的规则放在前面,可能提前截获本应由后续规则处理的连接;最终规则缺失或目标策略组名称不一致,则可能造成流量行为与预期不同。
添加自定义规则时,先明确匹配对象,再确认目标策略组确实存在。域名规则适合明确主机名,域名后缀适合同一站点的多个子域,IP-CIDR 适合已知地址段,但启用 DNS 解析跳过参数时要理解其影响。不要仅凭网站名称猜测全部连接域名,浏览器开发工具、DNS 查询结果和 Clash 运行日志都能帮助补齐实际请求。详细语法集中在配置参考。
rules:
- DOMAIN-SUFFIX,example.com,Proxy
- DOMAIN,api.example.net,Proxy
- IP-CIDR,192.0.2.0/24,DIRECT,no-resolve
- MATCH,Proxy
DNS PIPELINE / FAKE IP
DNS 配置影响域名由谁解析、解析请求经过哪条网络路径,以及规则引擎能否保留域名信息。Fake IP 模式会先返回保留地址,再由内核把连接映射回原始域名,便于按域名规则处理流量;Redir Host 更接近返回真实地址的传统解析流程。两种模式各有兼容范围,局域网设备、游戏、打印服务或部分依赖真实地址的应用可能需要单独排除。
排查 DNS 问题时,应区分系统 DNS、浏览器安全 DNS、客户端监听端口和上游解析器。只修改其中一处不一定改变完整链路。先确认 Clash DNS 模块是否启用,再检查系统请求是否进入对应端口,最后查看日志中的查询与连接记录。若域名能解析但网页打不开,还要继续检查规则目标、节点连接和 IPv6 行为,不能把所有连接失败都归因于 DNS。
NETWORK MODE / TUN
系统代理主要影响遵循操作系统代理设置的应用,例如多数浏览器和桌面软件。部分游戏、命令行工具、商店应用或自行建立网络连接的程序不会读取该设置。TUN 模式通过虚拟网络接口处理更广范围的 TCP、UDP 与 DNS 流量,适合需要统一接管的场景,但同时涉及管理员权限、路由表、网络接口和安全软件兼容性。
首次配置建议先用系统代理完成基本连接验证,确认订阅、节点和规则可用后,再根据应用需求启用 TUN。若开启后出现断网,应先关闭 TUN 恢复网络,再检查服务是否成功启动、虚拟接口是否创建、DNS 劫持配置是否匹配当前系统,以及其他 VPN 或虚拟网卡是否冲突。Windows 的服务模式、macOS 的系统扩展和 Linux 的权限配置处理方式并不相同。
DEVICE DOWNLOAD MAP
首页只提供平台定位。客户端型号、处理器架构、系统要求与安装包入口统一放在下载中心。
DEV 00 / WINDOWS
适用于 Windows 桌面设备。下载页按 GUI 客户端区分当前维护状态,并提供与常见 x64 设备对应的安装入口。首次安装后先导入配置,再启用系统代理;需要接管更多应用流量时,再检查服务模式与 TUN 权限。
[ Windows 前往下载 ]DEV 01 / MACOS
macOS 安装包需要区分 Intel 与 Apple Silicon。可先从“关于本机”确认芯片类型,再选择对应文件。首次运行可能需要在系统设置中确认应用权限;启用 TUN 或系统扩展时,还要根据客户端提示完成授权。
[ macOS 前往下载 ]DEV 02 / ANDROID
Android 设备通常根据 ARM 架构选择安装包,常见新设备优先查看 ARM64 版本。导入订阅后,系统会通过 VPN 权限对话框确认网络连接。若后台运行一段时间后断开,需要检查省电策略、后台限制和始终开启的 VPN 设置。
[ Android 前往下载 ]DEV 03 / IOS
iPhone 与 iPad 通过 App Store 安装可用客户端。添加订阅后,系统会要求确认 VPN 配置。连接状态可在客户端与系统 VPN 设置中交叉检查;若蜂窝网络和无线网络表现不同,应分别检查 DNS、局域网权限与当前策略。
[ iOS 前往下载 ]DEV 04 / LINUX
Linux 用户可根据发行版选择桌面客户端,也可以直接使用 Mihomo 内核。GUI 客户端适合桌面环境,内核更适合服务器、容器和路由设备。选择文件时必须同时确认系统架构与包格式;命令行运行还需要准备配置路径、服务权限和开机启动方式。
ARCHITECTURE CHECK
macOS 重点区分 Intel 与 Apple Silicon,Android 常见 ARM64 与 ARM,Linux 还可能涉及 AMD64、ARM64、ARMv7 或其他设备架构。文件名中的架构标识必须与设备对应。
CLIENT OR CORE
图形客户端提供配置管理、策略切换、日志和系统代理控制。Mihomo 内核更适合熟悉命令行、服务管理、配置路径和网络权限的服务器或路由设备用户。
FIRST BOOT
客户端启动后仍需导入有效配置、选择策略组和节点,并根据使用场景开启系统代理或 TUN。连接验证应包括实际访问、出口状态和运行日志三部分。
OPEN SOURCE CONTEXT
客户端、内核、配置提供方与本站文档属于不同层级。理解边界后,下载与排障会更直接。
Clash 最初以规则驱动的代理核心与配置格式获得广泛使用。围绕核心能力,社区逐步形成桌面、移动端和命令行客户端。不同客户端共享部分概念,例如代理节点、策略组、规则、DNS 与系统代理,但界面结构、维护状态、支持平台和扩展能力并不完全相同。因此,“Clash”通常指一套配置与使用生态,而不是所有平台都由同一个安装包覆盖。
部分早期客户端已经停止维护,仍可能因历史教程和旧配置被继续搜索。选择客户端时,应把当前维护状态、系统支持和配置兼容性放在界面习惯之前。下载中心会将仍在维护的客户端与归档客户端分开标示,避免把旧教程中的名称直接当成当前首选。
开源代码使内核行为、配置字段和问题记录可以被社区检查,也让不同开发者能够构建适配各平台的图形界面。图形客户端负责配置管理、系统代理开关、托盘操作、日志展示和安装更新;内核负责读取 YAML、建立网络连接、执行规则匹配并处理 DNS 与 TUN。出现问题时,先判断故障位于界面层、配置层还是内核与系统网络层,比反复重装更有效。
订阅服务不属于客户端本身。客户端负责读取配置并执行其中的节点、策略组和规则,订阅内容由对应配置来源维护。节点失效、订阅权限或流量状态需要在配置来源侧确认;YAML 解析失败、端口占用、系统代理未启用和 TUN 权限问题则更适合从客户端日志与系统设置入手。
Mihomo 是当前 Clash 生态中常见的开源内核实现,延续规则、策略组、DNS 和代理协议等核心概念,并持续扩展配置字段与运行能力。客户端是否使用 Mihomo、支持哪些字段以及如何应用覆写,应以具体客户端说明为准。把某个内核支持的全部字段直接复制到任意旧客户端,并不能保证配置可以解析。
站内配置参考以通用 YAML 结构和常见 Mihomo 字段为主,同时说明字段之间的依赖关系。修改配置前应保留可恢复副本,每次只调整一组相关字段,然后通过日志确认配置是否加载。一次改动端口、DNS、TUN、规则与策略组,会让错误来源难以定位。
客户端程序更新与订阅配置更新是两条独立路径。程序更新可能带来内核变化、界面调整和系统兼容修复;订阅更新主要刷新节点、策略组和规则内容。遇到连接异常时,不应把“更新订阅”和“升级客户端”混为同一步。先确认当前配置是否能解析,再查看客户端维护状态与系统兼容信息,最后决定是否迁移。
本站下载页通过统一清单解析当前文件入口,页面中的版本槽只有在清单提供有效信息时才显示。首页不展示版本号,避免把某个客户端的程序版本误认为整个 Clash 生态的统一版本。文档则按配置概念、平台差异和故障类型持续整理,方便在安装后继续查找。
CONFIG IMPORT
先确认链接返回的是客户端可读取的配置,再检查配置是否被设为当前项。若解析日志提示 YAML 语法错误,应从缩进、字段类型和列表层级开始检查。
查看安装配置问题 →SYSTEM PROXY
检查系统代理是否启用、浏览器是否使用独立代理设置,以及当前策略组是否已选择节点。随后通过日志确认浏览器连接是否进入 Clash 监听端口。
查看连接故障处理 →UWP LOOPBACK
部分 UWP 应用受到回环访问限制。确认普通桌面应用可以通过代理后,再检查客户端提供的 UWP 回环设置,并仅为需要的应用启用对应权限。
查看 Clash UWP 回环 →DNS ROUTE
分别检查系统解析器、浏览器安全 DNS、Clash DNS 模块与上游服务器。域名解析成功后仍连接失败,还需继续核对规则、节点和 IPv6 路由。
查看 DNS 与网络模式 →LATEST TECH NOTES
最新内容按日志定位、节点选择和订阅导入组织。每篇文章对应一个可重复执行的检查流程。
从日志级别、时间顺序和关键字段入手,说明配置解析、端口占用、DNS、TUN 与连接失败等常见报错的定位方法。适合客户端能启动但连接结果异常时按步骤检查。
READ ARTICLE →解释延迟测试的局限、倍率对流量的影响、地区选择原则和常见协议差异,建立可重复的节点筛选流程,避免只按一次测速结果决定长期使用节点。
READ ARTICLE →梳理订阅地址与 YAML 配置文件的区别,逐步说明客户端导入、手动更新以及链接无法识别时的检查方法,并解释本地覆写与远程更新之间的关系。
READ ARTICLE →