looselyrigorous/rtorrent

Alpine上的rtorrent

这是一个基于Alpine Linux的轻量级rtorrent容器。该容器屏蔽了GUI输出，通过暴露Unix socket支持与ruTorrent、Flood等web服务集成，满足BitTorrent下载需求。

镜像概述

本镜像为rtorrent提供Docker化部署方案，针对Docker特性优化默认配置，支持配置持久化、用户权限管理及外部web服务交互，适合轻量级BitTorrent下载场景。

核心功能

• 提供标准BitTorrent协议下载能力
• 通过Unix socket与ruTorrent/Flood等web管理界面集成
• 支持配置文件持久化与自定义
• 可通过环境变量设置运行用户的PUID/PGID以匹配卷权限
• 暴露BitTorrent标准端口（49161 TCP/UDP等）

使用场景

• 个人或小型团队的文件下载需求
• 与web管理界面结合构建Docker化下载服务
• 需要轻量级BitTorrent客户端的容器化部署场景

配置说明

容器提供适配Docker的默认配置，可通过以下命令将默认配置引导到指定卷：

bash
docker run --rm -v "$(pwd)/config:/config" docker.xuanyuan.run/looselyrigorous/rtorrent bootstrap

部署示例

Docker Run命令

bash
docker run -itd \
    -v ./downloads:/downloads \
    -v ./session:/session \
    -v ./watch:/watch \
    -v ./config:/config \
    -v rtorrent-sock:/socket \
    -p 49161:49161 \
    -p 49161:49161/udp \
    -e PUID=1000 -e PGID=1000 \
    docker.xuanyuan.run/looselyrigorous/rtorrent:0.3.2

Docker Compose配置

yaml
version: "3"
services:
  rtorrent:
    image: docker.xuanyuan.run/looselyrigorous/rtorrent:0.3.2
    volumes:
      - "./downloads:/downloads"
      - "./session:/session"
      - "./watch:/watch"
      - "./config:/config"
      - "rtorrent-sock:/socket"
    ports:
      - "49161:49161"
      - "49161:49161/udp"
    environment:
      - PUID=1000
      - PGID=1000
volumes:
  rtorrent-sock: {}

保存为docker-compose.yml后，执行docker-compose up -d启动服务。

卷说明

环境变量

• PUID: 运行rtorrent的用户ID，需与挂载卷的所有者ID匹配
• PGID: 运行rtorrent的用户组ID，需与挂载卷的所有者组ID匹配
  容器会自动修改除/downloads外所有卷的权限，建议先确保/downloads目录权限与PUID/PGID一致。

端口说明

• 49161 TCP/UDP: 用于BitTorrent传入连接
• 49160 UDP: 用于DHT（默认禁用，可通过配置启用）
  注意：XMLRPC端口未启用，建议通过nginx代理Unix socket并添加认证以保证安全。