Clash/Mihomo 配置通常使用 YAML。新手不必一开始就手写完整配置，但应能看懂几个关键部分：基础端口、运行模式、节点、代理组和规则。修改前先备份，因为 YAML 对缩进非常敏感。
一份配置通常包含什么？
| 字段 | 作用 | 常见问题 |
|---|---|---|
| mixed-port | 本地 HTTP/SOCKS 混合代理端口 | 端口被占用会导致启动失败 |
| mode | 选择 rule、global 或 direct 等运行模式 | 误用 direct 会表现为没有走节点 |
| proxies | 具体节点列表 | 格式、协议参数或证书设置错误 |
| proxy-groups | 手动选择、自动测试或回退等策略组 | 引用了不存在的节点或组 |
| rules | 从上到下匹配流量的规则 | 顺序不当导致规则提前命中 |
| rule-providers | 从文件或远程地址加载规则集合 | 下载失败、路径或行为类型不匹配 |
| dns | 域名解析策略 | 错误设置可能导致网页无法解析 |
最小的基础结构示例
mixed-port: 7890
mode: rule
log-level: info
proxies:
- name: example-node
type: socks5
server: 127.0.0.1
port: 1080
proxy-groups:
- name: PROXY
type: select
proxies:
- example-node
- DIRECT
rules:
- MATCH,PROXY这个片段只用于展示层级关系，不是可直接使用的公共节点配置。实际协议参数应由你自己的服务提供方或自建服务生成。
YAML 缩进为什么重要？
YAML 用空格表示层级。建议统一使用两个空格，不要混用 Tab。列表项以连字符开头，冒号后通常需要空格。编辑器提示某一行错误时，问题也可能来自它上方的缩进或未闭合引号。
规则为什么强调从上到下？
Mihomo 会按顺序匹配规则，命中后采用对应策略。范围较大的规则放得太靠前，会让后面的精细规则失去作用。兜底的 MATCH 通常放在最后。使用远程规则集时，还要确认来源可信并定期维护。
订阅配置可以直接编辑吗？
可以临时修改，但下次更新订阅时可能被覆盖。需要长期保留的本地规则，应使用客户端提供的覆写、合并或脚本功能，并逐项测试。刚开始时，优先使用服务商原始配置，避免把节点故障和自定义配置错误混在一起。
修改前后的检查清单
- 保存原始配置备份；
- 一次只改一项，记录修改内容；
- 使用客户端的配置检查功能；
- 确认端口没有被其他程序占用；
- 确认代理组引用的节点和组真实存在；
- 把 MATCH 等兜底规则放在合适位置；
- 出现问题时先恢复原始配置。
官方资料
如果配置能加载但仍无法连接，回到Clash 节点故障排查清单，先区分配置错误与节点问题。
内容说明：本文由 HowOClash 编辑部根据项目官方文档与公开发布记录整理。软件界面和版本可能变化；发现步骤失效时，请以官方文档为准，并查看内容与测试说明。
