飞牛NAS上使用Docker部署Mihomo+MetaCubeXD

之前刚开始用飞牛做系统代理时，图省事直接用了网上别人构建好的Clash+Yacd整合镜像，一开始挺好用，但后来不知道什么时候就失效了。

直到最近装了另一台 NAS，才想起来代理这事儿还没彻底解决，得重新配置一下。这次换成了Mihomo+MetaCubexd组合的方案。

由于网络环境较为复杂，需要借助FRP内网穿透才能访问飞牛系统。加之飞牛设置里到现在还没有提供图形化的代理配置选项，必须通过SSH命令行手动设置。部署过程中遇到不少问题，整体流程相当折腾。

1 使用Docker部署Mihomo和MetaCubeXD

1.1 飞牛Docker上创建Compose

直接在飞牛的Docker里用Compose文件部署。

项目创建后compose文件会放到这里自己设置路径的文件夹里。所以我把容器内的配置文件也顺手挂载到这里。

具体的compose文件如下：

# docker-compose文件
services:
  mihomo:
    container_name: mihomo
    image: metacubex/mihomo
    restart: always
    volumes:
      - /vol2/1000/Files/Apps/clash-meta/mihomo:/root/.config/mihomo
    ports:
      - "7890:7890"  # HTTP 代理端口
      - "7891:7891"  # SOCKS 代理端口
      - "7893:7892"  # Mixed 混合端口
      - "9090:9090"  # API 端口
    environment:
      - TZ=Asia/Shanghai
  metacubexd:
    container_name: metacubexd
    image: ghcr.io/metacubex/metacubexd
    restart: always
    ports:
      - "9091:80"  # 面板访问端口
    volumes:
      - /vol2/1000/Files/Apps/clash-meta/metacubexd:/config/caddy
    environment:
      - TZ=Asia/Shanghai

需要注意的配置参数：

mihomo配置文件的挂载： 这里配置文件挂载到了/vol2/1000/Files/Apps/clash-meta/mihomo目录下。
mihomo端口的设置： 确保宿主机暴露的端口与 Mihomo 配置文件 (config.yaml) 中定义的监听端口一致。

运行compose后

1.2 导入config.yaml文件并修改配置

把自己机场的配置文件复制到上面设置的挂载位置，即/vol2/1000/Files/Apps/clash-meta/mihomo下。

复制完成后有需要特别注意几个参数：

端口的设置： 再次确保port、socks-port、mixed-port几个端口对应得上。
**允许局域网连接：**allow-lan参数需要设置为true，否则在Docker环境下飞牛宿主机无法访问
**外部控制器监听地址：**external-controller: 0.0.0.0:9090允许来自任何网络接口的连接请求来访问 9090 端口的 API。只有配置了这一行MetaCubeX 面板才能顺利连接到 Mihomo 核心。
访问密钥： 可以设置连接Mihomo核心的访问密钥，这里我只在内网访问就不设置注释掉了。

# config.yaml文件
port: 7890
socks-port: 7891
mixed-port: 7892
allow-lan: true
external-controller: 0.0.0.0:9090
#secret: 访问密钥
...

1.3 进入MetaCubeXD设置连接到Mihomo（踩坑）

1.3.1 进入面板连接到Mihomo

构建运行compose并导入config配置文件之后，就可以访问到Mihomo和MetaCubeXD面板了。

在同一网络环境下，直接输入能够访问到Mihomo核心的后端地址就通过MetaCubeXD的面板进行控制了。

例如，当飞牛运行在192.168.1.2的IP之下时，我们通过Docker将Mihomo和MetaCubeXD这两个服务分别部署到了飞牛的9090和9091端口下，当我们通过浏览器访问http://192.168.1.2:9090和http://192.168.1.2:9091时就能分别进入对应的服务。此时MetaCubeXD的登录的后端地址就填入http://192.168.1.2:9090密钥则根据配置文件的设置进行填写或留空。

这里因为踩了个坑所以特别说明一下。

1.3.2 踩坑记录

我在部署时的环境是这样的：

通过FRP内网穿透，将飞牛的上Mihomo的9090的服务代理到自己访问设备的19090端口上通过http://127.0.0.1:19090访问；将MetaCubeXD代理到本地9091端口通过http://127.0.0.1:9091访问。

然后踩了个坑：

当我在本地通过http://127.0.0.1:9091访问远程的MetaCubeXD时，我习惯性的认为，这个登录的后端地址应该是MetaCubeXD在Docker内网环境下能够访问到Mihomo的地址，下意识的填入了http://mihomo:9090。

随即报错：“无法连接后端，请检查地址是否正确以及后端是否正在运行。”

当看到这个报错时，第一时间想到的是可能compose的配置出现了问题导致两个容器没有连接上。

多次检查确认compose配置没有问题，两个容器都在同一brige网络之下，在飞牛的浏览器上本地访问192.168.1.x:9090和192.168.1.x:9091也可以单独访问服务。

把两个容器网络都设置为host模式再次启动，也一样单独可以访问两个服务。

最后进入MetaCubeXD的容器内部对http://mihomo:9090进行测试时也可以连接的上。

明明单独的服务访问都没有问题，两个服务直接的通信也没有问题，为什么通过MetaCubeXD的后端地址就是不对？

后面头疼了一个多小时后随手点开了F12。

发现原来MetaCubeXD是直接通过浏览器对这个后端地址发HTTP请求，而不是用这个地址在容器内部访问处理后再转发给前台。

所以才访问不到http://mihomo:9090，最后按http://127.0.0.1:9091填就好了。

2 通过SSH命令行连接飞牛设置系统代理

2.1 使用SSH连接飞牛

2.1.1 打开飞牛SSH功能

系统设置 -> SSH -> 启动SSH功能

2.1.2 SSH连接飞牛并切换root用户

使用密码认证的方式，通过登录飞牛的账号密码进行SSH连接。

连接之后需要切换到root用户。

一般情况下root用户密码未设置需要首先设置一遍，或者忘记了重新设置。

# 修改root用户密码
sudo passwd root
# 输入指令后首先需要输入当前用户的密码
# 重复输入两次修改的root密码

密码设置或修改完成后就可以通过以下命令切换root了：

su -

2.2 更改`/.bashrc`环境变量设置系统代理

切换到root打开/.bashrc文件

1	vim ~/.bashrc

添加两行代理配置：

1 2	export http_proxy=http://127.0.0.1:7890 export https_proxy=http://127.0.0.1:7890

即上面设置的Mihomo的代理端口，这里使用HTTP的端口。

想要方便启用和停止代理可以在/.bashrc文件里定义两个函数分别设置和重置代理，这样就可以直接在命令行输入proxy_on和proxy_off快捷开关系统代理了：

#.bashrc文件
...
#系统代理启停控制
function proxy_off(){
    unset no_proxy
    unset http_proxy
    unset https_proxy
    echo -e "系统代理已经关闭"
}

function proxy_on(){
    export no_proxy=localhost
    export http_proxy=http://127.0.0.1:7890
    export https_proxy=http://localhost:7890
    echo -e "系统代理已经开启"
}

最后刷新配置

1	source ~/.bashrc

‍

完成后系统代理就设置完毕了。

‍

3 其它设置

3.1 设置配置文件自动更新

MetaCubeXD里没办法直接设置，需要在Mihomo的配置文件里自己按格式添加一段订阅才行：

订阅格式如下，具体可看：https://wiki.metacubex.one/config/proxy-providers/

# config.yaml文件
...
proxy-providers:
  订阅名称:
    type: http
    url: "订阅链接"
    interval: 86400 # 自动更新间隔
    health-check:
      enable: true
      url: http://www.gstatic.com/generate_204
      interval: 600 # 健康检查间隔
...

添加完成后重启Mihomo核心，在MetaCubeXD上就可以看到“代理提供者”即配置文件订阅信息的页面了。

2026-05-25