TRAFFIC / CONFIGURATION
先确定流量怎样进入内核，再决定连接怎样出站。
系统代理把操作系统的代理地址指向客户端本地监听端口。浏览器等遵循系统设置的应用由此进入内核，再按当前模式选择出口。首次配置建议先采用这条路线：导入订阅，启动内核，再打开客户端的系统代理开关。它与 TUN 的区别在于接入范围，不是节点速度；忽略系统代理的应用仍可能直接连接。代码中的混合端口同时接收 HTTP 与 SOCKS 请求，但真正修改系统设置的是客户端开关。
mixed-port: 7890allow-lan: falsemode: rulelog-level: info# 系统代理由客户端界面启用TUN 通过虚拟网络接口与路由设置，让不主动采用系统代理的应用也能接入内核。开启前先确认订阅在普通代理模式下可用，再授予客户端所需的管理员或 VPN 权限。自动路由负责把流量引入接口，DNS 劫持用于接入指定的解析流程，两者需要结合本机网络环境检查。与系统代理相比，TUN 接入更深入，也更容易受其他 VPN、虚拟网卡和路由软件影响；出现冲突时应逐项排查，而不是同时修改所有选项。
tun: enable: true stack: mixed auto-route: true auto-detect-interface: true dns-hijack: - any:53规则模式按配置顺序检查连接目标，命中后交给对应策略处理。域名后缀、地址网段与规则集合可以共同组织分流逻辑，最后再用兜底规则处理剩余连接。与全局模式统一选择一个策略不同，规则模式允许本地服务直连、指定站点走代理。新增自定义规则时，应先确认策略名称存在，再把具体规则放在宽泛规则之前。示例中的 PROXY 是策略组名称，需要在完整配置中另行定义，不能把片段当作完整订阅直接导入。
mode: rule# PROXY 须在策略组中定义rules: - DOMAIN-SUFFIX,github.com,PROXY - IP-CIDR,192.168.0.0/16,DIRECT - MATCH,PROXY订阅链接用于从配置来源取得节点或完整配置。首次使用通常在客户端的配置页面粘贴链接，下载成功后选中并启用对应配置。完整 YAML 可以包含策略组、规则与 DNS，而节点提供器只承担节点来源管理，仍需主配置引用。与复制一条节点链接相比，完整订阅更适合保留已有分流结构。更新前建议备份本地修改，并确认客户端是否支持覆写机制；直接编辑订阅缓存文件，可能在下次自动更新时被替换。
# 本地节点提供器片段proxy-providers: local-nodes: type: file path: ./providers/nodes.yaml# 策略组通过 use 引用 local-nodesPACKAGES / PLATFORMS
先选操作系统，再核对处理器架构与安装方式。客户端下载与代理服务是两件事，安装完成后仍需准备可用配置。
优先查看 Clash Plus，也可对照 Clash Verge Rev、FlClash 与 Clash Nyanpasu。安装后先导入配置，再启用系统代理；需要 TUN 时再配置服务与权限。遇到本地端口占用，应先定位已有进程，避免反复重装。
前往下载按 Apple Silicon 或 Intel 选择安装包。Clash Plus、Clash Verge Rev 与 FlClash 提供不同界面；查找 ClashX Meta 时需留意归档状态。首次运行遇到系统安全提示，应先确认来源，再按系统指引完成授权。
前往下载可选择 Clash Plus、Clash Meta for Android、FlClash 或 Surfboard，并确认订阅格式与客户端兼容。首次连接需要批准 VPN 请求。后台连接中断时，先查看电池优化与后台运行限制，再检查订阅是否到期。
前往下载通过下载页进入 Clash Plus 的 App Store 页面，官网为 clashplus.io。导入配置并允许添加 VPN 配置后，再选择策略与节点。系统的 VPN 标识只表示隧道已建立，实际分流结果仍应结合请求记录检查。
前往下载桌面环境可从 Clash Verge Rev 与 FlClash 开始，按发行版选择软件包格式。服务器与路由器场景可单独部署 mihomo 内核，另行设置配置目录、服务权限与启动方式；命令行部署不等同于安装桌面客户端。
前往下载FIRST CONNECTION
按“配置来源 → 接入方式 → 请求验证”的顺序操作，出现问题时也按同一顺序回查。
从下载页选择适合系统的客户端。打开配置或订阅页面，粘贴服务提供方给出的 Clash 兼容订阅地址，完成下载后设为当前配置。看到配置名称不代表已经启用，应继续确认节点列表与策略组是否出现。
如果只拿到单条节点链接或 Base64 文本，先确认客户端的导入能力。需要转换时，优先使用可信任的本地处理方式；订阅链接可能关联账户与流量信息，不应粘贴到来源不明的在线工具。
在策略组中手动选择一个可用节点，再把运行模式设为规则。桌面平台可先打开系统代理，用浏览器完成基础测试；确认这条链路正常后，再按需要启用 TUN。移动平台则按系统提示批准 VPN 授权。
不要把全局模式与 TUN 当成同一个开关。前者决定连接进入内核后怎样选择策略，后者决定流量怎样进入内核。全局模式也不意味着设备上的每个应用都已经被接管。
访问需要测试的目标站点，同时打开客户端连接列表。检查目标域名、命中规则、策略组与最终节点，确认请求路径符合预期。单次延迟测试只反映特定测试目标，不代表下载速度或所有服务的访问质量。
若页面无法打开，先看连接是否进入内核。没有记录时检查系统代理、VPN 权限与路由；已有记录却连接失败时，再查看 DNS、节点可达性和规则目标。每次只调整一个设置，保留可复现的检查结果。
安装包不包含代理服务。客户端负责读取配置与处理连接，节点由配置来源提供。订阅可成功下载，也不保证其中每个节点当前可用；需要结合服务状态与实际请求判断。
连接成功不等于分流正确。本地设备、公司网络与打印服务通常需要保留直连路径。开启 TUN 后若这些服务异常，应优先检查局域网路由与排除项，而不是直接把所有请求交给代理节点。
本地修改需要可持续保存。订阅更新可能覆盖手工编辑。长期使用的自定义规则应放进客户端支持的覆写或合并机制，并在更新后再次检查顺序与策略组名称。具体界面因客户端而异，按平台文档核对。
OPEN SOURCE / RESPONSIBILITY
区分界面、内核与配置来源，才能准确判断功能支持和问题归属。
Clash 生态包含内核、桌面界面、移动客户端与配置工具。Clash Meta 是常见的历史检索名称，mihomo 延续了相关内核方向。搜索旧教程时可能同时看到这两个名称；实际配置应以所用内核的文档为准，不能仅凭应用名称推断支持哪些协议和字段。
ClashX 则常用于指代 macOS 平台的客户端路线，并不代表所有平台使用同一套应用。本站把安装包入口与中文说明按平台整理，帮助区分仍在维护的客户端和归档项目。不同项目有各自的发布节奏，客户端界面相似也不意味着内核行为完全一致。
mihomo 的公开仓库提供源代码、许可文本、问题讨论与发布信息。开源协作的价值在于实现可以查阅，问题能够围绕明确的配置与环境复现。GPL-3.0 是这里列出的 mihomo 内核许可，不代表每一个第三方客户端或商店应用都采用相同许可；分发与修改时应分别阅读对应项目说明。
反馈问题前，先记录操作系统、客户端名称、内核信息与触发步骤。日志只保留复现所需部分，并遮去订阅地址、账户信息、节点密码与其他访问凭据。把“某网站打不开”拆成解析失败、连接失败或规则选择错误，通常比只描述最终现象更容易定位。
客户端通常负责配置导入、订阅更新、托盘菜单、系统代理和权限服务；内核负责解析配置、执行规则、建立代理连接与处理网络请求。因此，界面开关没有生效时，既可能是系统授权问题，也可能是配置被覆写，不能只检查节点列表。
迁移客户端时，先导出配置并记录自定义项。完整 YAML、单条节点链接与节点提供器不是同一种内容；能够导入其中一种，不代表另外两种也能直接使用。协议支持、TUN 网络栈和规则行为还需要结合内核确认。
更新应用安装包、更新内核、刷新订阅与下载规则集合，是四个不同动作。订阅刷新成功只说明取得了远端内容；应用仍可能使用旧配置，策略组也可能保留此前选择。更新完成后应检查当前启用项，而不是只看更新时间提示。
遇到兼容性问题时先备份，再比较更新前后的配置差异。不要同时更换客户端、节点、DNS 和规则，否则难以判断是哪项变化解决了问题。需要长期运行的环境，建议保留可恢复的配置副本，并把关键修改记录在本地。
NOTES / FIELD GUIDES
从端口、订阅格式到 Linux 部署，按问题查阅对应操作。
Clash 启动报端口被占用时，可用 netstat、lsof 等命令找出占用进程，再修改 mixed-port 与 external-controller 端口，并同步更新系统代理设置。
阅读文章 →梳理常见订阅格式的结构差异，说明 Clash 为何需要 YAML 配置，并介绍用订阅转换把 Base64 节点链接转成可直接导入的完整配置，以及转换时的注意事项。
阅读文章 →介绍在 Linux 上运行 Clash 的两种方式：安装带图形界面的桌面客户端；或在服务器、无桌面环境下部署 mihomo 二进制，编写 systemd 服务并接入 Web 面板。
阅读文章 →