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

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

```yaml
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，全部直连）

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

5. 重载 Mihomo 配置，生效

## 重要校验

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

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

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

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

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

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

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

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