先认识 Mihomo 的作用
Mihomo 是处理代理连接、DNS 和分流规则的内核。你在客户端选择节点、切换策略组后，实际的连接工作可以交给它完成。项目由 MetaCubeX 维护，官方入口是 MetaCubeX/mihomo，功能与配置说明见官方文档。
图形客户端负责提供窗口、订阅管理和设置入口，内核负责执行配置。两者可以一起打包，但不能把下载一个内核文件理解成安装了完整的桌面应用。Mihomo 本身也不附送机场账号、节点或套餐流量。
初次使用可以从图形客户端开始
Clash Verge Rev 官方介绍明确说明它内置 Mihomo 内核，并提供配置管理、策略组选择和系统代理等界面。使用它时，通常不需要另外下载一份 Mihomo；需要更新内核，也优先使用客户端提供的管理方式。
如果你希望通过按钮完成连接，可以按站内 Clash Verge Rev 入门教程操作：
- 安装适合设备系统和芯片架构的客户端。
- 导入服务商明确支持的 Clash / Mihomo 配置，确认节点或策略组已经出现。
- 选择节点，开启所需代理方式，再用浏览器验证实际访问。
服务商若只允许使用自家应用，应按它的要求连接。内核支持某个协议，不代表任何服务商都提供可导入的订阅。
独立下载内核时怎样选择文件
准备自行管理配置或在命令行运行时，再到官方发布页选择发布文件。官方安装页提供 Windows、Linux、macOS、FreeBSD 和 Android 的内核选项；Android 的内核产物也不能直接当作图形应用安装包。
先核对操作系统，再核对处理器架构。文件名中的 darwin 对应 macOS，amd64 对应常见的 x86-64 架构，arm64 用于相应的 ARM 设备；同一系统可能有多个构建选项。更细的文件标记和旧系统兼容性，按官方文件选择说明确认，不要只凭文件大小判断。
首次使用可先选正式发布版本，避免为了追新切换 Alpha。源码压缩包是项目代码，和已经编译好的内核文件不同。系统最低要求也要分别核对：某个图形客户端能否安装，不能由它内置的内核能否运行来推断。
配置文件里需要理解什么
Mihomo 使用 YAML 配置文件。首次尝试最好从服务商明确提供的兼容配置开始，保留一份备份，再阅读里面的设置。一个订阅网址、一个节点分享链接和一份完整配置不是同一件事；不要把网址文字直接保存成 config.yaml，也不要把只有节点列表的文件直接当成完整配置。
常见字段可以这样理解：
| 字段 | 作用 |
|---|---|
proxies / proxy-providers |
定义节点，或从配置指定的来源取得节点集合。 |
proxy-groups |
把节点组织成可手动选择或按策略使用的组。 |
rules |
决定哪些请求直连，哪些交给指定策略组。 |
mixed-port |
提供本机应用连接内核时使用的 HTTP/SOCKS 混合代理端口。 |
这张表用于帮助读懂配置，不是一份可以直接运行的配置模板。完整字段与示例见官方配置文档。编辑时保留节点认证信息和规则引用关系，遇到解析错误先看报错位置，不要批量删除看不懂的内容。
YAML 对大小写和缩进有要求，同一层级应对齐，缩进使用空格。经常遇到的错误是复制时丢失空格、把英文冒号改成中文冒号，或者把缩进混成 Tab。可对照官方语法说明检查。
用普通本地代理完成一次启动
下面的命令适合已经取得可信内核和完整配置、并能使用终端的读者。以普通本地代理配置为例，将解压后的可执行文件命名为 mihomo，将配置保存为同一目录内的 config.yaml，然后在该目录打开终端。macOS 和 Linux 上先确认文件具备运行权限，并按系统提示核对来源；Windows 对应的文件名为 mihomo.exe。
先检查配置：
./mihomo -d . -t -f ./config.yaml检查通过后，再启动：
./mihomo -d . -f ./config.yamlWindows PowerShell 将命令开头的 ./mihomo 换成 .\mihomo.exe。这里 -d . 指定当前目录存放运行所需文件，-f 指定配置文件，-t 在检查配置后退出。配置检查通过只表示该检查步骤成功，不代表节点可连接、订阅未到期或目标网站可用。
保持启动终端运行，查看是否有配置错误或端口占用提示。随后在需要使用代理的应用中填写本地地址 127.0.0.1，端口使用自己配置实际启用的值；例如配置中写的是 mixed-port: 7892，应用才填写 7892。混合端口的作用见官方代理端口说明。
启动内核与设置应用代理是两个步骤。普通本地代理不会因为进程已启动，就自动接管所有程序。先完成一个浏览器的访问验证，再考虑 TUN、路由器或后台服务等进一步配置。使用完毕先恢复应用的代理设置，再在终端按 Ctrl+C 停止内核，避免应用继续连接已经关闭的本地端口。
连接失败时按步骤排查
先区分失败发生在哪里：配置读不进去，检查格式和路径；提示端口被占用，检查是否已有其他代理客户端运行；节点能显示但网页打不开，再检查所选策略、节点状态及应用代理设置。一次只修改一个环节，便于判断哪项调整有效。
需要管理界面时，可以选择图形客户端，或按官方说明配置 Web 面板。Web 面板通过控制接口管理内核，和应用使用的代理端口不同；控制接口、访问密钥和局域网访问设置见官方全局配置。个人电脑使用时先保持仅本机访问，不要为了打开面板而把控制接口暴露到公网。
订阅链接和配置可能包含连接凭据，反馈问题时先删去这些内容。导入失败可看订阅更新失败排查；已连接却打不开页面，可看已连接但无法上网；需要提供日志时，按日志脱敏指南整理。
