transmission Docker镜像文档

镜像概述与主要用途

transmission Docker镜像是一个改进版的Transmission BitTorrent客户端容器化方案。Transmission是一款轻量级、跨平台的开源BitTorrent客户端，支持下载和分享文件。本镜像优化了配置灵活性、Web UI多样性及部署便捷性，适用于需要通过Docker快速搭建BT下载服务的场景。

核心功能与特性

• 多Web UI支持：内置多种Web管理界面，包括Transmission Web Control、Transmissionic、Combustion等，可按需切换
• 用户认证保护：支持自定义用户名和密码，增强Web界面访问安全性
• 灵活的权限控制：通过PUID/PGID指定运行用户ID和组ID，避免文件权限冲突
• 自定义路径配置：可指定下载目录、监视目录及配置文件存储路径，适应不同存储需求
• 端口与网络优化：支持自定义BT传输端口（TCP/UDP）及RPC端口，适配网络环境
• 时区设置：支持通过TZ环境变量配置时区，确保日志和任务时间准确
• 配置持久化：配置文件、日志等数据存储在独立卷中，容器重启后配置不丢失

使用场景与适用范围

• 个人文件下载：家庭用户搭建私有BT下载服务，管理影视、软件等文件下载
• 家庭媒体中心：配合NAS或媒体服务器，自动下载并整理媒体文件
• 私有种子分享：小型团队或个人通过私有种子分享文件，控制访问权限
• 服务器环境部署：在VPS或服务器上轻量部署，资源占用低，适合长期运行

部署与使用方法

环境要求

• Docker Engine 19.03+
• Docker Compose（可选，用于编排部署）
• 宿主机需开放对应端口（默认9091、51413）

部署方式

1. Docker Compose部署

创建docker-compose.yml文件，配置如下：

version: "2.1"
services:
  transmission:
    image: ddsderek/transmission:latest
    container_name: transmission
    environment:
      - PUID=1000                # 运行用户ID（建议设为当前用户ID）
      - PGID=1000                # 运行组ID（建议设为当前用户组ID）
      - UMASK=022                # 文件权限掩码（默认022，控制新文件权限）
      - TZ=Asia/Shanghai         # 时区（如Asia/Shanghai、Europe/London等）
      - USER=admin               # Web界面登录用户名（可选，不设置则无需认证）
      - PASS=password            # Web界面登录密码（需与USER同时设置）
      - TRANSMISSION_WEB_HOME=/trguing-cn/  # Web UI路径（可选，详见参数说明）
    volumes:
      - /path/to/data:/config    # 配置文件及日志存储路径（需替换为实际路径）
      - /path/to/downloads:/downloads  # 下载文件存储路径（需替换为实际路径）
      - /path/to/watch:/watch    # 监视目录（放置.torrent文件自动开始下载，需替换为实际路径）
    ports:
      - 9091:9091                # Web界面及RPC端口
      - 51413:51413              # BT传输TCP端口
      - 51413:51413/udp          # BT传输UDP端口
    restart: unless-stopped      # 容器重启策略（异常退出后自动重启）

启动容器：

docker-compose up -d

2. Docker CLI部署

直接通过命令行启动容器：

docker run -d \
  --name=transmission \
  -e PUID=1000 \
  -e PGID=1000 \
  -e UMASK=022 \
  -e TZ=Asia/Shanghai \
  -e USER=admin \
  -e PASS=password \
  -e TRANSMISSION_WEB_HOME=/trguing-cn/ \
  -p 9091:9091 \
  -p 51413:51413 \
  -p 51413:51413/udp \
  -v /path/to/data:/config \          # 替换为实际配置文件路径
  -v /path/to/downloads:/downloads \  # 替换为实际下载路径
  -v /path/to/watch:/watch \          # 替换为实际监视目录路径
  --restart unless-stopped \
  ddsderek/transmission:latest

配置参数详解

端口映射（-p）

环境变量（-e）

卷挂载（-v）