暖铜色工作灯照亮深蓝建筑图纸与现代档案柜
Mihomo / 配置字段手册

Mihomo YAML配置
让每一条规则,
有据可循。

从文件层级到策略选择,读懂配置之间的关系。
整理订阅来源,管理代理节点,让规则按预期工作。

THE ARCHITECTURE OF CONFIGURATION 配置 · 来源 · 策略 · 规则
01 / CONFIGURATION FIELDBOOK

先看结构,再写配置。

一份配置如同一套图纸:每个层级负责一件事,引用将它们连接起来。

02 / READ THE INDENTATION

空格之中,
有清晰的层级。

YAML用缩进表达关系。键值、列表、注释与字符串各有边界;先读懂父级,再修改字段。

  • 用空格缩进,同级字段保持对齐
  • 短横线声明列表项,子字段归属明确
  • 特殊字符串使用引号,注释放在合适位置
从缩进与语法错误开始 →
半透明描图纸的层级与建筑线条
YAML · 演示片段,不用于真实连接
mode: rule
log-level: info

proxy-groups:
  - name: "手动选择"
    type: select
    proxies:
      - DIRECT

rules:
  - MATCH,手动选择
03 / CONFIGURATION FIELDBOOK

来源有序,选择才清楚。

Mihomo订阅管理与代理设置是相连的两个层次:先确认节点从哪里来,再决定如何选择。

现代制图档案柜中的分类文件与开放抽屉
SOURCE / 节点来源

把来源和内容,分别管理。

本地proxies适合直接维护节点;proxy-providers描述http、file或inline来源。格式、路径与更新间隔需要分别核对。

整理订阅与节点 →
三组有序资料、模型材料与金属圆规
POLICY / 代理组

同一批节点,不同选择方式。

select
手动指定候选
url-test
根据检测延迟选择
fallback
按顺序选择可用候选
理解三种代理组 →
04 / ORDER MATTERS

规则的顺序,
就是阅读的顺序。

Mihomo规则分流通常由上到下匹配。先安排精确例外,再处理较宽条件,最后交给兜底策略。

  1. DOMAIN完整域名的精确条件
  2. DOMAIN-SUFFIX域名本身与子域名范围
  3. RULE-SET引用已定义的规则集
  4. MATCH此前未匹配请求的兜底

这是常见组织思路,具体规则仍需按实际需求安排。规则命中不等于远端连接一定成功。

阅读规则分流指南 →
分层交通工程线路蓝图与金属绘图三角尺
精确条件优先放置,宽条件留出边界。
归档工作台上的版本资料、笔记本与文件夹05 / KEEP A WORKING COPY

更新之前,留好原稿。

备份主配置与必要的来源文件。订阅更新后,对照远程内容、本地缓存、组引用和加载状态,确认变化停在哪一层。

排查订阅更新 →
放大镜、校对铅笔与建筑立面检查图纸06 / CHECK EACH LAYER

检查通过,还要确认生效。

YAML语法、字段引用、核心加载、节点可用与业务连接是五个状态。按日志逐层判断,避免对着错误文件反复修改。

查看配置检查方法 →
设计研究工作室的建筑模型、工程文档与暖色台灯
EDITOR'S DESK / 技术专题

读字段的变化,
也读变化的边界。

配置资讯关注兼容核对、来源格式、规则集维护和备份方法。以具体技术问题组织阅读,不把教程当作版本发布公告。

进入新闻资讯 →
07 / CONFIGURATION FIELDBOOK

六份手记,一条清晰的路径。

从一处缩进错误,到一次完整的配置验证。按问题阅读,也可以循序查阅。

YAML缩进与层级专题:分层描图纸与金属工程尺
FIELD NOTE 01 / 配置基础

YAML缩进与层级

从报错行向上检查父级键、空格、列表和字符串,区分YAML解析错误与Mihomo字段错误,逐步恢复可加载的配置文件。

阅读手记
节点来源与提供者专题:独立文件夹与档案抽屉
FIELD NOTE 02 / 来源管理

节点来源与提供者

比较主配置中的proxies与http、file、inline节点提供者,梳理名称、路径和代理组use引用,避免格式混用与来源冲突。

阅读手记
代理组策略选择专题:分类资料与绘图器具
FIELD NOTE 03 / 策略设计

代理组策略选择

理解手动选择、延迟检测和顺序回退的差异,核对proxies与use引用,判断策略变化的作用范围与检测局限。

阅读手记
规则顺序与命中专题:工程线路手稿与平行尺
FIELD NOTE 04 / 规则阅读

规则顺序与命中

通过精确域名、后缀、规则集和兜底的匹配过程,检查活动配置与策略引用,区分规则命中和远端连接结果。

阅读手记
订阅更新与缓存专题:版本资料与归档记录
FIELD NOTE 05 / 更新维护

订阅更新与缓存

沿远程内容、本地缓存、提供者解析、代理组引用和活动配置逐层检查,定位订阅刷新后节点未变化的原因。

阅读手记
配置验证与生效专题:放大镜与图纸检查工作台
FIELD NOTE 06 / 问题排查

配置验证与生效

用五层状态排查配置未生效的问题,核对YAML、字段引用、活动路径、加载日志和新连接,并介绍准确的配置测试参数。

阅读手记
REFERENCE / 常见问题

写配置时,
你可能会问。

这份Mihomo使用教程从实际字段与状态出发,给每个问题找到对应层级。

了解资料整理方式 →
Mihomo YAML配置为什么对缩进和空格有要求?

缩进决定键值与列表的归属。使用空格并保持同级对齐,不能用Tab代替普通缩进。检查层级与常见语法错误。

proxy-providers与proxies分别表示什么?

主配置的proxies直接定义节点,proxy-providers管理节点内容的来源;代理组通过use引用提供者。理解节点来源的区别。

规则已写入文件,为什么连接仍不符合预期?

先确认活动配置已加载,再查是否命中更靠前的条件,并核对目标代理组当前选项。阅读规则顺序排查。

订阅更新后,需要检查哪些状态?

检查拉取结果、缓存内容、提供者解析与代理组引用。修改主配置时还应确认核心加载成功。按更新链路逐项核对。