首页 / DOCUMENTATION / CHINA REGION配置有结构 · 连接有依据
THE CONFIGURATION STUDIO

Mihomo(中國區)

让网络配置,
清晰而有序。

Mihomo中國區围绕代理内核、配置基础与规则管理整理使用路径。理解策略选择与 DNS,在多平台环境中检查网络状态,逐步定位连接与配置问题。

Mihomo结构化配置工作空间原创场景示意
FIG. 01 / CONFIGURATION WORKSPACE原创场景示意 · 非实时输出
01 / UNDERSTAND THE CORE

从内核出发,
理解连接的每一层。

Mihomo内核按照配置处理连接、匹配规则并选择出口。配置文件描述监听端口、解析行为和策略关系;图形客户端则提供操作界面,两者有不同的职责。内核不会自动提供可用的代理服务,导入文件也不等于连接已经建立。

Mihomo中國區将这些概念拆成可阅读、可验证的章节。先确认设备和文件来源,再检查配置结构,最后通过日志验证实际路径。这里的技术界面均为教学示意,不代表正在运行的服务或实时监测数据。修改前保留本地副本。

阅读 Mihomo使用教程
02 / STRUCTURE BEFORE SETTINGS

配置不是参数堆叠,
是一套有序关系。

Mihomo配置从入口到出口逐层组织:先确定本机监听,再理解规则如何引用策略,最后检查解析路径。读懂层级,比反复粘贴整份配置更容易找到问题。

CONFIGRULESDNSDEVICESTATUS
configuration / structure.yaml···
CONFIG
RULES
DNS
DEVICE
01# 教学结构 · 全部直连
02mixed-port: 7890
03allow-lan: false
04mode: rule
05rules:
06 - MATCH,DIRECT
结构说明 / 非运行状态LOCAL REFERENCE ONLY
多平台设备集成与配置阅读场景
原创场景示意 · 非客户端截图STUDIO / REFERENCE
03 / ONE CORE, DIFFERENT ENVIRONMENTS

同一套思路,
不同的系统边界。

Mihomo中國區按设备梳理架构、权限与配置入口。前端兼容性以各项目说明为准。

04 / A REPEATABLE WORKFLOW

从第一次阅读,
到一次有效验证。

  1. 01
    了解内核与前端

    明确执行连接与图形操作的职责。

  2. 02
    确认设备系统

    记录系统版本、芯片架构与权限。

  3. 03
    阅读平台指南

    核实来源后选择适合的集成方式。

  4. 04
    检查配置结构

    先处理缩进、字段和策略引用。

  5. 05
    验证连接状态

    依次观察进程、端口与目标请求。

  6. 06
    定位常见问题

    一次调整一项,并保留回退记录。

内核获取,先看来源再选文件。

Mihomo下載说明集中介绍发布来源、平台架构、文件格式与压缩包检查;校验值应与可信发布源交叉核对。版本兼容和权限需求需逐项阅读,不以文件名判断可信度。

查看获取与安装说明
05 / RULE PRIORITY

先后有序,
匹配才有依据。

Mihomo规则通常从上向下匹配。具体条件放在宽泛条件之前,兜底规则置于末尾;策略名称需要与引用一致。修改顺序后,观察实际连接匹配了哪一条规则。

  1. 01 · 具体域名与例外 SPECIFIC
  2. 02 · 分类与集合规则 GROUPED
  3. 03 · 末尾兜底策略 FALLBACK
理解规则优先级
规则优先级与策略引用编辑台示意
原创场景示意 · 非客户端截图STUDIO / REFERENCE
06 / READABLE CONFIGURATION

把 YAML 读清楚,
再开始改动。

键值对描述设置,列表承载规则,缩进表达层级。用空格保持同级对齐,报错时也检查上一行。示例用于理解本地配置,不包含账号、密钥或代理线路。

阅读 YAML 配置教程
config.yaml / 教学示例
# 教学示例:仅本机监听、全部直连
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
rules:
  - DOMAIN-SUFFIX,example.com,DIRECT
  - MATCH,DIRECT

示例仅本机监听、全部直连;不启用 DNS 接管。

DNS解析路径与网络检查工作站示意
原创 DNS 知识场景示意STUDIO / REFERENCE
07 / RESOLVE BEFORE CONNECT

连接之前,
先理解解析。

Mihomo DNS 设置需要结合系统、应用与网络环境判断。查询来源、处理路径和缓存都会影响判断。先确认当前解析路径,再比较结果,不存在适合所有网络的固定最优参数。

应用查询→解析路径→上游结果
检查 DNS 基础知识
08 / DESKTOP

Windows:
从本地监听开始。

Windows 使用教程

先确认系统架构和内核文件,使用终端观察本地配置加载结果。检查防火墙权限、系统代理和 DNS 时,保留原有设置;内核退出后,清理不再使用的代理入口。

09 / MOBILE ENVIRONMENTS

移动端,
多理解一层系统。

Android 与 iOS 的权限和后台机制不同。安装前核实应用来源及兼容说明,切换 Wi-Fi 与移动数据后重新观察连接。系统显示网络扩展已连接,只能说明入口状态,不能替代目标请求验证。

手机与平板配置阅读工作区示意
原创场景示意 · 非客户端截图STUDIO / REFERENCE
10 / MAC & MORE

macOS 与其他系统:
确认运行边界。

macOS 使用指南

区分 Apple 芯片与 Intel 架构,理解终端运行和第三方前端的区别。检查网络服务顺序、代理状态和 DNS;Linux 等环境则应额外核对服务用户、配置路径与文件权限。

现代服务器机柜与研发基础设施场景
原创研发环境示意 · 非本站机房STUDIO / REFERENCE
11 / OBSERVE, THEN ADJUST

用观察建立判断,
让排查可以复现。

网络体验受设备、信号、解析和目标服务影响。固定条件,分别观察延迟、丢包与传输表现;单次结果不能说明稳定性,图中设备也不代表本站资产。

阅读连接检查步骤
13 / FREQUENT QUESTIONS

先把问题,
问清楚。

从格式、规则到设备权限,拆开常见疑问。

查看全部常见问题
代理内核是什么?
它是处理代理连接、规则匹配和策略选择的网络代理内核。使用前需要准备合适的运行环境与配置文件,内核本身不提供网络线路。
内核和图形客户端有什么区别?
内核执行连接逻辑,图形前端负责配置编辑、操作入口和状态展示。第三方前端的发布者、权限与更新周期需要分别核实。
配置文件通常采用什么格式?
常见格式为 YAML。键值、列表和缩进共同描述配置结构,应按当前内核文档确认字段含义。
YAML 缩进错误如何排查?
显示编辑器空白符,统一使用空格,检查报错行及上一行。先验证语法,再检查字段名称与引用关系。
规则优先级如何理解?
通常按列表自上而下匹配,较具体的规则应放在较宽泛规则前。兜底规则放在末尾,并以实际连接日志验证。
DNS 解析异常先检查什么?
比较系统与应用使用的解析路径,再检查上游地址、缓存和网络可达性。一次调整一个变量,避免直接套用其他设备的配置。
Windows 如何检查连接状态?
先确认内核进程和监听端口,再核对系统代理地址,最后检查目标连接。端口可达不等于所有网站都可用。
Android 和 iOS 如何选择兼容前端?
核实发布者、支持的内核或配置格式、权限说明与更新记录。两种系统的集成方式不同,不能只凭应用名称判断兼容性。

下一步,从一份文档开始。

Mihomo官網相关信息请以可核验的上游来源为准。