概念 · 配置 · 维护

Clash 使用手册
从零到精通

沿着流量进入客户端、匹配规则、选择出口的路径,逐章建立配置与排错方法。

一、核心概念:区分客户端、内核与流量入口

客户端负责操作,内核负责转发

Clash 生态并不是一个安装包对应全部功能。图形客户端提供订阅导入、设置页面、代理组选择和日志查看;内核读取配置,执行域名解析、规则匹配与连接转发。mihomo 是这一生态中常见的内核。两款客户端即使使用相近的内核,也可能在覆写方式、系统集成和配置保存位置上不同,因此不能只凭界面上的相同按钮判断行为完全一致。

配置文件是连接两者的约定,通常使用 YAML 格式。文件中既可能包含代理节点,也可能包含代理组、分流规则、监听端口和 DNS 设置。订阅则是取得这些内容的一种来源:有的地址返回完整配置,有的只提供节点集合。导入成功说明客户端接受了输入,并不等于规则正确、出口可用或所有应用已经进入代理,这些环节需要分别验证。

按三个问题理解一次连接

排查任何访问问题,先问流量是否进入内核,再问命中了什么规则,最后问所选出口能否完成连接。系统代理主要为遵循系统设置的应用提供 HTTP 或 SOCKS 入口;应用自己设置代理时,也可以直接连接本机监听端口。TUN 则通过虚拟网络接口接管符合路由条件的流量。入口不同,覆盖范围和排错方法也不同,不能用浏览器成功代表全部应用成功。

进入内核后,规则一般按顺序从上往下检查,命中后交给指定策略。策略可能是直接连接,也可能是一个代理组。代理组再决定使用哪个节点,节点承担到远端代理服务的连接。由此可见,“规则模式”不是一种节点协议,“系统代理”也不是代理组;把这些不同层次的设置混在一起,容易出现不断切换节点却始终无法解决入口问题的情况。

层次主要职责优先观察
流量入口把应用连接交给内核系统代理、应用代理、TUN 路由
规则与策略决定连接应当走向哪里匹配规则、代理组、最终出口
远端连接通过所选节点访问目标认证、协议、解析与握手错误

明确能力边界再配置

客户端本身不等于可用的远端代理服务。节点地址、端口、认证信息和可用范围取决于配置来源;订阅到期、认证失效或服务限制,通常不能靠打开 TUN 修复。另一方面,代理也不负责修复目标网站自身的登录限制或服务故障。测试时应使用有权访问的服务,并遵守所在地法律、网络管理规定和服务条款,避免把业务侧拒绝误判成客户端故障。

开始前建立一份简单记录:操作系统、客户端名称、配置来源、当前入口和期望覆盖的应用。不要记录订阅密钥到公开笔记。随后先完成浏览器访问,再扩大到其他应用,最后才考虑全局接管。每次只增加一个变量,故障出现时才能回到上一条可用路径。内核与图形界面的关系还可参考Clash 生态谱系说明。

二、选择客户端:先匹配平台,再考虑配置能力

首次使用优先选择统一的操作路径

本发布页在支持的平台上首推 Clash Plus,适合希望围绕同一产品学习订阅、策略与连接管理的用户。实际选择仍应以设备支持情况和所需功能为准:桌面用户可能更关心服务模式、规则覆写和窗口管理,移动用户则更关心 VPN 授权、后台运行和电池消耗。先写下必须解决的问题,再比较客户端,通常比同时安装多个产品更容易得到稳定结果。

Windows 下载区还提供 Clash Verge Rev、FlClash、Clash Nyanpasu,以及已停止维护的 Clash for Windows。macOS 提供 Clash Plus、Clash Verge Rev、FlClash 和已停止维护的 ClashX Meta。归档客户端适合了解旧环境或处理迁移,不宜仅因为旧教程截图一致就作为新安装的默认选择。迁移时应先备份订阅来源与自定义规则,再在新客户端重新建立系统集成设置。

平台限制比界面外观更重要

Android 可在 Clash Plus、Clash Meta for Android、FlClash 与 Surfboard 之间按配置兼容性选择。Surfboard 的配置体系与 Clash YAML 存在差异,不能把任意完整 YAML 文件直接当成通用输入。iOS 下载区提供 Clash Plus 的商店入口,并列出官网 clashplus.io。移动系统一般通过系统提供的 VPN 能力建立隧道,不应照搬桌面系统代理端口的操作流程。

Linux 的图形方案包括 Clash Verge Rev 和 FlClash;服务器、路由器或希望自行维护服务的用户,可以进一步考虑独立 mihomo 内核。独立内核需要自行处理启动参数、运行目录、权限、日志和服务管理,不会自动拥有图形客户端的订阅按钮。若目标只是日常桌面使用,先用图形界面建立可用配置,再学习内核部署,能减少同时面对的变量。

设备情况选择前确认常见误区
桌面电脑操作系统、处理器架构、服务权限把系统代理当作全部流量接管
手机与平板配置格式、VPN 授权、后台策略同时启用多个 VPN 类应用
服务器与路由器指令集、运行权限、路由与防火墙只复制配置而遗漏运行环境

兼容配置不等于兼容所有扩展

比较客户端时,分别检查节点协议、规则语法和客户端扩展。某个内核能识别的字段,可能在另一个内核中被拒绝;图形客户端支持的脚本或覆写格式,也不一定属于标准配置。遇到教程要求添加字段,应先确认教程面向的产品和内核。不要为了消除报错随意删除整段 DNS 或代理组配置,否则即使文件能够载入,也可能改变原本的分流意图。

最终只保留一个承担主要系统接管的客户端。其他产品可以用于对照,但测试前应退出旧客户端、关闭其系统代理并确认后台服务状态,避免端口或路由争用。安装包和架构说明统一从客户端页面查看;旧版用户可以先读停更客户端迁移说明,理解哪些配置能平移,哪些设置应当重新建立。

三、安装与初始检查:建立可回退的本机环境

确认架构和旧环境

下载前先查看系统信息,不要只依据电脑品牌判断处理器架构。macOS 需要区分 Apple Silicon 与 Intel;Android 应根据设备支持的指令集选包;Linux 则同时涉及架构和发行版的软件包格式。安装包能够下载不代表适用于当前设备,出现无法执行、格式不支持或架构不匹配时,应先回到系统信息核对,而不是连续重复安装同一个文件。

安装前记录原有系统代理、正在运行的 VPN 和公司网络要求。如果之前使用过其他代理客户端,先从其界面关闭接管并正常退出,必要时检查后台服务。不要在尚未确认用途时删除旧配置目录;迁移过程中,目录里可能保存着自定义规则和订阅来源。更稳妥的做法是保留一份仅本机可访问的备份,再建立新客户端的独立配置。

权限按功能授予

Windows 中,普通系统代理与需要高权限的 TUN 并非同一件事。服务模式通常用于让需要权限的操作交由后台服务执行,具体入口由客户端决定。安装服务前应确认授权提示对应当前产品,不必为了让浏览器连接就始终以管理员身份运行整个界面。若安装目录受组织策略限制,应由设备管理员处理,不要通过关闭安全机制来绕过管理要求。

macOS 首次启动可能涉及应用许可和网络扩展授权;Android 与 iOS 通常会出现系统 VPN 配置确认。授权完成后返回客户端,查看是否真的进入连接状态。Linux 图形客户端还可能依赖桌面环境组件或系统服务权限。遇到缺少依赖、权限不足等提示,应保留完整错误文本,按发行版和客户端说明处理,避免把所有启动问题都归因于订阅。

第一次启动只检查基础项

先找到配置、代理组、连接和日志页面,确认能够定位这些入口,再导入订阅。监听端口应以当前客户端设置为准,本手册中的 7897 只是示例值,不能据此推断所有产品的默认端口。端口被占用时,应识别占用进程,决定退出旧服务还是调整新端口;改完后同步更新手动设置过代理的应用,防止应用继续连接旧地址。

初次排错时可以在本机终端查看环境变量,确认命令行工具是否被旧代理设置影响。不同终端的检查方式不同;下面的命令只读取当前进程可见的变量,不会修改系统。发现代理变量后,还要判断它来自当前终端会话、用户配置文件还是开发工具,不能仅关闭图形开关就认为这些变量也已清除。

# Linux / macOS:查看常见代理环境变量
env | grep -iE '^(http|https|all|no)_proxy='

# Windows PowerShell:查看当前进程的代理环境变量
Get-ChildItem Env: | Where-Object Name -Match '^(HTTP|HTTPS|ALL|NO)_PROXY$'

完成安装的验收标准不是界面能够打开,而是配置能够载入、监听入口没有冲突、接管功能可以关闭、日志能够正常查看。先完成这些基础检查,后续遇到异常时才有可靠参照。Windows 的具体服务授权和开机自启路径,可结合Clash Verge Rev 安装说明查阅,其他客户端不要机械套用同名菜单。

四、订阅与配置:区分远程来源和本地修改

先确认输入是什么

订阅地址可能返回完整 Clash 配置,也可能是节点集合、编码后的链接列表或其他产品的格式。导入前查看提供方对格式的说明,优先使用明确标注适用于当前客户端的入口。在客户端的订阅或配置页面新建远程配置,粘贴地址后执行下载,再查看载入结果。若出现解析错误,应先判断返回内容是不是配置,而不是直接反复刷新节点。

订阅链接往往包含能识别账户的参数,应像账户凭据一样保存。截图、公开提问和复制日志前,遮盖完整地址及认证字段;不要为了转换格式把私人订阅交给不了解的数据处理服务。教学中可使用 https://example.com/sub?token=xxxx 表示地址结构,但这个示例没有实际订阅内容,不能用于连接。真实地址应只从授权来源取得。

导入后的检查顺序

下载完成后先切换到新配置,确认它确实成为当前使用项。然后检查代理组是否存在、组内是否有可选出口、规则是否引用了有效策略。某些客户端的“订阅已更新”只说明文件已保存,内核仍可能因为语法或引用错误拒绝重载。应结合当前配置标记和日志确认实际生效结果,而不是只看更新按钮旁边的成功提示。

YAML 对缩进和结构敏感,建议使用空格,不要混用制表符。列表项通常以连字符开始,同一层级保持一致缩进;含有特殊字符的字符串可加引号。错误位置有时出现在真正问题的下一行,因此要连同前后结构一起检查。下面只展示配置结构,不包含代理节点,也不是可直接替代订阅的完整文件,实际配置应保留来源提供的有效节点与策略。

# 结构示例:需要与实际订阅合并使用
mixed-port: 7897
allow-lan: false
mode: rule
log-level: info

rules:
  - DOMAIN-SUFFIX,example.com,DIRECT
  - MATCH,DIRECT

把订阅更新与个性化设置分开

直接编辑远程订阅文件的风险是下次更新会覆盖修改。需要长期保留的规则、DNS 或端口调整,应优先放在客户端支持的覆写、合并配置或独立规则文件中,并了解其执行顺序。有的产品先合并设置再生成最终配置,有的通过脚本修改对象;这些机制并不通用。修改后应查看最终生效配置,确认字段没有被订阅中的同名项再次覆盖。

更新失败时按网络、响应内容和配置解析三个方向分开排查。超时或证书错误通常发生在获取阶段;能够下载但提示 YAML 错误,重点检查响应是否变成登录页面、到期说明或错误文本;节点存在但连接失败,则转向认证和出口测试。若当前已有可用配置,先保留它,不要在来源暂时不可用时删除本地缓存,否则会失去最后一份能工作的环境。

订阅转换用于解决格式适配,不会让失效节点恢复,也不能保证所有字段都能一一映射。转换后尤其要检查代理组名称、规则顺序和 DNS 设置,避免只剩节点而丢失原有策略。最终验收应包含一次重载和一次实际访问;想先完成简化流程,可返回订阅导入教程,常见失败原因则可在常见问题中继续定位。

五、代理模式与验证:确认连接进入了哪条路径

规则、全局和直连改变的是策略

规则模式按配置中的规则选择出口,适合需要同时访问本地服务和远端资源的日常环境。全局模式通常把进入内核的连接交给全局策略,便于临时对照某个出口是否可用;直连模式则让进入内核的连接直接访问目标。三者都不自动保证所有应用进入内核,因此打开 Clash 全局模式后,某个应用仍可能完全绕过客户端,这首先是入口问题。

开始验证时只保留一种主要入口。桌面可先开启系统代理,选择规则模式,并在常用代理组中选择一个明确的出口。移动端则先建立系统 VPN 连接。随后打开一个已知可以访问的测试目标,同时查看连接列表,核对目标域名、匹配规则与最终策略。只有页面成功而连接列表没有对应记录时,需要考虑浏览器缓存、连接复用或应用没有使用预期入口。

用对照测试缩小范围

浏览器与终端不一定读取同一套代理设置。命令行可显式指定本机 HTTP 代理,绕开环境变量差异,验证监听入口是否工作。下面示例假设混合端口为 7897,使用前应按当前设置替换。它访问公开示例域名,只能证明这一次请求的链路情况,不能据此得出所有网站、所有协议和所有应用都已经正常的结论。

# 显式经过本机 HTTP 代理
curl -I --proxy http://127.0.0.1:7897 https://example.com

# 显式跳过代理,作为对照
curl -I --noproxy "*" https://example.com

若第一条提示无法连接本机端口,应检查客户端是否运行、端口是否正确以及监听是否建立;若已经连接本机但远端请求失败,再查看所选节点、规则和日志。若直连正常而代理失败,可以用另一个已知可用出口对照;若两者都失败,则还要考虑目标服务、当前网络和系统时间。不要在一次测试中同时改节点、DNS、入口和规则,否则无法判断哪个改动有效。

理解代理组与连接复用

手动选择组适合需要固定出口的场景;自动测试组按配置中的探测条件选择候选;故障转移组侧重在当前候选不可用时切换。探测地址、间隔和容差会影响选择结果,某个探测成功也不等于所有业务都可访问。排错初期可暂时手动固定一个出口,减少自动切换造成的干扰,待路径明确后再恢复自动策略。

切换模式或节点后,已经建立的长连接未必立即迁移。浏览器连接池、下载任务和即时通信程序可能继续使用旧连接。需要验证新策略时,先重新发起请求,必要时在客户端关闭对应连接或重启目标应用;不必每次都重启整台设备。观察连接建立时间和最终出口,比单看代理组当前选中项更能说明某个业务实际使用了哪条路径。

还要区分访问成功与隐私目标。连接走代理不代表 DNS、应用遥测和账户行为都具有相同边界;浏览器安全 DNS、应用自带解析及 UDP 流量可能需要另行检查。对于商店应用不遵循预期代理的情况,可查阅Windows UWP 回环豁免说明,先确认应用类型和限制,再决定使用回环豁免还是调整入口。

六、规则分流:把访问意图写成可解释的顺序

先写例外,再写通用规则

分流规则一般自上而下匹配,先命中的规则决定后续策略,因此顺序本身就是配置逻辑。一个常见组织方式是:先处理明确的服务例外,再处理局域网等地址范围,随后应用较大范围的规则集合,最后设置兜底。不要把宽泛的直连或代理规则放在所有细规则前面,否则后面的条目即使语法正确,也可能永远没有机会被命中。

域名规则适合表达服务意图,地址规则适合表达网络范围。DOMAIN 匹配完整域名;DOMAIN-SUFFIX 可覆盖指定域及其子域;IP-CIDR 按地址段匹配;GEOIP 使用地理地址数据判断;MATCH 用作最终兜底。域名后缀匹配不是随意的字符串包含,编写时应使用真实域名边界,避免把路径、协议前缀或查询参数写进域名字段。

先验证策略名称,再验证语法

规则最后一项必须指向实际存在的策略。下面的 PROXY 是示例代理组名称,使用前应确认当前配置确实存在同名组;否则应替换为有效名称。DIRECT 是内置直连策略。示例体现由具体到兜底的顺序,并不是适用于所有人的完整规则表;已有订阅可能包含更精细的服务规则,合并时需要保留其必要逻辑。

rules:
  - DOMAIN-SUFFIX,github.com,PROXY
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - IP-CIDR,10.0.0.0/8,DIRECT,no-resolve
  - GEOIP,CN,DIRECT
  - MATCH,PROXY

no-resolve 用于避免某些地址规则为匹配域名而额外触发解析,并不表示关闭全部 DNS。它能减少不必要的解析,但也意味着只有已经具备目标地址等条件时,该规则才能按预期判断。地理地址数据也不是业务归属的绝对证明:内容分发网络、跨区域服务和地址分配变化,都会让单靠 GeoIP 的策略偏离实际访问需求。

规则集合与本地覆写各司其职

当规则数量增加时,可以通过规则提供者维护集合,再用 RULE-SET 引用。提供者通常需要声明行为类型、获取方式、存储路径与更新间隔,集合内容必须与声明类型相符。域名集合不能简单当作任意规则文本使用。初学阶段应先理解几条手写规则,再引入集合;否则发生误分流时,很难判断问题来自引用、下载失败还是集合本身。

新增一条规则后,先检查最终生效文件中它的位置,再访问目标并查看连接详情。若没有命中,依次确认目标实际域名、是否被前面的规则截获、应用是否只提供了地址,以及旧连接是否仍在复用。网站通常依赖多个域名,主页命中代理而登录接口直连,仍可能导致业务失败。应围绕实际连接补齐必要范围,而不是直接把所有流量改为同一种策略。

长期维护时给自定义规则写清原因,并把它们与订阅内容分开保存。过期例外可能让服务长期绕开新策略,因此每次业务恢复或规则集合更新后,都应复查是否仍有保留必要。Clash GeoIP 更新应纳入数据维护,而不是当成每次断网的通用修复。陌生术语可查阅术语手册;重点是让每条规则都能回答“为什么在这里、准备匹配谁、最终交给谁”。

七、TUN 与 DNS:扩大接管范围前先理解解析

TUN 解决入口问题,不替代出口配置

TUN 通过虚拟网络接口和路由把连接交给内核,适合不遵循系统代理的程序,以及需要统一处理更多协议流量的场景。它依赖系统权限、网络栈和客户端实现,不是所有平台都使用相同的开关或参数。桌面端启用前,应先确认系统代理路径已经可用,再暂停其他会修改路由的 VPN 工具,避免在基础出口尚未验证时叠加另一层故障。

开启后依次检查虚拟接口是否建立、目标流量是否进入连接列表、规则是否命中以及局域网资源是否仍然可达。若公司 VPN、容器网络或虚拟机同时存在,自动路由可能与它们的地址范围冲突。此时应按实际网络划定排除范围或选择另一种入口,不宜盲目反复切换网络栈。远程管理设备时尤其要谨慎,路由调整可能中断当前管理连接。

DNS 决定域名怎样变成连接目标

应用可能使用系统 DNS、浏览器安全 DNS,或自己内置的解析机制。客户端 DNS 配置只对进入其处理路径的查询产生作用,因此“已经填入解析服务器”与“所有查询都经过它”不是同一结论。排查 Clash DNS 泄漏时,应先明确希望哪些查询走哪条路径,再结合客户端日志和系统设置验证,不能仅凭一个网页测试就断定整个设备的行为。

Fake-IP 会为域名分配保留地址段内的映射地址,由内核保存域名与连接的对应关系,便于后续分流。它并非目标服务器真实地址,看到这类地址不一定代表解析异常。某些局域网发现、设备控制或校验真实地址的应用可能不适应这种机制,需要按用途设置过滤或使用其他解析模式;应优先缩小例外范围,而不是在不了解影响时整体关闭解析处理。

# mihomo 局部示例:监听端口与平台支持需先确认
dns:
  enable: true
  listen: 127.0.0.1:1053
  enhanced-mode: fake-ip
  fake-ip-range: 198.18.0.1/16
  nameserver:
    - https://dns.alidns.com/dns-query

tun:
  enable: true
  stack: mixed
  auto-route: true
  auto-detect-interface: true
  dns-hijack:
    - any:53

这段配置需要合并到有效的 mihomo 配置中,并不适用于所有图形客户端;客户端也可能通过界面重新生成这些字段。DNS 监听在本机端口本身不会自动修改系统解析设置,TUN 的 DNS 接管也不代表能够接管应用自行建立的加密解析连接。示例中的上游只是可选配置,不保证适合每个网络;选用前应考虑可达性、信任关系与当地网络要求。

遇到故障按影响范围回退

若打开 TUN 后全部访问失败,先关闭 TUN 并恢复先前已验证的入口,确认基础网络能否恢复,再检查权限、路由和 DNS 日志。若只有内网域名失败,应核对内网解析器、搜索域和路由,而不是直接换远端节点。若只是某个应用异常,可比较系统解析、应用解析和 Fake-IP 例外,定位差异。移动端还需兼顾后台策略,相关取舍见安卓耗电与后台运行排查。

八、日常维护:更新、备份与故障记录

分清四种更新对象

客户端更新、内核更新、订阅更新和规则数据更新是不同操作。客户端更新影响界面与系统集成;内核更新可能改变协议支持或字段行为;订阅更新调整节点与来源配置;GeoIP、GeoSite 或规则集合更新则影响匹配结果。出现变化时先确认发生了哪一种更新,避免把所有异常笼统归为“软件升级”。维护记录不必复杂,但应能还原变更前后的主要差异。

有稳定环境时,不要同时更新全部组件并顺手重写 DNS。先备份,再逐项变更,每完成一项就验证常用业务。桌面客户端若支持独立切换内核,也应先阅读兼容说明,而不是仅凭文件名替换可执行程序。保留上一份可用配置比保留大量来源不明的旧安装包更重要;回退时应一并考虑配置语法,旧内核未必能读取新增字段。

备份要包含意图,不只包含文件

有效备份应覆盖订阅来源、自定义规则、覆写内容、代理组选择和必要的系统集成说明。客户端导出的配置可能包含节点密码及订阅凭据,存放时应限制访问,不要提交到公开代码仓库。系统代理、开机启动和服务安装状态不一定包含在导出文件中,因此换设备后仍需重新授权并检查端口。备份文件的存在,也不等于已经验证可以恢复。

可以在不影响日常使用时测试一次恢复:建立临时配置,导入备份,检查策略引用和规则顺序,再回到原配置。跨客户端迁移时,先恢复通用 YAML 内容,再按新产品方式重建覆写和系统设置。不要整目录覆盖新客户端的数据目录;旧缓存、数据库或客户端专属字段可能并不兼容。迁移成功后仍保留原备份,直到常用场景全部验证完成。

排错记录应围绕一次具体失败

遇到故障,先记下发生时间、目标应用、目标域名、当前入口和所选策略,然后复现一次。日志临时调到更详细级别时,应注意磁盘占用和敏感信息暴露,排查结束后恢复合适级别。公开反馈只保留必要错误上下文,遮盖订阅、认证和个人路径;同时保留错误类型,过度裁剪到只剩“连接失败”会失去判断价值。

现象先确认下一步
所有应用同时失败基础网络、入口、内核状态关闭接管做直连对照
只有一个网站失败目标域名、规则与出口检查相关域名和连接复用
更新后无法载入错误行与字段兼容性恢复备份并逐项比较

Clash 开机自启还需要单独验收:重启后确认客户端是否启动、后台服务是否可用、配置是否载入以及接管是否符合预期。有的应用登录后才启动,有的服务先于桌面运行,不能用同一标准判断。自动更新订阅也要考虑首次联网条件;若下载订阅本身依赖尚未恢复的代理路径,应保留本地有效配置,避免启动时陷入获取配置与建立连接互相依赖的状态。

故障解除后,撤销临时全局模式、调试日志和过宽的例外规则,并写下一句原因与处理结果。不要把排错时的应急设置永久留在环境中。对于重复出现的问题,先在常见问题按基础认知、安装配置、使用技巧和故障排查查找对应条目;需要进一步求助时,提交可复现步骤和脱敏配置片段,比只提供一张失败截图更有用。

九、进阶路线:从可用配置走向可维护配置

以可验证目标推进,不以开关数量衡量

完成前八章后,进阶的重点不是开启全部功能,而是让配置能够解释、迁移和回退。先选一个明确目标,例如将工作服务固定到某个策略、让一组设备使用独立出口,或把重复规则拆成集合。为目标写出验收条件,再决定需要哪些字段。若现有规则已经解决问题,继续增加嗅探、脚本和复杂组链,反而会提高维护成本并扩大排错范围。

第一阶段可以把配置分为基础监听、DNS、节点来源、代理组与规则五个部分,标明各部分由谁维护。远程订阅负责节点,本地覆写负责个人需求,规则提供者负责可复用集合,这种职责划分比直接保存一个庞大文件更清晰。客户端若采用生成式配置,应同时理解输入文件和最终文件的区别;最终文件可以用来检查结果,却未必适合直接作为长期编辑入口。

先做静态检查,再做业务验证

独立使用 mihomo 时,可先通过配置测试检查语法及引用关系,再启动实际网络接管。下面的命令假设可执行文件已经加入命令搜索路径,且当前目录有待检查的配置。通过检查只能说明内核接受文件,不能证明节点凭据有效、上游解析可达或路由符合需求。图形客户端若提供配置验证功能,应优先使用其受支持入口,不要随意操作内部工作目录。

# 独立 mihomo:检查当前配置
mihomo -t -f ./config.yaml

# 独立 mihomo:指定配置文件运行
mihomo -f ./config.yaml

随后建立一份小型回归清单:一个直连目标、一个代理目标、一个局域网服务,以及实际需要的 UDP 或长连接业务。每次改动后分别检查入口、规则与出口,记录是否符合预期。测试目标应由使用者根据实际环境确定,不要把公开探测地址的结果直接当作业务质量。对于登录、支付或需要固定区域的服务,还要留意切换出口引起的账户风控和会话失效。

自动化和远程管理需要收紧边界

使用控制接口或面板前,先确认监听范围和访问认证。仅需本机管理时,应限制在回环地址;不要为了手机访问面板就直接向所有网络接口开放管理端口。确有局域网管理需求时,还需要配合访问控制和防火墙,并理解代理监听与控制接口是不同服务。开启局域网连接也不等于授权任意设备使用,网络暴露范围必须按实际需求限定。

服务器与路由器部署还需要学习服务生命周期:以何种用户运行、从哪个目录读取数据、重启后是否恢复、日志如何轮转,以及异常退出时如何处理。涉及透明代理、防火墙转发和策略路由时,应单独设计回退方案,避免在同一台远程设备上直接试验不熟悉的路由规则。先在可本地接触的测试环境验证,再迁移到长期运行设备,能降低失联风险。

持续学习时优先查阅当前内核与客户端的配置说明,尤其关注字段所属层次、默认行为和兼容限制。旧文章可以帮助理解原理,但不能代替对当前生效配置的观察。需要复习时,从本页核心概念重新画出流量路径;需要重建环境时,回到快速上手主线。能够说明每个设置解决什么问题、如何验证、如何撤销,才是配置从“暂时可用”进入“长期可维护”的标志。