Transmission部署实战：从Docker到群晖套件的避坑指南

1. 为什么选择Transmission？

作为一款老牌BT下载工具，Transmission在资源占用和稳定性方面一直表现优异。我实测对比过几款主流工具：qBittorrent功能全面但内存占用高，Deluge配置复杂，而Transmission就像个轻量级选手——在我的群晖DS220+上，Docker版常驻内存仅80MB左右，特别适合7×24小时挂机。

小白最容易忽略的是协议支持度。很多人不知道Transmission除了BT/PT，还支持HTTP/FTP下载（虽然不如aria2专业）。去年帮朋友抢救绝版资料时，就是靠它的磁力链接+种子备份功能成功找回数据。不过要注意，最新4.0+版本已移除UDP tracker支持，这点在PT站使用时需要留意。

2. Docker部署全流程详解

2.1 准备工作

先别急着敲命令，这几个坑我踩过：

• 存储路径：建议单独创建/volume1/docker/transmission目录，避免与系统卷混用
• 权限设置：群晖的File Station里，右键该目录→属性→权限，添加Everyone读写权限
• UID/GID：SSH登录后执行id命令，记下你的用户ID（通常管理员是1024）

这里有个真实案例：上次有位网友因为直接用root账号（UID=0）部署，导致下载的文件无法通过SMB访问，就是因为权限体系混乱。

2.2 编写docker-compose.yml

version: "3.8" services: transmission: image: lscr.io/linuxserver/transmission:latest container_name: transmission environment: - PUID=1024 # 替换为你的UID - PGID=100 # 通常users组是100 - TZ=Asia/Shanghai - TRANSMISSION_WEB_HOME=/combustion-release # 推荐用这个轻量UI volumes: - /volume1/docker/transmission/config:/config - /volume1/docker/transmission/downloads:/downloads - /volume1/docker/transmission/watch:/watch ports: - 9091:9091 - 51413:51413 - 51413:51413/udp restart: unless-stopped network_mode: bridge

关键参数解析：

• watch文件夹：把种子文件扔进去会自动开始下载
• PEERPORT：建议固定端口号，方便路由器做端口转发
• 如果遇到速度慢，可以添加- PEERPORT_SERVICE=51413环境变量

2.3 网络优化技巧

IPv6配置是提速的关键。先确认你的网络环境：

1. 登录路由器后台，查看IPv6前缀（通常以2xxx开头）
2. 在群晖控制面板→网络→接口，确认已获取IPv6地址
3. 测试公网连通性：ping6 ipv6.google.com

然后修改docker-compose.yml，添加以下配置：

sysctls: - net.ipv6.conf.all.disable_ipv6=0 - net.ipv6.conf.default.disable_ipv6=0 - net.ipv6.conf.lo.disable_ipv6=0

实测这个方案比host模式更安全，不会暴露所有主机端口。有个冷知识：Transmission的IPv6支持在PT站做种时，上传速度能提升3-5倍。

3. 群晖套件版为什么不推荐？

3.1 安装隐患

套件中心第三方源的Transmission存在几个致命问题：

• 版本滞后：目前还是2.94版，缺少关键安全更新
• 依赖冲突：可能影响Python等系统组件
• 权限混乱：默认使用root运行，安全风险高

去年有个典型案例：某用户因为套件版漏洞导致NAS被入侵，最后只能重装系统。这不是危言耸听，群晖官方文档也明确建议使用Docker替代第三方套件。

3.2 功能对比

最坑的是套件版会强制使用/volume1/downloads目录，这个设计反人类——万一你的系统盘不是volume1呢？

4. 高级调优指南

4.1 WebUI增强方案

原版界面确实简陋，推荐三个替代方案：

1. Combustion：极简风格，手机端适配好

   environment: - TRANSMISSION_WEB_HOME=/combustion-release

2. Transmissionic：Material Design风格

   DOCKER_MODS=linuxserver/mods:transmission-transmissionic

3. Flood：专业级面板（需要额外容器）

我最终选择了Combustion，因为它的响应速度最快。安装方法很简单：把release压缩包解压到config文件夹的web子目录即可。

4.2 速度优化参数

修改settings.json（位于config目录）：

{ "peer-limit-global": 200, "peer-limit-per-torrent": 50, "upload-slots-per-torrent": 4, "ratio-limit": 2, "idle-seeding-limit": 30, "utp-enabled": true }

避坑提示：

• cache-size-mb不要超过物理内存的1/4
• 启用加密传输能避免ISP限速
• 如果使用PT站，记得禁用DHT和PEX

4.3 自动化技巧

结合群晖的Task Scheduler可以实现：

• 自动清理完成种子的脚本
• 下载完成后触发媒体库扫描
• 定时限速（比如白天限速1Mbps）

这里分享我的夜间全速下载脚本：

#!/bin/bash curl -X POST -d '{"alt-speed-enabled":false}' http://localhost:9091/transmission/rpc

5. 常见问题解决方案

问题一：端口映射失败

• 检查路由器UPnP是否开启
• 在settings.json中确认peer-port-random-on-start为false
• 电信用户可能需要打10000号要求解除端口封锁

问题二：磁盘I/O瓶颈

• 使用iotop命令监控进程
• 考虑给Transmission单独挂载SSD缓存盘
• 修改preallocation为1（稀疏文件）

问题三：RPC连接失败

• 检查rpc-whitelist是否包含你的IP段
• 新版需要启用rpc-host-whitelist
• 用docker logs transmission查看实时日志

有个诊断技巧：在Transmission WebUI里按Ctrl+Alt+Shift+D可以调出调试控制台，所有网络请求一目了然。