tianon/rtorrent

镜像概述

rtorrent Docker镜像是基于rtorrent命令行BitTorrent客户端构建的容器化应用，提供了一种便捷的Docker部署方案。该镜像将rtorrent及其依赖环境封装为容器，使用户无需在主机系统直接安装配置，即可快速启动和运行rtorrent，简化了应用的部署与管理流程。

核心功能与特性

• 容器化部署：通过Docker容器隔离运行环境，避免主机系统依赖冲突，简化安装与升级流程
• 原生功能完整：包含rtorrent全部核心功能，支持BitTorrent协议标准特性，如种子管理、下载优先级控制、带宽限制等
• 轻量级设计：保持rtorrent命令行工具的轻量特性，资源占用低，适合服务器或无头环境
• 灵活配置支持：可通过挂载配置文件自定义rtorrent行为，满足个性化使用需求

使用场景与适用范围

• 服务器或无头环境（无图形界面）中需要运行BitTorrent客户端的场景
• 偏好命令行工具进行BT下载管理的用户
• 需通过Docker实现应用隔离部署的环境
• 对资源占用敏感，需要轻量级BT客户端的使用场景

使用方法与配置说明

基本使用指南

详细使用方法请参考镜像的https://github.com/tianon/dockerfiles/blob/master/rtorrent/Dockerfile%E5%92%8Chttps://github.com/tianon/dockerfiles/blob/master/rtorrent/run.sh%E3%80%82

典型部署示例

Docker Run命令

以下为基本运行示例（需根据实际需求调整挂载路径和参数）：

bash
docker run -d \
  --name rtorrent \
  -v /host/path/to/config:/home/rtorrent/.rtorrent.rc \
  -v /host/path/to/downloads:/home/rtorrent/downloads \
  -p 6881:6881 \
  -p 6881:6881/udp \
  docker.xuanyuan.run/tianon/rtorrent

参数说明：

• -v /host/path/to/config:/home/rtorrent/.rtorrent.rc：挂载主机rtorrent配置文件到容器内
• -v /host/path/to/downloads:/home/rtorrent/downloads：挂载下载目录，实现下载文件持久化
• -p 6881:6881 及 -p 6881:6881/udp：映射BT默认端口（TCP/UDP），端口号需与配置文件中设置一致

配置说明

rtorrent的核心配置通过.rtorrent.rc文件实现，用户需自行准备该配置文件并通过volume挂载至容器内/home/rtorrent/.rtorrent.rc路径。配置文件支持设置下载目录、监听端口、带宽限制、种子默认行为等参数，具体配置项可参考rtorrent官方文档或示例配置文件。