Transmission Docker镜像文档

镜像概述

Transmission Docker镜像是基于轻量级开源BitTorrent客户端Transmission构建的容器化应用，旨在提供快速部署、易于管理的BT下载服务。该镜像封装了Transmission核心功能，通过容器化方式简化部署流程，无需复杂配置即可搭建个人BT下载服务。

核心功能与特性

核心功能

• BitTorrent协议支持：完整支持BT下载协议，包括磁力链接、种子文件下载
• Web界面管理：内置Web管理界面，可通过浏览器远程控制下载任务
• 任务管理：支持下载任务的添加、暂停、继续、删除等操作，显示实时下载进度
• 配置灵活性：可通过环境变量或配置文件自定义下载路径、端口、用户认证等参数

主要特性

• 轻量级设计：镜像体积小，运行时资源占用低，适合低配置设备（如树莓派）
• 开源免费：基于GPL协议开源，无功能限制，可自由修改和分发
• 跨平台兼容：支持x86、ARM等多种架构，可在PC、服务器、嵌入式设备上运行
• 自动重启：结合Docker容器特性，支持服务异常时自动重启，提高稳定性

使用场景与适用范围

适用场景

• 个人BT下载服务：为个人用户提供稳定的BT下载环境，避免直接在本地电脑运行BT客户端占用系统资源
• 家庭媒体服务器辅助：配合家庭媒体服务器（如Plex、Emby），自动下载媒体文件并存储至媒体库
• 私有下载节点：在服务器或NAS设备上部署，作为私有下载节点管理下载任务

适用人群

• 个人用户：需要简单可靠的BT下载工具
• 家庭用户：搭建家庭下载中心
• 开发者/极客：需要轻量级BT服务用于测试或个人项目

使用方法与配置说明

快速部署（docker run）

通过以下命令快速启动Transmission容器：

docker run -d \
  --name transmission \
  -p 9091:9091 \  # Web界面端口
  -p 51413:51413 \  # BT监听端口(TCP)
  -p 51413:51413/udp \  # BT监听端口(UDP)
  -v /path/to/downloads:/transmission/downloads \  # 下载文件存储目录
  -v /path/to/config:/transmission/config \  # 配置文件存储目录
  -v /path/to/incomplete:/transmission/incomplete \  # 未完成下载目录
  -e TRANSMISSION_USER=admin \  # Web界面登录用户名
  -e TRANSMISSION_PASSWORD=password \  # Web界面登录密码
  -e TRANSMISSION_WEB_PORT=9091 \  # Web界面端口(需与-p映射一致)
  -e TRANSMISSION_DOWNLOAD_DIR=/transmission/downloads \  # 下载文件目录
  --restart unless-stopped \
  linuxserver/transmission  # 常用的Transmission官方维护镜像

Docker Compose配置

创建docker-compose.yml文件，内容如下：

version: '3'
services:
  transmission:
    image: linuxserver/transmission
    container_name: transmission
    restart: unless-stopped
    ports:
      - "9091:9091"  # Web界面端口
      - "51413:51413"  # BT监听端口(TCP)
      - "51413:51413/udp"  # BT监听端口(UDP)
    environment:
      - PUID=1000  # 运行用户ID(与宿主机用户ID一致，避免权限问题)
      - PGID=1000  # 运行用户组ID
      - TZ=Asia/Shanghai  # 时区设置
      - TRANSMISSION_USER=admin  # Web界面登录用户名
      - TRANSMISSION_PASSWORD=password  # Web界面登录密码
      - TRANSMISSION_WEB_PORT=9091  # Web界面端口
      - TRANSMISSION_DOWNLOAD_DIR=/transmission/downloads  # 完成下载目录
      - TRANSMISSION_INCOMPLETE_DIR=/transmission/incomplete  # 未完成下载目录
      - TRANSMISSION_WATCH_DIR=/transmission/watch  # 监控目录(放入种子文件自动开始下载)
    volumes:
      - /path/to/config:/config  # 配置文件存储目录
      - /path/to/downloads:/downloads  # 完成下载文件存储目录
      - /path/to/incomplete:/incomplete  # 未完成下载文件存储目录
      - /path/to/watch:/watch  # 监控目录

启动服务：

docker-compose up -d

环境变量说明

卷挂载说明

访问与管理

服务启动后，通过浏览器访问 [***] 进入Web管理界面，使用配置的用户名（TRANSMISSION_USER）和密码（TRANSMISSION_PASSWORD）登录。登录后可通过界面添加下载任务、管理任务状态、查看下载进度等。

注意事项

• 权限问题：确保宿主机挂载目录的权限与容器PUID/PGID一致，避免下载文件无法写入或读取
• 端口映射：BT监听端口(默认51413)需同时映射TCP和UDP协议，否则可能影响Peer连接
• 安全配置：建议设置强密码，避免未授权访问；家庭网络中可通过路由器端口转发实现外网访问(需谨慎，建议配合***使用)
• 资源限制：低配置设备可通过Docker的--memory和--cpus参数限制容器资源占用