02 / INSTALLATION
Mihomo Windows与Linux安装部署、配置准备及首次运行方法
先在明确的目录里完成版本查询与配置验证,再决定是否交给客户端或服务管理器长期运行。不同系统采用各自的执行方式。

MAKE THE FIRST RUN REPEATABLE
让每个路径都有来处,
让每次启动可复现。
程序文件、配置目录和当前工作目录并不是同一个概念。准备好可信配置,保留启动参数,首次排错会直接得多。
部署前,把环境和文件准备齐
确认系统、CPU架构与兼容条件
Windows从系统信息查看系统类型,Linux用uname -m查看架构。根据平台与发布文件对照选择资源,不仅看文件后缀。
解压到可管理的实际目录
保留原始包名与版本记录。不要把压缩包内的文件直接当作已安装程序,也不要与客户端托管目录混用。
准备可信的配置与所需资源
明确主文件、配置目录及访问权限;首次检查可使用独立数据目录,避免影响已有运行实例。
Windows:在PowerShell里保留输出
示例假设程序解压后命名为mihomo.exe,终端位于程序目录。所有路径需替换为实际位置;空格路径加引号。先查询版本与帮助,再验证配置:
.mihomo.exe -v
.mihomo.exe -h
.mihomo.exe -t -d 'C:Mihomocheck-data' -f 'C:Mihomoconfig.yaml'准备启动时,使用已核对的运行数据目录和同一份配置。以下命令会实际运行核心,仅在准备好自己的环境后执行:
.mihomo.exe -d 'C:Mihomodata' -f 'C:Mihomoconfig.yaml'窗口没有图形菜单是独立命令行内核的正常形态之一。保持终端开启以观察日志,退出时通常用Ctrl+C请求结束。详细说明见Windows二进制程序运行笔记。
Linux:先前台运行,再考虑服务管理
对已核对来源和架构的可执行文件设置所需权限,先用普通账户验证版本。下面的程序名与/path/to/路径均为示例,应在实际解压目录中调整:
chmod u+x ./mihomo
./mihomo -v
./mihomo -t -d /path/to/check-data -f /path/to/config.yaml
# 准备好运行环境后,以前台方式启动
./mihomo -d /path/to/runtime-data -f /path/to/config.yaml配置检查可能初始化目录或加载资源,不能当作完全只读操作。对于采用systemd的发行版,长期运行可由服务管理器接管;先核对账户、目录与既有单元。Linux服务管理笔记提供字段阅读和只读状态查询,其他初始化系统应使用各自机制。
首次运行的检查顺序
| 检查对象 | 要确认的事实 | 下一步 |
|---|---|---|
| 程序版本 | 执行的是目标文件,没有混用其他客户端核心 | 记录完整路径与版本输出。 |
| 配置文件 | 路径明确、当前版本能够加载 | 失败时阅读配置检查文章。 |
| 进程与日志 | 程序保持运行,未在初始化阶段退出 | 保存第一条明确错误及上下文。 |
| 监听与请求 | 端口成功建立监听,应用使用正确地址 | 再单独验证实际连接。 |
配置报错时,按文件路径与有效性检查逐项处理;启动后仍有问题,转到使用指南的分阶段诊断。不要通过全局关闭防火墙或重复运行多个实例来“试通”。


