docker-transmission-ghost 镜像文档

镜像概述

docker-transmission-ghost 是一个围绕 linuxserver/transmission 构建的配置包装器镜像。Transmission 是一款轻量级、跨平台的 BitTorrent 客户端，而本镜像旨在简化其配置流程，帮助用户更便捷地部署和管理 Transmission 服务。

核心功能与特性

• 配置简化：作为 linuxserver/transmission 的包装层，提供更便捷的配置方式，减少手动配置步骤。
• 兼容性：完全兼容 linuxserver/transmission 的核心功能与架构，保留其原有特性（如轻量级设计、Web 管理界面等）。
• 配置管理：优化配置文件的组织与加载逻辑，便于用户通过挂载目录或环境变量快速定制 Transmission 行为。

使用场景与适用范围

• 个人媒体服务器：需快速部署 Transmission 进行 BT 下载的个人或家庭媒体中心场景。
• 简化配置需求：对 Transmission 配置不熟悉，或希望减少手动配置工作量的用户。
• 容器化部署：适用于通过 Docker 容器化方式部署 Transmission 的环境，如 NAS、Linux 服务器等。

使用方法与配置说明

基本要求

• 已安装 Docker 环境（Docker Engine 19.03+ 推荐）。
• 了解基础 Docker 命令（如 docker run、docker-compose）。

Docker Run 示例

docker run -d \
  --name=transmission-ghost \
  -p 9091:9091 \  # Web 管理界面端口
  -p 51413:51413/tcp \  # BT 监听端口（TCP）
  -p 51413:51413/udp \  # BT 监听端口（UDP）
  -v /path/to/local/config:/config \  # 挂载配置目录（核心配置文件存放位置）
  -v /path/to/local/downloads:/downloads \  # 挂载下载目录
  -v /path/to/local/watch:/watch \  # 挂载监控目录（自动下载放入此目录的种子文件）
  -e PUID=1000 \  # 运行服务的用户 ID（需与本地目录权限匹配）
  -e PGID=1000 \  # 运行服务的组 ID（需与本地目录权限匹配）
  -e TZ=Asia/Shanghai \  # 时区设置（如 Asia/Shanghai 表示中国时区）
  --restart unless-stopped \
  docker-transmission-ghost

配置说明

1. 核心挂载目录：

   • /config：配置文件目录，包含 Transmission 的核心配置（如 settings.json），需通过本地目录挂载以持久化配置。
   • /downloads：下载文件存储目录，建议挂载本地目录以保存下载内容。
   • /watch：监控目录，放入此目录的 .torrent 文件将被 Transmission 自动加载下载。

2. 环境变量：

   • PUID/PGID：指定运行服务的用户和组 ID，用于解决目录权限问题（通常设为当前用户的 UID/GID）。
   • TZ：设置时区，确保日志时间、任务计划等时间相关功能正常。

3. 网络端口：

   • 9091：Transmission Web 管理界面端口，通过浏览器访问 http://<容器IP>:9091 进行管理。
   • 51413（TCP/UDP）：BT 协议监听端口，需确保端口在防火墙中开放，以保证正常连接 peers。

注意事项

• 本镜像依赖 linuxserver/transmission 的基础功能，详细配置选项可参考 linuxserver/transmission 官方文档。
• 首次运行时，/config 目录会生成默认配置文件，用户可通过修改 settings.json 进一步自定义（如修改下载限速、Web 认证等）。
• 如需使用 Docker Compose 部署，可参考上述 docker run 参数编写 docker-compose.yml 文件。