现代模块化计算实验室中的银灰工业计算模块、精密板卡与琥珀状态灯
Mihomo / CORE HANDBOOK

Mihomo内核下载、
安装部署与
运行维护指南

从选择正确的二进制文件开始。了解不同平台的核心程序运行方式,做好配置检查与每一次版本维护。

开源网络代理核心WINDOWS / LINUX / macOS
银灰无风扇计算机、ARM板卡与笔记本组成的硬件环境
01 / UNDERSTAND THE CORE程序 · 配置 · 进程
THE ENGINE, EXPLAINED

认识内核,
从三个组成部分开始。

Mihomo是一款开源网络代理核心。预编译程序负责执行,配置文件描述运行行为,启动后的进程承担实际工作。它们相互关联,也需要分别检查。

核心程序

按操作系统与CPU架构选择的二进制文件。

配置文件

明确加载位置,核对版本支持与资源依赖。

图形客户端

可额外管理核心;独立内核不必然自带图形界面。

了解核心的运行方式
01 / RELEASE ASSETS

读懂文件名,比反复下载更有效。

Mihomo GitHub Releases中的每一段标记,都对应一个需要核对的条件。文件选择不只看扩展名。

mihomo-linux-amd64-v1-<版本>.gz文件命名示意,不表示当前发布号或实时资源列表。
01 / SYSTEM

操作系统

windows、linux或darwin,先与目标系统对应。

02 / ARCHITECTURE

处理器架构

AMD64与ARM64是不同架构,不能仅凭设备外观选择。

03 / BUILD

构建与兼容

v1/v2/v3涉及AMD64指令集等级,应核对CPU能力。

04 / CHANNEL

Release与Alpha

结合变更和已知问题评估,不做绝对稳定性判断。

02 / FIRST RUN

一次清楚、可复现的首次运行。

Mihomo安装教程从环境核对开始,直到读取配置并观察进程。下载完成,只是流程的起点。

  1. 确认目标环境

    记录系统类型与实际CPU架构。

  2. 选择适配文件

    核对发布、架构与构建要求。

  3. 解压查询版本

    确认文件完整并能执行。

  4. 准备配置目录

    明确主配置与依赖资源位置。

  5. 执行配置检查

    用对应版本验证可信配置。

    检查方法 ↗
  6. 观察运行状态

    区分进程、监听与实际连接。

    完整部署步骤 ↗
03 / RUNTIME ENVIRONMENTS

同一个核心,不同的运行环境。

Mihomo Windows与Mihomo Linux的程序获取逻辑相近,执行权限、终端与服务管理方式则各有不同。

笔记本与银灰计算设备摆放在整洁的安装工作台上
WINDOWS / EXECUTABLE

先保留一个能看见日志的窗口。

在PowerShell中使用明确的程序路径和配置参数。没有图形界面并不等于内核无法运行,双击闪退也需要从输出中找原因。

Windows运行笔记
机架服务器的银色面板、网线与状态指示灯
LINUX / PROCESS & SERVICE

从前台验证,走向可管理的服务。

检查架构、执行权限和工作目录。采用systemd的环境可以管理长期运行;服务名称与账户权限仍需以实际部署为准。

Linux服务管理笔记
04 / CHECK, THEN OBSERVE

“检查通过”,
还不是运行的全部答案。

Mihomo使用指南把验证分成几个阶段。先判断问题出现在哪一层,再改动相关设置。

工业设备接线、终端显示器与运行观察记录进入运行诊断指南
01

文件与路径

当前程序读取的是哪份配置?目录与资源是否存在?

02

配置有效性

格式、参数与版本是否匹配?先处理第一个明确错误。

03

进程与监听

程序是否保持运行?目标端口是否被其他进程占用?

04

实际连接

应用是否指向正确地址?本地监听不代表远端服务可用。

05

保留排查记录

记录时间与错误阶段,分享前去除凭据与敏感地址。

从日志缩小问题范围
05 / VERSION MAINTENANCE

更新之前,
先留好回去的路。

查找Mihomo最新版时,也要核对变更说明、系统要求和当前配置。

BEFORE

记录与备份

保存版本、程序、配置与启动方式,确认备份可用。

DURING

停止与替换

等待目标进程退出,再更换已核对的新文件。

AFTER

验证与保留

重新检查配置、日志与实际请求,保留旧版恢复依据。

FIELD NOTES / 01—06

把具体问题,逐个讲清楚。

六篇独立技术笔记,覆盖文件获取、核心执行、配置验证和持续维护。按眼前的问题选择阅读入口。

ARM单板计算机与x86主板、银灰散热外壳并列放在防静电工作台上
NOTE 01 / 文件选择

Mihomo GitHub发布文件怎么选?理解Windows、Linux、AMD64与ARM64命名

从操作系统、CPU架构、指令集等级和压缩格式逐项识别Mihomo发布文件,了解Release与Alpha的区别及运行前的核对方法。

阅读技术笔记 ↗
银灰工作台上的深灰笔记本、USB存储设备和紧凑型工业计算机
NOTE 02 / Windows运行

Mihomo Windows程序解压后如何运行?理解命令行内核与图形客户端区别

解释Mihomo Windows核心解压后没有图形窗口的原因,示范在PowerShell中查询版本、指定配置路径、检查日志与正常退出。

阅读技术笔记 ↗
小型设备间内银灰机架服务器、整齐的网线和琥珀状态指示灯
NOTE 03 / Linux部署

Mihomo Linux运行与systemd管理:配置目录、服务状态和日志检查

从Linux前台运行过渡到systemd服务管理,说明程序路径、执行权限、服务账户、配置目录和日志检查,区分手动进程与服务实例。

阅读技术笔记 ↗
代码编辑工作环境中的笔记本、展开的工程记录本、银色笔与黑色电路板
NOTE 04 / 配置检查

Mihomo配置文件检查不通过怎么办?理解文件路径、参数验证与错误定位

用明确的程序版本、配置路径和独立检查目录定位Mihomo配置错误,解释YAML格式、资源加载与检查通过后的验证边界。

阅读技术笔记 ↗
工作台上的网线测试仪、以太网连接器、网络设备端口和检修记录本
NOTE 05 / 运行诊断

Mihomo启动失败如何排查?从进程状态、监听端口到运行日志逐步定位

按进程执行、配置解析、本地监听和实际连接四个阶段排查Mihomo启动失败,提供Windows与Linux查询方法和日志记录要点。

阅读技术笔记 ↗
灰色工程台面上的两块外置固态硬盘、拆开的存储外壳和USB连接线
NOTE 06 / 版本维护

Mihomo内核更新前需要备份什么?版本替换、运行验证与回退流程

整理Mihomo升级前的版本记录、程序与配置备份、停止替换、更新后验证和失败回退步骤,避免无备份覆盖正在运行的内核。

阅读技术笔记 ↗
A FEW PRACTICAL ANSWERS

开始之前,
你可能还想知道。

Mihomo内核与带图形界面的客户端有什么区别?

核心执行配置并处理连接,图形客户端通常还提供界面、配置管理与启停控制。独立内核不保证有图形窗口,具体执行方式见Windows核心程序说明。

下载文件时如何判断应该选择AMD64还是ARM64?

查看目标设备的系统信息和CPU架构。x86_64通常对应AMD64,aarch64通常对应ARM64;还要核对系统和构建要求,详见架构识别方法。

配置文件检查通过后,为什么仍可能无法正常连接?

配置验证、成功监听和远端可用是不同阶段。检查应用代理地址、进程与对应请求日志,可按诊断顺序逐层排查。

替换内核文件之前,需要保留哪些原始设置?

至少保存原程序、实际配置、依赖资源与启动参数;服务部署还应保留单元和账户信息。完整准备见升级备份清单。