Transmission

镜像概述和主要用途

Transmission是一款轻量级BitTorrent客户端，本Docker镜像为其提供跨平台打包部署方案，支持amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、mips64le、ppc64le、riscv64、s390x等架构，可快速部署用于文件下载与共享的BitTorrent服务。

核心功能和特性

• 多平台支持：适配多种硬件架构，满足不同设备部署需求
• 灵活配置：通过环境变量自定义时区、RPC认证信息及端口参数
• 数据持久化：支持配置文件、下载文件、未完成文件及种子文件的目录挂载
• 便捷部署：提供Docker CLI和Docker Compose两种部署方式，简化搭建流程

使用场景和适用范围

适用于个人用户搭建私有下载服务、小型团队共享文件等场景，尤其适合需要在多架构设备（如x86服务器、ARM开发板等）上快速部署BitTorrent客户端的需求。

使用方法和配置说明

Docker CLI部署

通过命令行直接启动容器，示例如下：

bash
docker run -d \
  --name=transmission \
  -e TZ=Etc/UTC \  # 时区设置（如Asia/Shanghai）
  -e RPC_USER=admin \  # RPC管理界面用户名
  -e RPC_PASS=admin \  # RPC管理界面密码
  -e RPC_PORT=9091 \  # Web管理界面端口
  -e PEER_PORT=51413 \  # 对等连接端口
  -p 9091:9091 \  # 映射Web管理端口到宿主机
  -p 51413:51413 \  # 映射TCP对等连接端口
  -p 51413:51413/udp \  # 映射UDP对等连接端口
  -v /path/to/config:/var/lib/transmission/config \  # 配置文件目录（可选）
  -v /path/to/downloads:/var/lib/transmission/downloads  \  # 已完成下载文件目录
  -v /path/to/incomplete:/var/lib/transmission/incomplete  \  # 未完成下载文件目录
  -v /path/to/torrents:/var/lib/transmission/torrents  \  # 种子文件存储目录
  --restart unless-stopped \  # 容器退出时自动重启（除非手动停止）
  snowdreamtech/transmission:latest

Docker Compose部署

使用配置文件定义服务，示例如下：

yaml
version: "3"

services:
  transmission:
    image: snowdreamtech/transmission:latest
    container_name: transmission  # 容器名称
    environment:
      - TZ=Etc/UTC  # 时区设置（如Asia/Shanghai）
      - RPC_USER=admin  # RPC管理界面用户名
      - RPC_PASS=admin  # RPC管理界面密码
      - RPC_PORT=9091  # Web管理界面端口
      - PEER_PORT=51413  # 对等连接端口
    volumes:
      - /path/to/config:/var/lib/transmission/config  # 配置文件目录（可选）
      - /path/to/downloads:/var/lib/transmission/downloads  # 已完成下载文件目录
      - /path/to/incomplete:/var/lib/transmission/incomplete  # 未完成下载文件目录
      - /path/to/torrents:/var/lib/transmission/torrents  # 种子文件存储目录
    ports:
      - 9091:9091  # Web管理端口映射
      - 51413:51413  # TCP对等连接端口映射
      - 51413:51413/udp  # UDP对等连接端口映射
    restart: unless-stopped  # 容器退出时自动重启（除非手动停止）

开发构建

如需构建多平台镜像，可使用以下命令：

bash
# 创建并使用buildx构建实例
docker buildx create --use --name build --node build --driver-opt network=host
# 构建并推送多平台镜像
docker buildx build -t snowdreamtech/transmission --platform=linux/386,linux/amd64,linux/arm/v6,linux/arm/v7,linux/arm64,linux/ppc64le,linux/riscv64,linux/s390x . --push

参考资料

1. 使用 buildx 构建多平台 Docker 镜像
2. 如何使用 docker buildx 构建跨平台 Go 镜像
3. Building Multi-Arch Images for Arm and x86 with Docker Desktop
4. How to Rapidly Build Multi-Architecture Images with Buildx
5. Faster Multi-Platform Builds: Dockerfile Cross-Compilation Guide
6. docker/buildx

联系方式（备注：base）

• ：

• ---

• ---

• 微信/***：sn0wdr1am

许可证

MIT