
确认架构与运行条件
使用uname查看架构。x86_64通常对应amd64,aarch64通常对应arm64;还需核对发行包的CPU指令要求。不要在旧处理器上直接选择要求更高指令集的构建。发行包应来自Mihomo项目,选择稳定发行说明中的适配文件。
uname -m
uname -s以下示例假定已经解压并把适配的二进制命名为mihomo,放在当前目录。它不会自动下载软件。普通本地代理监听无需直接以root启动;TUN、低端口或系统路由修改涉及额外权限,应另行按项目文档配置。
准备独立配置目录
创建用户可读写的配置目录,并把自己的有效配置保存为config.yaml。示例采用用户目录,避免依赖某个客户端的私有数据路径。配置可能含密钥,限制文件权限,不要把订阅文件放入公开网站目录。
mkdir -p "$HOME/.config/mihomo"
chmod +x ./mihomo
./mihomo -v
# 将已有的有效配置保存为:
# $HOME/.config/mihomo/config.yaml版本输出用于记录实际运行的核心,并非固定版本推荐。配置文件仍需自行准备;只有二进制文件不能产生可用节点。包含代理集合或规则集合的配置,还可能需要下载额外资源,因此文件完整与网络可达性都要检查。
先检查,再前台启动
./mihomo -t -d "$HOME/.config/mihomo"
./mihomo -d "$HOME/.config/mihomo"-d指定配置目录,-t检查配置后退出;默认配置文件名为config.yaml。需要指定其他文件时可使用-f。检查报错先修复缩进、类型和引用名称;检查通过仅表示配置能够加载,不保证节点或每个目标网站可用。
前台运行时保留终端,观察监听地址与错误日志。不要把关闭终端后的进程退出当成安装失败。当前示例未开启TUN,也没有修改系统代理;应用需要明确连接到配置中设置的本地端口。
按错误类型检查
- Exec format error:架构或二进制格式不匹配。
- Permission denied:检查执行权限、目录权限与挂载限制。
- Address already in use:端口被占用,先确认已有服务。
- 配置解析失败:查看日志给出的字段和行号。
- 请求失败:核对节点、DNS、规则及资源下载结果。
日志中出现外部控制器并不等于浏览器流量已被接管。代理端口与控制API是两种不同用途;只需本机访问时,限制监听地址,不要把管理端口暴露到公网。
验证后再建立运行服务
需要常驻运行时,可参考项目的systemd服务文档。系统服务中的用户、配置目录、可执行路径和权限必须与实际部署一致,不能把前台命令里的用户目录原样塞入另一个运行用户的服务。先验证服务用户能读取配置和依赖资源。
远程服务器修改TUN或路由前,保留控制台或可恢复的管理通道。不要在唯一SSH连接中直接尝试未验证的全局路由。基础配置字段可继续阅读YAML与代理设置。