当前位置：软师兄 > 最新爆文 > 飞牛Docker 局域网部署 clash/mihomo全局科学 + WebUI 使用指南
最新爆文 1

飞牛Docker 局域网部署 clash/mihomo全局科学 + WebUI 使用指南

流程概览

前言

Mihomo（原名 Mihomo Meta，亦即 Clash Meta）是目前 Clash 核心最活跃、功能最强大的分支。由于原始 Clash 项目删库，Mihomo 已成为各平台客户端的首选核心。

值得注意的是，Mihomo 本身是一个纯命令行程序（Core），没有图形界面。为了方便日常管理和监控，我们需要为其搭配一个 Web UI（如 Metacubexd）。本文将详细介绍如何在 Docker 环境（包括 Linux 服务器、NAS、飞牛OS等）中优雅地部署 Mihomo + WebUI，并开启 TUN 模式实现更接管更底层的流量。

准备工作

在开始之前，请确保您的环境满足以下条件：

  • Docker 环境：已安装 Docker 及 Docker Compose。
  • 基础知识：熟悉基本的命令行操作（创建文件夹、编辑文件）。
  • 网络环境：拥有可用的节点订阅链接。
  • 体验订阅地址：https://xboard.88531.cn

第一步：编写配置文件 (config.yaml)

Mihomo 的运行核心在于配置文件。我们需要先在宿主机上准备好这个文件。

  1. 新建一个文件夹，命名为 mihomo。
  2. 在其中创建一个名为 config.yaml 的文件。
  3. 参考以下模板填入内容。

⚠️ 重点修改提示： 请务必修改下方模板中的 第 7 行（API访问密钥）、第 20、21 行（节点订阅信息）与 第 26 行（节点名称前缀）。修改时请去掉尖括号 < >。

mixed-port: 7890
allow-lan: true
bind-address: '*'
mode: rule
log-level: info
external-controller: '0.0.0.0:9090'
secret: "<API访问密钥>"

tun:
  enable: false
  stack: mixed
  dns-hijack:
    - "any:53"
    - "tcp://any:53"
  auto-route: true
  auto-redirect: true
  auto-detect-interface: true

proxy-providers:
  <节点提供者名称>:
    url: "<节点订阅链接>"
    type: http
    interval: 86400
    health-check: {enable: true,url: "https://www.gstatic.com/generate_204", interval: 300}
    override:
      additional-prefix: "<节点名称前缀>"

proxies: 
  - name: "直连"
    type: direct
    udp: true

geodata-mode: true
geox-url:
  geoip: "https://github.com/MetaCubeX/meta-rules-dat/releases/download/latest/geoip.dat"
  geosite: "https://github.com/MetaCubeX/meta-rules-dat/releases/download/latest/geosite.dat"
  mmdb: "https://github.com/MetaCubeX/meta-rules-dat/releases/download/latest/country-lite.mmdb"
  asn: "https://github.com/MetaCubeX/meta-rules-dat/releases/download/latest/GeoLite2-ASN.mmdb"

dns:
  enable: true
  ipv6: true
  respect-rules: true
  enhanced-mode: fake-ip
  fake-ip-filter:
    - "*"
    - "+.lan"
    - "+.local"
    - "+.market.xiaomi.com"
  nameserver:
    - https://120.53.53.53/dns-query
    - https://223.5.5.5/dns-query
  proxy-server-nameserver:
    - https://120.53.53.53/dns-query
    - https://223.5.5.5/dns-query
  nameserver-policy:
    "geosite:cn,private":
      - https://120.53.53.53/dns-query
      - https://223.5.5.5/dns-query
    "geosite:geolocation-!cn":
      - "https://dns.cloudflare.com/dns-query"
      - "https://dns.google/dns-query"

proxy-groups:

  - name: 默认
    type: select
    proxies: [自动选择,直连,香港,台湾,日本,新加坡,美国,其它地区,全部节点]

  - name: Google
    type: select
    proxies: [默认,香港,台湾,日本,新加坡,美国,其它地区,全部节点,自动选择,直连]

  - name: Telegram
    type: select
    proxies: [默认,香港,台湾,日本,新加坡,美国,其它地区,全部节点,自动选择,直连]

  - name: Twitter
    type: select
    proxies: [默认,香港,台湾,日本,新加坡,美国,其它地区,全部节点,自动选择,直连]

  - name: 哔哩哔哩
    type: select
    proxies: [默认,香港,台湾,日本,新加坡,美国,其它地区,全部节点,自动选择,直连]

  - name: 巴哈姆特
    type: select
    proxies: [默认,香港,台湾,日本,新加坡,美国,其它地区,全部节点,自动选择,直连]

  - name: YouTube
    type: select
    proxies: [默认,香港,台湾,日本,新加坡,美国,其它地区,全部节点,自动选择,直连]

  - name: 海外AI
    type: select
    proxies: [默认,香港,台湾,日本,新加坡,美国,其它地区,全部节点,自动选择,直连]

  - name: NETFLIX
    type: select
    proxies: [默认,香港,台湾,日本,新加坡,美国,其它地区,全部节点,自动选择,直连]

  - name: Spotify
    type: select
    proxies:  [默认,香港,台湾,日本,新加坡,美国,其它地区,全部节点,自动选择,直连]

  - name: Github
    type: select
    proxies:  [默认,香港,台湾,日本,新加坡,美国,其它地区,全部节点,自动选择,直连]

  - name: 国内
    type: select
    proxies:  [直连,默认,香港,台湾,日本,新加坡,美国,其它地区,全部节点,自动选择]

  - name: 其他
    type: select
    proxies:  [默认,香港,台湾,日本,新加坡,美国,其它地区,全部节点,自动选择,直连]

  #分隔,下面是地区分组
  - name: 香港
    type: select
    include-all: true
    filter: "(?i)港|hk|hongkong|hong kong"

  - name: 台湾
    type: select
    include-all: true
    filter: "(?i)台|tw|taiwan"

  - name: 日本
    type: select
    include-all: true
    filter: "(?i)日|jp|japan"

  - name: 美国
    type: select
    include-all: true
    filter: "(?i)美|us|unitedstates|united states"

  - name: 新加坡
    type: select
    include-all: true
    filter: "(?i)(新|sg|singapore)"

  - name: 其它地区
    type: select
    include-all: true
    filter: "(?i)^(?!.*(?:🇭🇰|🇯🇵|🇺🇸|🇸🇬|🇨🇳|港|hk|hongkong|台|tw|taiwan|日|jp|japan|新|sg|singapore|美|us|unitedstates)).*"

  - name: 全部节点
    type: select
    include-all: true

  - name: 自动选择
    type: url-test
    include-all: true
    tolerance: 10

rules:
  - GEOIP,lan,直连,no-resolve
  - GEOSITE,twitter,Twitter
  - GEOSITE,youtube,YouTube
  - GEOSITE,category-ai-!cn,海外AI
  - GEOSITE,github,Github
  - GEOSITE,google,Google
  - GEOSITE,telegram,Telegram
  - GEOSITE,netflix,NETFLIX
  - GEOSITE,bilibili,哔哩哔哩
  - GEOSITE,bahamut,巴哈姆特
  - GEOSITE,spotify,Spotify
  - GEOSITE,CN,国内
  - GEOSITE,geolocation-!cn,其他

  - GEOIP,CN,国内
  - MATCH,其他

​

第二步：构建 Docker Compose

我们将同时部署 Mihomo 核心 和 Metacubexd (WebUI)。

在 mihomo 文件夹同级或任意位置，创建 docker-compose.yml。

🌟 关键配置说明 (TUN 模式支持)： 为了支持 TUN 模式（虚拟网卡），容器必须拥有网络管理权限。我们在配置中加入了 cap_add: [NET_ADMIN] 和 devices: [/dev/net/tun]，这是实现透明代理的关键。

version: '3'

services:
  # Web 管理面板
  metacubexd:
    container_name: metacubexd
    #image: ghcr.io/metacubex/metacubexd
    # 国内加速源
    image: ghcr.1ms.run/metacubex/metacubexd
    restart: always
    ports:
      - '9097:80' # WebUI 访问端口

  # Mihomo 核心
  mihomo:
    container_name: mihomo
    #image: docker.io/metacubex/mihomo:latest
    # 国内加速源
    image: docker.1ms.run/metacubex/mihomo:latest
    restart: always
    pid: host
    ipc: host
    network_mode: host # 推荐使用 Host 模式，性能最好且便于处理 IPv6
    
    # --- TUN 模式核心配置 ---
    cap_add:
      - NET_ADMIN      # 赋予网络管理权限
    devices:
      - /dev/net/tun:/dev/net/tun # 映射宿主机的 TUN 设备
    volumes:
      # ⚠️ 注意：冒号左边请修改为你 config.yaml 所在的实际绝对路径
      - ./mihomo:/root/.config/mihomo

​

第三步：启动与初始化

1. 启动容器

在 docker-compose.yml 所在目录执行：

sudo docker-compose up -d

如果是飞牛OS等图形化系统，请直接在 Docker 管理器中“使用现有 Compose 文件”创建项目即可。

2. 解决规则文件下载失败 (Fatal Error)

初次启动时，查看日志可能会发现如下报错： level=fatal msg="Parse config error... can't download MMDB: context deadline exceeded"

这是因为网络环境导致容器无法自动下载 GeoIP/GeoSite 数据库。

解决方法：

  1. 前往 MetaCubeX/meta-rules-dat 下载以下文件：
    • geoip.dat
    • geosite.dat
    • country-lite.mmdb
    • GeoLite2-ASN.mmdb
  2. 将这4个文件手动上传到宿主机的 mihomo 文件夹（与 config.yaml 同级）。
  3. 重启容器：sudo docker-compose restart mihomo

第四步：配置 WebUI

  1. 打开浏览器访问：http://设备IP:9097。
  2. 进入设置页面，添加后端：
    • API Base URL: http://设备IP:9090
    • Secret: 在 config 第 6 行设置的 API 访问密钥
  3. 点击添加，连接成功后即可看到流量仪表盘和节点选择界面。

进阶：关于 TUN 模式与透明代理

TUN 模式允许 Mihomo 创建一个虚拟网卡，接管设备上所有层级的流量（包括不走系统代理的终端命令、游戏等）。

为什么需要特殊权限？

在 Docker 中，默认容器是没有权限创建网络设备的。要启用 TUN 模式，必须在启动参数中显式声明：

  • --cap-add=NET_ADMIN：允许容器修改网络堆栈。
  • --device=/dev/net/tun：允许容器访问 Linux 的 TUN 字符设备。

在本文提供的 docker-compose.yml 中，我们已经默认添加了这两项配置。

如何启用？

  1. 确保 Docker 配置已包含上述权限参数。
  2. 在 WebUI 的设置页面中勾选 TUN 模式。
  3. 或者在 config.yaml 中将 tun: enable 设置为 true 并重启容器。

此时，配合路由表的设置，Mihomo 即可变身为一个网关，实现透明代理。

Q&A 常见问题

Q1: “Failed to fetch” 无法连接后端？

  • A: 检查 WebUI 中填写的后端地址端口是否为 9090（不是 9097），并确保 config.yaml 中 external-controller 监听的是 0.0.0.0:9090。

Q2: 为什么不使用在线版的 WebUI (如 yacd)？

  • A: 在线版面板（通常是 HTTPS）因浏览器安全策略（混合内容拦截），往往无法连接到你本地的 HTTP 后端（Mihomo）。使用 Docker 自建本地版 WebUI 最稳定。

Q3: 如何在其他设备上使用这个代理？

  • A: 在其他设备（手机/电脑）的 Wi-Fi 代理设置中，填入 IP: 宿主机IP，端口: 7890。

相关链接

体验订阅地址：https://xboard.88531.cn

https://www.88531.cn/?p=56643

相关文章：

  1. 飞牛Docker 局域网部署 clash/mihomo全局科学 + WebUI 使用指南 文章目录1 流程概览2 前言3 准备工作4 第一步：编写配置文件 (config.yaml)5 第二步：构建 Docker Compose6 第三步：启动与初始化6.1 1. 启动容器6.2 2. 解决规则文件下载失败 (Fatal Error)7 第四步：配置 WebUI8 进阶：关于 TUN 模 […]...
  2. Adobe Lightroom安卓版 v11.5.31 修改版 – 手机调色软件 文章目录1 Adobe Lightroom 安卓版 v11.5.31：随身携带的专业级修图工作室1.0.1 核心功能亮点1.0.2 版本与运行说明1.0.3 安装与使用指南1.0.4 适用场景1.0.5 下载地址1.1 📥 下载地址 Adobe Lightroom 安卓版 v11.5.31：随身携带 […]...
  3. Tampermonkey油猴插件——安装与使用教程 相信熟悉浏览器的都知道，尤其是大名鼎鼎的Chrome浏览器，丰富的扩展程序让很多人体验到了浏览器的神奇之处，而一个没有安装扩展程序的浏览器也是不完整的。 插件介绍 而在众多的扩展中，就不得不提到一个浏览器插件——Tampermonkey。中文俗称油猴。 相信很多人也听说过，大家可以把他理解为一个用户 […]...
  4. Android听歌APP 酷我音乐 11.0.2.0 免登录豪华SVIP破解开心版 无损无限免费下载 手机APP酷我音乐破解豪华VIP版，破解SVIP豪华会员，任意账户登录可畅享以下特权，无需内购免费试听下载版权收费歌曲/专辑/无损音乐，任意账户登录即可免费使用极速下载特权，畅享加速专属服务器，VIP尊贵标识、下载高画质MV、过滤乐库广告、使用VIP皮肤等！ 破解说明 @耗子 @黑鹰 @暗猎魂殇 @ […]...
  5. 超2500+单机游戏修改器 解锁专业版 共计 301 个字符，预计需要花费 1 分钟才能阅读完成。 WeMod 目前支持超过千款热门游戏，且每周都会追加游戏列表。...
  6. Java连接Hive2数据库的方法详解 (java hive2 数据库连接) Hive是基于Hadoop的数据仓库工具，可以将结构化的数据映射为一张数据库表来进行查询和分析。而Java是一种广泛应用的编程语言，可以通过它来连接Hive2数据库。在本文中，将详细介绍Java连接Hive2数据库的方法。...
www.npspro.top互联侠客
软师兄 » 飞牛Docker 局域网部署 clash/mihomo全局科学 + WebUI 使用指南

Perfect″—完美 钻石

分享到：

最TOP的Docker,软路由,虚拟机等学习资料

立即查看 了解详情