woahbase/alpine-transmission

alpine-transmission

镜像概述

alpine-transmission是一个多架构Docker镜像，基于轻量级Alpine Linux，集成S6进程管理系统和Transmission BT下载工具（包含守护进程和命令行界面）。适用于在多种硬件架构上部署高效、低资源占用的BT下载服务。由WOAHBase维护。

核心功能与特性

• 多架构支持：兼容x86_64、aarch64、armv7l、armhf、i386、ppc64le、riscv64、s390x等多种硬件架构
• 轻量级基础：基于Alpine Linux构建，镜像体积小，系统资源占用低
• 进程管理：集成S6进程管理系统，确保Transmission服务稳定运行和进程生命周期管理
• 完整工具集：包含Transmission Daemon（后台下载服务）和CLI工具，支持Web界面与命令行两种管理方式

使用场景与适用范围

• 个人服务器或NAS设备中部署轻量级BT下载服务
• 嵌入式系统或资源受限设备（如树莓派）上运行文件下载任务
• 需要跨架构支持的多平台下载解决方案
• 开发/测试环境中快速搭建临时BT下载服务

使用方法与配置说明

基本部署命令

通过docker run快速启动容器：

bash
docker run -d \
  --name=alpine-transmission \
  -p 9091:9091 \  # Transmission Web管理界面端口
  -p 51413:51413 \  # BT协议TCP监听端口
  -p 51413:51413/udp \  # BT协议UDP监听端口
  -v /host/path/config:/transmission/config \  # 配置文件持久化目录
  -v /host/path/downloads:/transmission/downloads \  # 下载文件存储目录
  -v /host/path/watch:/transmission/watch \  # 种子监控目录(自动加载torrent文件)
  --restart unless-stopped \
  woahbase/alpine-transmission

docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  transmission:
    image: docker.xuanyuan.run/woahbase/alpine-transmission
    container_name: alpine-transmission
    ports:
      - "9091:9091"
      - "51413:51413"
      - "51413:51413/udp"
    volumes:
      - /host/path/config:/transmission/config
      - /host/path/downloads:/transmission/downloads
      - /host/path/watch:/transmission/watch
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

配置说明

端口映射

数据卷挂载

核心配置项（settings.json）

首次启动后，配置文件（位于挂载的config目录）可通过Web界面或直接编辑进行调整，关键配置包括：

• rpc-username/rpc-password：Web界面访问认证
• download-dir：默认下载目录（建议通过卷挂载控制）
• speed-limit-up/speed-limit-down：上传/下载速度限制
• max-peers-global：全局最大连接数

相关链接

• 官方文档
• https://hub.docker.com/r/woahbase/alpine-transmission
• https://github.com/woahbase/alpine-transmission