02 / INSTALLATION

Mihomo Windows与Linux安装部署、配置准备及首次运行方法

先在明确的目录里完成版本查询与配置验证,再决定是否交给客户端或服务管理器长期运行。不同系统采用各自的执行方式。

笔记本、计算设备与安装工具整齐放在灰色实验工作台上
MAKE THE FIRST RUN REPEATABLE

让每个路径都有来处,
让每次启动可复现。

程序文件、配置目录和当前工作目录并不是同一个概念。准备好可信配置,保留启动参数,首次排错会直接得多。

部署前,把环境和文件准备齐

  1. 确认系统、CPU架构与兼容条件

    Windows从系统信息查看系统类型,Linux用uname -m查看架构。根据平台与发布文件对照选择资源,不仅看文件后缀。

  2. 解压到可管理的实际目录

    保留原始包名与版本记录。不要把压缩包内的文件直接当作已安装程序,也不要与客户端托管目录混用。

  3. 准备可信的配置与所需资源

    明确主文件、配置目录及访问权限;首次检查可使用独立数据目录,避免影响已有运行实例。

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服务管理笔记提供字段阅读和只读状态查询,其他初始化系统应使用各自机制。

首次运行的检查顺序

检查对象要确认的事实下一步
程序版本执行的是目标文件,没有混用其他客户端核心记录完整路径与版本输出。
配置文件路径明确、当前版本能够加载失败时阅读配置检查文章。
进程与日志程序保持运行,未在初始化阶段退出保存第一条明确错误及上下文。
监听与请求端口成功建立监听,应用使用正确地址再单独验证实际连接。

配置报错时,按文件路径与有效性检查逐项处理;启动后仍有问题,转到使用指南的分阶段诊断。不要通过全局关闭防火墙或重复运行多个实例来“试通”。