cptactionhank/transmission

docker-transmission 镜像文档

镜像概述

docker-transmission镜像是基于Transmission BitTorrent客户端的容器化实现，提供轻量级、高效的BT文件下载与管理能力。Transmission以简洁界面、低资源占用和跨平台支持为特点，通过Docker容器化部署可实现快速启动、环境隔离和简化配置，适用于个人用户及小型服务场景。

核心功能与特性

• 轻量级架构：低系统资源占用，运行高效稳定
• Web管理界面：内置Web UI，支持通过浏览器远程管理下载任务
• 多协议支持：兼容BitTorrent、DHT、PEX等主流BT协议
• 安全传输：支持传输加密，保护下载隐私与数据安全
• 灵活配置：通过环境变量或配置文件自定义下载路径、端口、用户认证等参数
• 跨平台兼容：支持x86_64、ARM等多种硬件架构

使用场景与适用范围

• 个人用户BT文件下载与管理
• 家庭媒体中心资源获取
• 服务器环境中隔离部署的BT下载服务
• 开发/测试环境临时文件共享

使用方法与配置说明

基本部署（docker run）

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

bash
docker run -d \
  --name transmission \
  -p 9091:9091 \  # Web管理界面端口
  -p 51413:51413 \  # BT传输端口(TCP)
  -p 51413:51413/udp \  # BT传输端口(UDP)
  -v /本地路径/downloads:/downloads \  # 下载文件存储目录
  -v /本地路径/config:/config \  # 配置文件存储目录
  -e USER=自定义用户名 \  # Web登录用户名
  -e PASSWORD=自定义密码 \  # Web登录密码
  linuxserver/transmission

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3'
services:
  transmission:
    image: linuxserver/transmission
    container_name: transmission
    ports:
      - "9091:9091"
      - "51413:51413"
      - "51413:51413/udp"
    volumes:
      - /本地路径/downloads:/downloads
      - /本地路径/config:/config
    environment:
      - USER=自定义用户名
      - PASSWORD=自定义密码
      - TZ=Asia/Shanghai  # 设置时区
      - DOWNLOAD_DIR=/downloads  # 下载文件存储路径
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

访问与管理

容器启动后，通过浏览器访问 http://<主机IP>:9091，使用配置的用户名和密码登录Web管理界面，可执行添加种子、管理下载任务、查看传输状态等操作。

环境变量配置

常用环境变量说明：

注意事项

• 确保本地映射目录具有读写权限，避免权限错误
• 防火墙需开放9091（Web）和51413（BT传输）端口
• 大规模下载时建议配置适当的缓存大小和连接数限制，避免资源耗尽