mihomo-deploy

Mihomo 服务器部署指南

通过 Claude Code 的 mihomo-deploy skill，在没有 root 权限的 Linux 服务器上一键部署 mihomo 代理内核 + Metacubexd 网页面板。

---

准备工作

• 已通过 SSH 连接到目标服务器
• 手中有机场提供的订阅 .yaml 配置文件

---

方案一：最快部署（全部默认）

只需提供你的 config.yaml，其余全部使用默认值：

项目	默认值
代理端口（mixed-port）	7890
面板控制端口	9090
控制器绑定地址	127.0.0.1（本地回环，需 SSH 隧道访问）
密码	无（可选）

操作步骤：

1. 打开 Claude Code，直接说：

   帮我在服务器上部署 mihomo，配置文件在 ~/config.yaml

2. Claude 会自动完成所有步骤，最后给你两段配置贴入本地 ~/.ssh/config 和服务器 ~/.bashrc，配置方式见 本地 SSH 配置参考。

3. 断开并重新与服务器建立 SSH 连接，在本地浏览器访问：

   http://127.0.0.1:9090/ui
   

4. 在面板中选择节点后，验证代理生效：

   curl ip-api.com
   

   返回结果应为代理节点的 IP，而非服务器本身的 IP。

---

方案二：进阶部署（自定义配置）

如果你需要修改端口、让面板可从外网访问，或设置访问密码，在和 Claude 对话时一并说明即可。

常见自定义示例：

改代理端口：

帮我部署 mihomo，配置文件 ~/config.yaml，代理端口改成 7891

面板改为全局监听（可直接用公网 IP 访问，不需要 SSH 隧道）：

帮我部署 mihomo，配置文件 ~/config.yaml，面板控制器绑定 0.0.0.0:9090，密码设为 your-password

⚠️ 全局监听时必须设置密码，否则任何人都能访问你的面板和代理。

同时自定义多项：

帮我部署 mihomo，配置文件 ~/config.yaml，代理端口 7891，面板端口 9191，控制器绑定本地，密码 abc123

---

本地 SSH 配置参考

部署完成后，Claude 会给出你的服务器对应的 SSH 隧道配置，格式如下：

Host your-server
  HostName <服务器IP>
  User <用户名>
  LocalForward 127.0.0.1:9090 127.0.0.1:9090   # 面板 若自定义则需自行修改 地址和端口号
  LocalForward 127.0.0.1:7890 127.0.0.1:7890   # 代理 若自定义则需自行修改 端口号

将其添加到本地的 ~/.ssh/config，重新连接后生效。

---

后续维护

重启服务（修改配置后执行）：

systemctl --user restart mihomo

查看运行日志：

journalctl --user -u mihomo -n 30 --no-pager

临时开关代理环境变量：

proxy_on   # 开启
proxy_off  # 关闭