banner
约 600 字
2 分钟

OpenList + qBittorrent:轻量高效的离线下载方案

摘要

OpenList + qBittorrent 是一套轻量级离线下载方案。OpenList 自动抓取更新全球Tracker节点,qBittorrent 提供稳定下载服务。两者通过共享目录同步,显著提升下载速度。部署步骤包括创建目录、编写 docker-compose.yml 配置文件、启动服务。最后需在 qBittorrent Web 界面开启自动更新 Tracker 列表功能。该方案部署简单,适合追求高效资源获取的用户。

组合简介

OpenList + qBittorrent 是一套专为离线下载设计的轻量解决方案,通过「自动化工具 + 稳定客户端」的组合,实现高效资源获取:

  • OpenList:自动抓取、筛选、更新全球优质 BT Tracker 节点,彻底告别手动查找和替换的繁琐。

  • qBittorrent:轻量稳定的跨平台 BT 客户端,支持 Web 远程管理、限速、种子分类等核心功能,满足多样化下载需求。

  • 组合优势:通过共享目录自动同步 Tracker 列表,让 qBittorrent 始终连接更多有效节点,显著提升冷门资源下载速度,同时大幅降低手动维护成本。

适合需要长期稳定运行离线下载、追求高效资源获取的用户,部署简单且无需复杂配置。

OpenList + qBittorrent 架构示意
OpenList + qBittorrent 架构示意

快速部署步骤

1. 创建目录并进入

纯文本
# 创建主目录并进入
mkdir -p ~/qb-openlist && cd ~/qb-openlist

# 自动创建所需子目录(数据存储、配置、共享目录等)
mkdir -p ./data/{openlist,qbittorrent/{config,downloads},shared/qb-temp}

2. 新建配置文件(直接复制)

在当前目录(~/qb-openlist)创建 docker-compose.yml 文件,粘贴以下内容:

纯文本
services:
  # OpenList:自动维护Tracker列表
  openlist:
    image: openlistteam/openlist:latest
    container_name: openlist
    user: '0:0'  # 用root权限避免部署权限问题
    volumes:
      - ./data/openlist:/opt/openlist/data  # OpenList数据存储
      - ./data/shared/qb-temp:/opt/openlist/data/temp/qBittorrent  # 与qB共享目录
    ports:
      - '5244:5244'  # 默认端口,冲突可修改
    restart: unless-stopped
    networks:
      openlist-net:

  # qBittorrent:核心下载客户端
  qbittorrent:
    image: lscr.io/linuxserver/qbittorrent:latest
    container_name: qbittorrent
    environment:
      - PUID=0  # 与root权限保持一致
      - PGID=0
      - WEBUI_PORT=8080  # Web管理端口
    volumes:
      - ./data/qbittorrent/config:/config  # 配置文件存储
      - ./data/qbittorrent/downloads:/downloads  # 下载文件存储路径
      - ./data/shared/qb-temp:/opt/openlist/data/temp/qBittorrent  # 与OpenList共享目录
    ports:
      - '8080:8080'  # Web管理端口映射
      - '6881:6881'  # BT下载端口(TCP)
      - '6881:6881/udp'  # BT下载端口(UDP)
    restart: unless-stopped
    networks:
      openlist-net:

# 自定义网络:确保两服务互通
networks:
  openlist-net:

3. 启动服务

纯文本
# 后台启动所有服务
docker-compose up -d

4. 配置 qBittorrent(3步完成)

  1. 浏览器访问 http://服务器IP:8080,默认账号 admin、密码 adminadmin(首次登录需强制修改密码)。

  2. 进入「工具 → 选项 → BitTorrent」。

  3. 勾选「自动更新 Tracker 列表」,输入路径:

    纯文本
    file:///opt/openlist/data/temp/qBittorrent/trackers_all.txt

    保存设置即可。

停止服务(如需)

纯文本
# 进入目录并停止服务
cd ~/qb-openlist && docker-compose down

END
© 2026 执手听风. All Rights Reserved. / RSS / Sitemap
Powered by Tanstack Start & Flare Stack Blog