crazymax/rtorrent-rutorrent

rTorrent 和 ruTorrent Docker 镜像

镜像概述

本镜像基于 Alpine Linux 构建，集成了 rTorrent（命令行 BitTorrent 客户端）和 ruTorrent（Web 管理界面），提供轻量级、高效的 BitTorrent 下载解决方案。Alpine Linux 基础确保镜像体积小、资源占用低，适合在各类服务器环境中部署。

核心功能与特性

• 轻量级设计：基于 Alpine Linux，镜像体积小，启动快速，运行时资源消耗低
• 完整工具链：整合 rTorrent 命令行客户端与 ruTorrent Web 界面，兼顾命令行控制与图形化管理需求
• Web 管理界面：通过 ruTorrent 提供直观的 Web 操作界面，支持种子管理、下载监控、速度控制等功能
• 数据持久化：支持通过卷挂载保存配置文件和下载数据，确保容器重启后配置与下载进度不丢失
• 灵活配置：可通过环境变量和配置文件自定义 rTorrent 下载规则、ruTorrent 界面设置等参数

使用场景与适用范围

• 个人服务器或 VPS 部署 BitTorrent 下载服务
• 家庭媒体中心作为下载组件，自动获取影视资源
• 开发测试环境快速部署 BitTorrent 客户端进行文件传输测试
• 资源受限设备（如树莓派）运行轻量级下载服务

使用方法与配置说明

基本部署（docker run）

bash
docker run -d \
  --name rtorrent-rutorrent \
  -p 8080:80 \          # Web界面端口（ruTorrent）
  -p 50000:50000 \      # rTorrent监听端口（可自定义）
  -v /path/to/downloads:/downloads \  # 下载文件存储目录
  -v /path/to/config:/config \        # 配置文件目录
  -v /path/to/sessions:/sessions \    # rTorrent会话状态目录
  --restart unless-stopped \
  crazymax/rtorrent-rutorrent

Docker Compose 配置示例

yaml
version: '3.8'

services:
  rtorrent-rutorrent:
    image: crazymax/rtorrent-rutorrent
    container_name: rtorrent-rutorrent
    ports:
      - "8080:80"
      - "50000:50000"
    volumes:
      - /path/to/downloads:/downloads
      - /path/to/config:/config
      - /path/to/sessions:/sessions
    environment:
      - PUID=1000        # 运行用户ID（与宿主机匹配避免权限问题）
      - PGID=1000        # 运行组ID
      - TZ=Asia/Shanghai # 时区设置
      - RTORRENT_PORT=50000 # rTorrent监听端口
    restart: unless-stopped

关键配置说明

卷挂载说明

环境变量参数

访问Web界面

容器启动后，通过浏览器访问 http://<宿主机IP>:8080 即可打开ruTorrent界面，默认无需登录（生产环境建议配置访问控制）。

注意事项

• 首次启动时，配置目录会自动生成默认配置，可通过修改 /config/rtorrent/rtorrent.rc 自定义下载规则
• 宿主机挂载目录需设置正确权限（建议与PUID/PGID匹配），避免文件读写权限问题
• 修改监听端口时，需同步调整端口映射和 RTORRENT_PORT 环境变量

更多信息

完整文档与高级配置请参考 https://github.com/crazy-max/docker-rtorrent-rutorrent