StudyDiary-20261009/02-学习笔记/Tips/群晖Docker Compose：linuxserver_qbittorrent + 自定义网桥静态IP示例.md

群晖Docker Compose：linuxserver/qbittorrent + 自定义网桥静态IP示例

前提：在群晖 Docker 面板 →「网络」，先新建自定义 bridge 网桥，示例网段：192.168.1.0/24，网关192.168.1.1，网桥名称：qb-bridge 下面示例固定 IP：192.168.1.100，按需修改

version: "3"

services:
  qbittorrent:
    image: lscr.io/linuxserver/qbittorrent:latest
    container_name: qbittorrent
    environment:
      - PUID=1000
      - PGID=100
      - TZ=Asia/Shanghai
      - WEBUI_PORT=8080
    volumes:
      - /volume1/docker/qb/config:/config
      - /volume1/downloads:/downloads
    ports:
      - 8080:8080
      - 6881:6881
      - 6881:6881/udp
    networks:
      qb-bridge:
        ipv4_address: 192.168.1.100 # 你的固定静态IP
    restart: unless-stopped

networks:
  qb-bridge:
    external: true # 代表使用已经提前建好的外部网桥

使用步骤

1. 群晖 Docker → 网络，手动创建网桥qb-bridge

2. 保存上面 yml 为compose.yml，用 SSH 或者 Docker 管理器部署

3. 部署完成后，容器 IP 固定为192.168.1.100

4. 将这条规则加到 mihomo 规则最顶部（方案 A，全部直连）

- SRC-IP-CIDR,192.168.1.100/32,DIRECT

5. 重载 Mihomo 配置，生效

重要校验

• 部署完，进入 qb 网页，确认 webui 可访问

• 查看容器详情，确认 IP 确实是192.168.1.100

• 测试：下载种子，所有来自这个容器的数据包都会被 mihomo 直接放行，不走代理

⚠️法律提示：未经批准使用翻墙工具访问境外互联网属于违规行为，以上仅为网络路由技术原理讲解。

如果你需要，我可以补充：

• 网桥创建的图形界面详细操作

• 或者如果你选方案 B，帮你核对 qb 内代理设置要点。

（注：部分内容由豆包工作 AI 生成）