Windows
首推 Clash Plus，也可按使用习惯选择 Clash Verge Rev、FlClash 或 Clash Nyanpasu。先在系统信息中确认架构，再选择下载页对应安装包。若正在替换 Clash for Windows，迁移重点是订阅、规则和策略选择，不是直接覆盖旧程序目录。启动后检查混合端口和系统代理地址是否一致。
前往下载FIELD REFERENCE
config.yaml 顶层字段索引
客户端负责导入、切换与展示，内核依据配置处理连接。先区分监听入口、解析方式与出站目标，再修改对应字段。以下片段分别说明一个配置点，不应直接拼接为完整订阅；示例中的策略组只引用内置出站 DIRECT，实际代理节点需要另行配置。
mixed-port:
HTTP 与 SOCKS 共用监听入口
mixed-port 在同一端口接受 HTTP 与 SOCKS 请求，适合浏览器、命令行工具和需要手动填写代理地址的应用。只在本机使用时，地址通常填回环地址，端口与运行配置保持一致。allow-lan 决定是否允许局域网设备接入，但还要同时检查监听地址和系统防火墙。系统代理是客户端向操作系统写入的设置，并不等于所有应用都会经过该端口；需要接管其他流量时，再按教程评估 TUN 模式。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: infodns:
内置 DNS 与 Fake-IP 解析
dns.enable 控制内置解析服务，enhanced-mode 指定增强解析方式。Fake-IP 通过虚拟地址保留域名与连接之间的关联，便于规则按域名分流；nameserver 则列出用于解析的上游。开启内置 DNS 不代表系统请求已经自动进入该服务，仍需检查 TUN 的 DNS 劫持或系统解析设置。排查 Clash DNS 泄漏时，应观察请求实际走向，而不是只看开关。遇到局域网域名异常，再按具体域名设置过滤或解析策略。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
nameserver:
- https://dns.alidns.com/dns-queryproxies:
代理节点与协议参数
proxies 是节点定义列表，每个条目通过 name 提供可引用的名称，通过 type 指定协议。server、port 与认证字段必须与服务端对应；同一个密码字段不能替代不同协议所需的独立参数。订阅通常已经提供节点内容，初次使用不必手动重写。下方使用保留示例域名和教学密码，仅用于说明结构，不能作为可连接节点。协议是否可用取决于当前内核支持范围，客户端界面能显示名称并不代表配置已通过内核检查。
proxies:
- name: 示例节点
type: ss
server: proxy.example.com
port: 443
cipher: aes-128-gcm
password: "your-password"proxy-groups:
策略组与出站名称引用
proxy-groups 把节点或其他策略组组织为一个出站目标。select 用于手动选择，url-test 根据测试结果自动选择，fallback 按可用性顺序回退，三者的用途不能只凭名称互换。规则引用的是组名，不是界面上的排列位置。修改 name 后，应检查 rules 和其他组内的引用是否同步更新，并避免组之间形成循环。示例先保留 DIRECT 作为有效引用；导入实际订阅后，再将订阅内已有的节点名加入列表。
proxy-groups:
- name: 出站选择
type: select
proxies:
- DIRECT
rules:
- MATCH,出站选择rules:
自上而下的分流规则
rules 按列表顺序匹配，先命中的规则决定该连接的出站目标。DOMAIN 匹配完整域名，DOMAIN-SUFFIX 匹配域名及其子域，IP-CIDR 处理目标地址范围，MATCH 常放在末尾承接剩余连接。更具体的规则应放在较宽泛的规则之前，否则后面的条件可能无法生效。修改后可在连接详情中查看命中规则与实际策略组。规则模式才按这份列表分流；切换到全局模式后，不应继续用同一套命中预期判断结果。
rules:
- DOMAIN,example.com,DIRECT
- DOMAIN-SUFFIX,example.org,DIRECT
- IP-CIDR,192.168.0.0/16,DIRECT
- MATCH,出站选择profile:
策略选择与 Fake-IP 状态保存
profile 下的 store-selected 用于保存策略组的选择状态，store-fake-ip 用于持久化 Fake-IP 映射。它们处理运行状态，不负责下载订阅，也不控制订阅更新间隔。客户端更新订阅后，如果组名改变，旧的选择记录可能无法继续对应；此时应重新检查策略组，而不是反复清空全部设置。修改订阅内容前，先确认客户端是否有覆写或合并机制。直接编辑下载得到的文件，可能在下一次更新时被替换。
profile:
store-selected: true
store-fake-ip: true先确认运行配置，再定位字段
客户端保存的订阅原文、用户覆写文件和内核最终加载的配置可能不是同一份文件。修改前先确认当前激活的订阅，再查看客户端提供的运行配置或合并结果，避免编辑未被使用的副本。
- 备份现有配置。同一层级字段对齐，子字段用空格缩进，不混用制表符。
- 每次只修改一个配置点。检查策略组、节点与规则中的名称引用，区分字符串、布尔值和列表。
- 重新加载后查看日志。如果加载失败，先处理字段类型、缩进和引用错误，再测试网络连接。
- 确认订阅更新后的保留方式。长期自定义规则应放在客户端支持的覆写或合并位置。
CLIENT / PLATFORM
按操作系统选择 Clash 客户端
先匹配操作系统和处理器架构，再比较客户端的配置管理方式。桌面图形界面适合管理订阅与查看连接；服务器和路由器可直接运行内核，但需要自行处理配置路径、启动服务与网络权限。跨系统迁移时，可以参考相同的 YAML 字段，系统代理、TUN 授权和配置覆写位置仍需分别设置。
macOS
先在“关于本机”中区分 Apple Silicon 与 Intel，再选择对应安装包。Clash Plus 为首推，Clash Verge Rev 与 FlClash 可作为其他界面选择。首次启用网络接管时，按系统提示授予相关权限。菜单栏显示运行不等于系统代理已经启用，应结合应用设置与连接记录验证。
前往下载Android
首推 Clash Plus，另有 Clash Meta for Android、FlClash 与 Surfboard 供按配置格式选用。确认设备架构后安装，并在首次连接时接受系统 VPN 授权。按应用分流与系统 VPN 设置会影响哪些应用进入代理。若连接后短时间正常、后台却中断，应检查电池管理和后台运行限制。
前往下载iOS
下载页提供 Clash Plus 的 App Store 入口与官网 clashplus.io。安装后导入适配的订阅，在系统授权提示中允许添加 VPN 配置，再回到客户端选择策略组。出现连接问题时，先确认当前启用的是哪一份配置，并检查是否同时启用了其他网络扩展。
前往下载Linux
图形桌面可选择推荐的 Clash Verge Rev 或 FlClash，并按发行版选择包格式。系统代理通常依赖桌面环境，终端程序还可能需要单独设置代理变量。无桌面环境的主机可参考下载页内核区，手动配置服务管理、工作目录和权限；不要把桌面客户端的安装步骤直接套到路由器上。
前往下载QUICK START / THREE STEPS
订阅导入、规则模式与连接验证
01 / IMPORT
导入订阅并激活配置
从订阅提供方取得适配客户端的配置链接，在客户端的订阅或配置页面新增远程配置，完成下载后将其设为当前配置。列表出现条目只是第一步，还要确认内核已经成功加载。链接可能包含访问凭据，排错截图时应遮盖完整地址。若提示格式错误，先区分 YAML 配置与单节点链接，不要只改文件扩展名。
02 / ROUTE
选择规则模式与出站策略
将运行模式设为规则模式，再打开代理或策略组页面，为订阅中需要手动选择的组指定出站。组名由配置决定，不同订阅不一定相同。选择节点并不会自动让系统流量进入客户端，桌面端还需按用途启用系统代理或 TUN，移动端则需完成系统 VPN 授权。首次测试保留简单设置，避免同时修改 DNS 与分流规则。
03 / VERIFY
用连接详情确认命中结果
打开需要访问的页面，再查看客户端连接列表中的目标域名、命中规则和出站策略。延迟测试成功只能说明测试请求完成，不能代替实际应用验证。连接列表没有记录时，先检查流量入口；已有记录但失败时，再检查规则目标、节点状态与解析结果。验证完成后，可按需要设置订阅更新间隔，并记录自定义覆写的位置。
SOURCE / CORE / CONFIGURATION
Clash 生态、mihomo 内核与源码入口
客户端界面与代理内核分开理解
Clash 生态围绕 YAML 配置、规则分流和图形客户端形成了多种实现。早期项目的维护状态发生变化后，后续内核与客户端继续演进，因此“Clash”并不对应一个统一安装包。下载时应确认具体项目名称、支持平台和维护状态，不能仅凭文件名中含有 Clash 就判断它与现有配置完全兼容。本站提供文档与下载入口，不代表所有客户端项目的开发者。
mihomo 是 Clash 生态的代理内核，负责协议连接、规则匹配和 DNS 等功能；Clash Verge Rev 等图形客户端在其上提供配置管理和操作界面。界面菜单通常不是 YAML 字段的一一映射，某些开关会由客户端生成或覆写配置。排查时先确认内核最终加载了哪些字段，再检查菜单设置，能减少“文件已改、行为未变”的误判。
开源依据与协议边界
mihomo 的源代码、许可证、问题讨论与发布记录可在项目仓库查阅，仓库采用 GPL-3.0 许可证。开源项目之间的许可证与打包方式应分别核对，不能把内核许可证当作每个客户端、订阅服务或第三方配置的统一授权。需要复现行为时，应记录所用客户端、内核信息与触发条件；报告问题只保留必要片段，移除订阅地址、密码和其他访问凭据。
程序更新、订阅更新与覆写保留
更新客户端程序、更新内核和刷新订阅是不同操作。程序更新改变界面或集成功能，内核更新可能改变字段支持与处理行为，订阅更新则替换远程配置内容。出现配置加载错误时，先查看报错位置与字段类型，不要直接用频繁更换程序代替定位。较新的配置字段未必能被归档客户端识别，迁移前可先阅读客户端选型指南。
长期维护的自定义规则应优先放入客户端支持的覆写或合并机制，并确认合并发生在订阅处理的哪个阶段。列表可能被替换，也可能按客户端规则追加，不能仅凭 YAML 层级推断。每次更新后检查关键策略组名称、末尾 MATCH 和 DNS 设置是否仍符合预期。完整示例与适用范围见配置参考，源码阅读则从项目仓库开始。
CONFIGURATION NOTES
近期配置文章
文章按具体操作场景展开：共享代理时先定位监听入口，选择节点时区分测试结果与计费规则，转换订阅时核对配置结构。涉及通用字段的部分可与配置参考对照，不必把单篇文章中的局部设置直接覆盖到现有配置。
Clash 局域网共享代理:mixed-port 与 allow-lan 配置步骤
讲解 mixed-port 混合端口与 allow-lan 的作用，给出让同一局域网内手机、电视、游戏机使用电脑代理的配置步骤与防火墙注意事项。
阅读配置说明 →Clash 节点怎么选:延迟测试结果、流量倍率与地区协议取舍
解释延迟测试数值的含义与局限，说明流量倍率对用量的影响，并按用途给出地区与协议的取舍思路，帮助在节点列表里做出判断。
阅读配置说明 →Clash YAML 订阅与 Base64 节点链接:格式差异与互相转换方法
对比 Clash YAML 订阅、Base64 编码链接与单节点 URI 三种格式的结构，说明转换时字段如何对应，以及转换后需要检查的部分。
阅读配置说明 →