mihoro 使用教程

发布日期: 2026-09-24更新日期: 2026-10-12平台: Linux(命令行)类别: 客户端下载配置

mihoro(原名 clashrup)是一个用 Rust 编写的 Linux Mihomo 命令行客户端,作者对它的描述是“不多不少”:负责安装、更新、应用覆写,并用 systemd 管理 Mihomo。

它最大的优点是 不需要 root 权限,以当前用户身份运行独立实例,非常适合没有管理员权限的实验室服务器、学校机房或共享主机,同时对订阅有一流的支持。

开发语言Rust
曾用名clashrup
运行环境Linux
权限无需 root,按用户运行
配置文件~/.config/mihoro.toml

本文只讲软件本身,不推荐具体服务商。客户端只是工具,节点需要另外订阅;如果还没有订阅,可以先看 性价比机场挑选与防坑指南。

官方项目地址:https://github.com/spencerwooo/mihoro

安装

执行 README 中的一行安装命令即可,程序默认安装到 ~/.local/bin,请确认该目录在 PATH 中。访问 GitHub 困难时,可以在命令后附加 --mirror 参数指定 GitHub 加速镜像。

一条命令完成初始化

mihoro init

首次运行时会提示输入机场的 Clash / Mihomo 订阅链接,然后自动完成:

  1. 下载 mihomo 内核;
  2. 下载订阅配置并应用本地覆写;
  3. 下载 Geo 数据和默认的 MetaCubeXD 网页面板;
  4. 安装并启用用户级 mihomo.service;
  5. 启动服务并输出面板地址。

设置环境变量 MIHORO_GITHUB_MIRROR 后,init 和 update 下载 GitHub 资源时会走镜像。

日常使用

服务启动后,在终端里设置 http_proxy / https_proxy 环境变量指向 mihomo 的本地端口,即可让 git、curl、pip 等命令行工具走代理。订阅更新使用 mihoro update,节点切换在网页面板中完成。

常见问题 (FAQ)

没有 root 权限也能开 TUN 吗?

不能。TUN 需要创建虚拟网卡,必须有 root 权限。mihoro 以用户身份运行,主要通过 HTTP / SOCKS 代理端口工作。

安装后提示 command not found?

把 ~/.local/bin 加入 PATH,例如在 ~/.bashrc 中添加 export PATH=$HOME/.local/bin:$PATH 后重新登录。