Windows
从 Clash Plus、Clash Verge Rev 等客户端中选择。首次连接先设置系统代理，再核对浏览器是否使用相同端口；需要接管其他应用时，再配置 TUN 与服务权限。
前往下载01 / CLIENT DOWNLOADS
Clash 客户端下载入口
桌面环境选图形客户端；服务器与路由器按架构选 mihomo 内核。
客户端负责订阅管理、界面操作和系统集成，内核负责连接与规则执行。先确定操作系统、处理器架构和安装包格式，再阅读对应安装步骤。已有配置也应先备份，避免导入时覆盖本地规则。
macOS
按 Apple Silicon 或 Intel 选择安装包。Clash macOS 下载入口列出图形客户端及归档项目；阅读 ClashX Meta 下载说明时，注意维护状态与当前系统的兼容性。
前往下载Android
按设备架构选择安卓安装包。首次启动需确认系统 VPN 授权，连接后再检查后台运行限制。若切换应用后代理断开，先查看电池优化与后台活动设置，不必反复导入订阅。
前往下载iOS
进入下载页查看 Clash Plus 的 App Store 入口与官网 clashplus.io。安装后先导入兼容配置，再按系统提示添加 VPN 配置；规则与策略组是否可用，以客户端实际支持情况为准。
前往下载Linux
图形桌面可选 Clash Verge Rev 或 FlClash。Debian 系与 RPM 系分别选对应包格式；无桌面服务器直接运行 mihomo。先用 uname -m 确认架构，再配置目录和服务。
安装包格式不等于处理器架构。发行版能安装某种包，仍需确认包内二进制适配当前设备。使用图形客户端时，也不要同时启动独立内核占用相同监听端口。
查看全部客户端02 / CONFIGURATION WORKSPACE
mihomo 配置与运行方式
从监听入口到常驻服务，按需要增加配置层。
下面的代码是字段片段，不是完整订阅。先让本地代理端口可用，再处理流量接管与规则引用。每次只调整一类字段，检查日志后再继续，便于区分配置错误、权限问题和上游连接失败。
mihomo 内核
mihomo 负责解析配置、监听端口与执行分流，图形客户端在外层提供订阅管理和系统集成。先设置 mixed-port，让支持 HTTP 或 SOCKS 的应用明确连接本地入口；再用配置检查命令确认 YAML 可解析。与仅依赖界面开关的操作相比，直接维护文件更适合服务器和远程终端，但需要自行管理目录、权限与日志。控制接口保持本机监听，避免将管理入口直接暴露到网络。
mixed-portmodeexternal-controller
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
external-controller: 127.0.0.1:9090先确认本地监听地址。
TUN 透明代理
TUN 通过虚拟网络设备接管流量，适合不读取系统代理或环境变量的应用。与手动指定代理端口不同，它涉及设备权限、路由表与 DNS，因此应在普通代理测试通过后启用。Linux 上先确认 /dev/net/tun 存在，再按运行方式授予必要能力；启用自动路由后检查局域网访问是否正常。已有 VPN、容器网桥或自定义策略路由时，应先保存现有设置，避免两个流量接管组件同时修改路由。
tun.enabletun.stackauto-route
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true路由接管前先检查权限。
规则分流
规则模式按顺序匹配连接，首次命中的规则决定去向。先写明确的域名和局域网例外，再添加规则集，最后用 MATCH 收尾；策略名称必须与已有策略组完全一致。与 Clash 全局模式统一交给一个策略不同，规则模式可以分别处理直连资源与代理连接。排查时查看日志中的域名、目标地址和命中规则，不要仅凭网页能否打开判断规则正确。远程规则集还要确认下载成功、格式匹配且已被 rules 引用。
rulesDOMAIN-SUFFIXMATCH
# 策略组 Proxy 需在完整配置中定义
rules:
- DOMAIN-SUFFIX,example.org,DIRECT
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- MATCH,Proxy按从上到下的顺序匹配。
订阅与 Provider
Provider 将节点来源与本地策略分开维护，适合希望保留自定义规则的部署。proxy-providers 提供节点，rule-providers 提供规则，两者不能互换。与整份订阅覆盖配置相比，分离后可独立更新来源，减少本地修改被替换的机会。先确认返回内容是兼容的 YAML，再配置路径、刷新间隔和策略组引用。订阅地址通常带访问凭据，应保存在本机；分享日志或配置前先移除地址中的敏感参数。
proxy-providersrule-providersuse
proxy-providers:
local-nodes:
type: file
path: ./providers/nodes.yaml
proxy-groups:
- name: Proxy
type: select
use:
- local-nodes来源名称与 use 引用保持一致。
systemd 常驻
systemd 将终端中的手动启动变为可查询、可重启的服务。先创建用户服务单元，明确二进制绝对路径和配置目录，再执行配置检查与启动命令。与后台追加符号启动相比，服务单元能集中记录日志并定义退出后的处理方式。用户服务不等于系统服务，登录会话之外是否继续运行还取决于 linger 设置；TUN 权限也不会因启用服务自动获得。更新二进制后应重新确认能力授权，再检查服务和监听状态。
ExecStartsystemctl --userjournalctl
mihomo -t -d ~/.config/mihomo
systemctl --user daemon-reload
systemctl --user enable --now mihomo
systemctl --user status mihomo
journalctl --user -u mihomo -b先创建服务单元，再启用服务。
字段之间存在引用关系：节点进入策略组，策略组再被规则引用；DNS 与路由则影响流量能否按预期进入内核。配置检查通过只代表文件能被接受，仍需实际发起请求验证。
查阅 config.yaml 配置参考03 / FIRST CONNECTION
Linux 快速上手三步
先建立一条可验证的连接，再启用透明代理。
图形客户端和直接运行内核使用不同的操作入口，但验证顺序一致。先确认配置来源，再确认内核启动，最后确认应用流量确实进入代理。不要把订阅导入成功当作网络连接成功。
STEP 01
选择客户端与配置目录
桌面用户安装图形客户端，按界面导入配置；命令行部署将文件放到 ~/.config/mihomo/config.yaml。先备份已有文件，再确认订阅提供的是完整配置还是仅含节点的 Provider。两种内容对应的导入入口不同，不能只修改扩展名就直接互换。
配置地址由订阅提供方给出，本站下载入口提供的是软件，不附带节点。远程服务器还需检查目录归属，避免用普通用户运行时无法读取由管理员创建的文件。
STEP 02
检查配置并启动内核
命令行部署先执行配置检查，确认缩进、字段和策略引用有效，再启动内核。首次使用保留 info 日志，观察监听地址是否与配置一致。若出现端口占用，先查出已有进程，不要一边反复改端口，一边保留应用里的旧代理地址。
mihomo -t -d ~/.config/mihomo
mihomo -d ~/.config/mihomo图形客户端中对应操作通常是启用配置与启动服务；具体按钮位置以客户端界面为准。
STEP 03
验证请求与规则命中
先使用显式代理发起请求，确认应用能够访问本地端口，并在日志中看到对应连接。随后再开启系统代理，检查浏览器；最后按需求开启 TUN。每增加一层流量接管，都重复一次请求测试，这样能确定问题发生在哪一层。
curl -I -x http://127.0.0.1:7890 https://example.org收到 HTTP 响应说明请求链路有反馈，不代表所有域名或所有规则均正常；还应选择实际需要使用的站点继续验证。
需要 Clash Verge Rev 教程时，先按图形客户端流程完成导入，再对照字段参考理解底层行为。环境变量只影响读取它们的进程，系统代理也不等于接管所有连接；终端可用、浏览器不可用时，应分别检查各自入口，而不是立即更换订阅。
查看完整教程04 / SOURCE & OPERATIONS
开源项目与部署边界
按项目来源理解软件，按运行日志确认部署。
Clash for Linux 整理客户端下载与部署资料，不是所有客户端的开发团队。页面中的命令展示 Linux 常见用法，执行前仍需结合发行版、桌面环境和当前权限。开源许可、功能支持和维护状态应分别查看对应项目。
Clash 生态与 mihomo 的关系
Clash 生态包含代理内核、图形客户端与周边配置工具，名称相近不代表同一个项目。mihomo 由 Clash.Meta 项目延续发展，保留 Clash 风格的配置组织方式，并扩展协议与运行能力。旧配置迁移时仍应逐段检查，不应假设任意客户端都支持相同字段。遇到未知字段，先确认实际运行的内核，而不是只看窗口标题。
本站以 mihomo 的 Linux 部署为主线，图形客户端部分负责帮助选择安装入口。客户端界面的订阅、覆写与服务模式可能增加自己的配置层，最终交给内核的内容未必与导入文件逐字相同。排查引用错误时，要区分原始订阅、本地覆写和运行配置。
源代码与开源许可
mihomo 源代码可在 MetaCubeX/mihomo 仓库查阅，项目采用 GPL-3.0 许可。阅读源码、构建说明与问题记录，有助于确认某个字段是否受支持，以及行为变化来自内核还是客户端集成。源码开放不等于下载后即可直接执行：克隆得到的是项目文件，编译还需按上游说明准备工具链。
复制右侧命令可获取仓库，用于阅读实现或准备自行构建。普通桌面用户直接选择下载页的客户端即可。第三方图形客户端各自维护发布节奏，不能用某一内核项目的许可与更新记录替代所有客户端的说明。
更新前保留可恢复的配置
内核、图形客户端、订阅内容和规则集是不同的更新对象。升级软件前保存正在使用的配置与服务单元，阅读相关变更，再运行配置检查。更新 Provider 只替换来源数据，并不等于升级内核；修改本地规则也不会自动同步到订阅服务器。清楚每个文件由谁管理，才能避免下一次刷新覆盖调整结果。
直接替换 Linux 二进制后，还需确认可执行权限、服务路径以及 TUN 所需能力是否仍然有效。先在前台验证启动，再重启常驻服务；失败时保留错误输出，按配置、文件访问和网络连接分层排查。
最小暴露与可观察运行
单机使用时让代理入口与控制接口监听回环地址，并保持 allow-lan: false。需要向局域网提供服务时，再明确监听地址、防火墙范围和访问控制。控制接口用于管理内核，不应因为代理可用就直接开放；订阅地址也不应贴进公开的问题记录。
使用 systemd 时把日志作为第一排查入口。服务显示运行中，仍可能存在订阅读取失败或 DNS 配置问题；反过来，某个网页失败也不一定是服务退出。结合监听端口、一次显式代理请求和对应日志，通常比连续切换模式更容易定位原因。
05 / DEPLOYMENT NOTES
配置拆解与故障排查
按实际部署问题补充阅读，不把全部参数塞进首次安装流程。
初次连接完成后，再处理定时更新、字段组织与移动端后台策略。文章中的片段应结合已有配置使用；复制前确认字段所属层级，修改后检查运行配置，并用同一组请求对照调整前后的表现。
mihomo config.yaml 逐段拆解：从 mixed-port 到 rules 的字段顺序与作用
沿配置文件的自然顺序，逐段讲解通用端口、运行模式、DNS、proxies、proxy-groups 与 rules 的写法和段间引用关系，并为每段附上可复制的示例。
阅读文章安卓端 Clash Meta 耗电异常：后台保活、电池优化白名单与 TUN 取舍
分析移动端常驻代理耗电偏高的原因，涵盖健康检查频率、日志级别、各厂商后台限制与电池优化白名单设置，以及 VPN 模式下的省电调整方法。
阅读文章Clash 订阅更新失败的常见报错与 proxy-providers 定时刷新设置
梳理订阅拉取超时、证书错误、UA 被拒、格式不兼容等报错的含义，并说明如何用 proxy-providers 的 interval 与健康检查实现订阅自动更新。
阅读文章