保姆级教程：用Docker Compose一键部署qBittorrent+Transmission+IYUU Plus辅种全家桶
全容器化PT工具链部署指南：从零搭建高效辅种系统
在私人云存储和网络带宽日益普及的今天，搭建个人化的PT（Private Tracker）环境已成为许多技术爱好者的需求。本文将带领您使用Docker Compose这一容器编排工具，快速部署包含qBittorrent下载、Transmission校验和IYUU Plus辅种的完整工作流。不同于传统的手动配置方式，我们的方案强调一键部署和自动化管理，特别适合刚接触容器技术或希望简化运维流程的用户。
1. 环境准备与基础概念
在开始部署前，我们需要明确几个关键组件的作用和相互关系：
- qBittorrent：功能丰富的BT客户端，以其高效的下载性能和友好的Web界面著称
- Transmission快校版：经过优化的Transmission版本，特别加强了文件校验速度
- IYUU Plus：自动化辅种工具，能够智能识别可辅种的资源并自动操作
这三个组件通过Docker容器化后，可以避免复杂的依赖关系和环境冲突。以下是部署前的必要准备：
硬件要求：
- x86架构的NAS或服务器（ARM架构可能需要额外配置）
- 至少2GB可用内存
- 50MB以上的磁盘空间用于容器镜像和配置
软件依赖：
# 检查Docker是否安装 docker --version # 检查Docker Compose是否安装 docker-compose --version网络考虑：
- 确保路由器支持端口转发
- 建议为BT服务分配固定IP地址
- 了解您的ISP对P2P流量的限制政策
提示：如果您的设备尚未安装Docker，可以参考官方文档进行安装。对于群晖NAS用户，可直接通过Package Center安装Docker套件。
2. Docker Compose编排文件详解
我们将使用单个docker-compose.yml文件管理所有服务，这种方式的优势在于：
- 统一的环境变量管理
- 服务依赖关系清晰可见
- 一键启动/停止整个系统
以下是完整的编排文件模板：
version: "3.8" services: qbittorrent: image: linuxserver/qbittorrent:latest container_name: qbittorrent environment: - PUID=1000 - PGID=1000 - TZ=Asia/Shanghai - WEBUI_PORT=8080 volumes: - ./qbittorrent/config:/config - ./downloads/qbittorrent:/downloads ports: - 6881:6881 - 6881:6881/udp - 8080:8080 restart: unless-stopped networks: - pt_network transmission: image: chisbread/transmission:latest container_name: transmission environment: - PUID=1000 - PGID=1000 - TZ=Asia/Shanghai - USER=admin - PASS=password123 - PEERPORT=51413 volumes: - ./transmission/config:/config - ./downloads/transmission:/downloads - ./watch:/watch ports: - 9091:9091 - 51413:51413 - 51413:51413/udp restart: unless-stopped networks: - pt_network iyuuplus: image: iyuucn/iyuuplus:latest container_name: iyuuplus volumes: - ./iyuuplus/db:/IYUU/db - ./qbittorrent/config/qBittorrent/BT_backup:/BT_backup - ./transmission/config/torrents:/torrents ports: - 8787:8787 restart: unless-stopped networks: - pt_network networks: pt_network: driver: bridge关键配置项说明：
| 配置项 | qBittorrent | Transmission | IYUU Plus |
|---|---|---|---|
| 数据卷 | /config, /downloads | /config, /downloads, /watch | /IYUU/db, /BT_backup, /torrents |
| 网络端口 | 6881(TCP/UDP), 8080 | 51413(TCP/UDP), 9091 | 8787 |
| 环境变量 | PUID, PGID, WEBUI_PORT | PUID, PGID, USER, PASS | 无 |
注意：实际部署时，请将PUID/PGID修改为您系统中实际用户的ID，可通过
id -u <username>和id -g <username>命令查询。
3. 服务部署与初始化
完成docker-compose.yml文件编写后，执行以下命令启动服务：
# 创建所需目录 mkdir -p {qbittorrent/config,transmission/config,iyuuplus/db,downloads,watch} # 启动所有容器（在docker-compose.yml所在目录执行） docker-compose up -d服务启动后，可以通过以下地址访问各组件Web界面：
- qBittorrent:
http://<服务器IP>:8080(默认账号: admin, 密码: adminadmin) - Transmission:
http://<服务器IP>:9091(使用docker-compose.yml中设置的用户名密码) - IYUU Plus:
http://<服务器IP>:8787
首次使用IYUU Plus需要进行以下初始化操作：
获取Token：
- 访问 IYUU官网 扫码获取Token
- 在Web界面使用Token登录并设置密码
验证合作站点：
- 准备至少一个IYUU合作PT站点的账号
- 在IYUU界面输入站点的UID和Passkey完成验证
配置下载器：
- 添加qBittorrent和Transmission的连接信息
- 特别注意容器间的路径映射关系
4. 自动化辅种工作流配置
IYUU Plus的核心价值在于自动化辅种流程，以下是推荐的配置步骤：
转种任务配置：
- 设置从qBittorrent到Transmission的自动转种
- 配置合理的路径转换规则（关键步骤）
# 示例路径转换规则（当下载目录映射不一致时） /downloads{#**#}/qbdownloads辅种任务设置：
- 选择要辅种的PT站点
- 设置自动校验选项
- 配置执行周期（建议每天凌晨低峰期运行）
监控与排错：
- 定期检查任务日志
- 验证种子健康状态
- 注意存储空间使用情况
常见问题解决方法：
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 转种失败 | 路径映射错误 | 检查docker-compose.yml中的volume配置 |
| 辅种不识别 | 站点未验证 | 确保至少一个合作站点验证通过 |
| 速度缓慢 | 端口未转发 | 在路由器设置BT服务端口的转发规则 |
5. 高级优化与维护技巧
系统运行稳定后，可以考虑以下优化措施：
性能调优：
- 为Transmission快校版分配更多内存
- 调整qBittorrent的磁盘缓存设置
- 限制同时活动的种子数量
数据备份：
# 定期备份配置数据 tar -czvf pt_backup_$(date +%Y%m%d).tar.gz \ qbittorrent/config \ transmission/config \ iyuuplus/db版本更新：
# 更新所有容器到最新版本 docker-compose pull docker-compose up -d资源监控：
- 使用
docker stats查看容器资源占用 - 设置日志轮转防止磁盘写满
- 监控网络流量避免带宽耗尽
- 使用
这套全容器化的PT工具链部署方案，在实际使用中展现了出色的稳定性和易用性。通过合理的配置和定期维护，您可以建立一个几乎无需人工干预的自动化辅种系统，显著提高在PT社区中的分享率和资源获取效率。