winneon/docker-bittorrent

docker-bittorrent 镜像说明

镜像概述

基于原https://github.com/kfei/docktorrent项目，该Docker容器是一个功能齐全的BitTorrent客户端/服务器系统，集成https://github.com/rakshasa/rtorrent、https://github.com/Novik/ruTorrent和https://github.com/jfurrow/flood工具。部署简单，只需拉取镜像并启动容器即可快速使用。

核心功能

• 便携性设计：一键启动，快速上手；
• 安装便捷：满足前提条件下，一分钟内完成部署；
• 双Web客户端选择：支持经典稳定的ruTorrent和现代界面的Flood，可同时使用；
• 自动恢复：rTorrent挂起或冻结时自动重启；
• 便捷访问：通过单命令即可访问rTorrent CLI或Flood终端输出。

使用场景

适用于合法的文件共享需求，如开源软件分发、授权内容下载等场景，支持个人或小型团队快速搭建BitTorrent服务。

配置说明

默认配置适用于大多数场景，若需自定义（如私有tracker或性能调优），可通过环境变量调整rTorrent参数：

• PEERS: 设置下载时每个种子的最大peers数；
• PEERS_SEED: 设置上传时每个种子的最大peers数；
• DOWNLOADS: 设置同时下载的最大任务数；
• UPLOADS: 设置同时上传的最大任务数；
• DOWNLOAD_RATE: 设置全局最大下载速率（kb/s）；
• UPLOAD_RATE: 设置全局最大上传速率（kb/s）；
• DHT: 启用/禁用DHT和peer发现（值为on/off）。

安装部署

Docker CE方式

前提条件

• 已安装Docker CE；
• Docker服务已运行。

执行以下命令（替换MAIN为Web端口，PEER为传入端口，CONTENT为存储目录）：

bash
docker run --name bittorrent \
  --restart always -dit \
  -p MAIN:80 -p PEER:5000 \
  -v CONTENT:/data/rtorrent \
  docker.xuanyuan.run/winneon/docker-bittorrent

停止/启动容器：

bash
docker stop bittorrent
docker start bittorrent

Docker Compose方式

前提条件

• 已安装Docker CE和Docker Compose；
• Docker服务已运行。

下载仓库压缩包并解压，编辑docker-compose.yml替换MAIN、PEER、CONTENT等变量，然后执行：

bash
docker-compose up -d

停止/启动容器：

bash
docker-compose stop
docker-compose start

使用指南

ruTorrent访问

打开http://127.0.0.1:MAIN/（替换MAIN为绑定端口），输入默认账号密码bittorrent/bittorrent。如需修改账号密码：

bash
docker exec -it bittorrent htpasswd -cb /data/rutorrent/.htpasswd 新用户名 新密码

Flood访问

打开http://127.0.0.1:MAIN/flood/，按照界面提示创建账号。查看Flood终端输出：

bash
docker exec -it bittorrent screen -r flood

按Ctrl+A, D退出屏幕会话。

rTorrent CLI访问（适合经验用户）

bash
docker exec -it bittorrent screen -r rtorrent

按Ctrl+A, D退出屏幕会话。

镜像构建

Docker CE构建

执行以下命令（替换NAME为镜像名称）：

bash
docker build -t NAME .

Docker Compose构建

bash
docker-compose build

（注：构建过程可能耗时30分钟以上，完成后可按安装步骤运行镜像。）