Docker 玩法

飞牛NAS部署Transmission：PT下载必备

2026-07-30 3 views admin

准备工作：了解Transmission与飞牛NAS

对于PT玩家来说，一个稳定高效的下载工具是必需品。Transmission作为一款轻量级、资源占用低的BT/PT客户端，在NAS环境中表现尤为出色。飞牛NAS基于Debian系统，拥有完善的Docker支持，部署Transmission非常便捷。本文将手把手教你在飞牛NAS上完成部署，并配置适合PT使用的参数。

在开始前，请确保你的飞牛NAS已经安装Docker（系统自带或通过应用商店安装），并且有稳定的网络环境。建议提前准备一个存放下载数据的目录，比如在文件管理器中创建 /docker/transmission 和 /downloads 两个文件夹。

第一步：拉取Transmission镜像

打开飞牛NAS的SSH终端，或者直接使用系统自带的终端工具。输入以下命令拉取官方镜像：

docker pull linuxserver/transmission:latest

这个镜像由LinuxServer.io维护，更新及时，配置合理，适合长期使用。拉取完成后，可以用 docker images 确认镜像已经存在。

第二步：创建并运行容器

使用docker run命令创建容器，这是最常用的方式。建议先创建挂载目录，然后执行以下命令：

docker run -d \
  --name=transmission \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Shanghai \
  -e USER=admin \
  -e PASS=yourpassword \
  -p 9091:9091 \
  -p 51413:51413 \
  -p 51413:51413/udp \
  -v /docker/transmission:/config \
  -v /downloads:/downloads \
  --restart unless-stopped \
  linuxserver/transmission:latest

参数说明： - PUID/PGID：用户和组ID，建议设为与飞牛NAS管理用户一致（通常1000），避免权限问题 - TZ：时区，设置为上海时间 - USER/PASS：Web管理界面的登录账号和密码，务必修改为强密码 - 端口映射：9091为Web管理端口，51413为BT传输端口（TCP和UDP） - 卷映射：/config存放配置文件，/downloads存放下载数据

如果你需要修改下载目录或配置文件路径，请根据实际情况调整 -v 参数。建议将下载目录映射到NAS的大容量存储池中。

第三步：配置PT优化参数

容器运行后，访问 http://你的NASIP:9091，用刚才设置的账号密码登录。先别急着下载，我们需要调整几个关键参数以适应PT站点要求。

首先，停止Transmission服务（在Web界面点击左上角菜单，选择“停止传输”），然后编辑配置文件。配置文件位于映射的 /config 目录下，文件名 settings.json。

用以下命令修改配置文件：

nano /docker/transmission/settings.json

找到并修改以下关键参数：

"download-dir": "/downloads/complete",
"incomplete-dir": "/downloads/incomplete",
"incomplete-dir-enabled": true,
"ratio-limit": 2.0,
"ratio-limit-enabled": true,
"seed-queue-enabled": true,
"seed-queue-size": 10,
"peer-port": 51413,
"port-forwarding-enabled": false,
"encryption": 1,
"dht-enabled": false,
"pex-enabled": false,
"lpd-enabled": false,
"blocklist-enabled": false,
"rpc-whitelist": "127.0.0.1,192.168.*.*",
"rpc-whitelist-enabled": true,
"upload-slots-per-torrent": 8,
"speed-limit-up": 0,
"speed-limit-up-enabled": false

重点说明： - encryption设为1表示优先加密，PT站点通常要求启用 - dht、pex、lpd全部关闭，这是PT的基本规范，避免泄露种子信息 - 设置上传限速为0（不限速），实际速度由你的带宽和PT站点规则决定 - ratio-limit设为2.0，做种率达到200%后自动停止（可根据站点要求调整） - rpc-whitelist添加你的局域网段，确保内网设备可以访问Web界面

保存文件后，在Web界面启动服务，或重启容器：

docker restart transmission

第四步：添加种子开始下载

现在可以正式使用了。通过Web界面上传种子文件，或者直接通过RPC接口添加。推荐两个方式：

方式一：Web界面操作 点击左上角的“打开”按钮，选择本地的.torrent文件，或者直接粘贴PT站点的磁力链接。设置下载路径（通常保持默认即可），点击“上传”开始。

方式二：通过环境变量自动添加 将种子文件放入 /docker/transmission/watch 目录（需要手动创建），Transmission会自动检测并添加。这个功能非常适合批量操作。

第五步：进阶技巧与故障排查

常见问题处理：

  1. 权限问题：如果下载文件显示只读或无法写入，检查PUID/PGID设置，确保与NAS管理用户一致。可以用 id 用户名 查看用户ID。

  2. 端口不通：登录飞牛NAS的防火墙设置，确保51413端口已开放。部分路由器需要设置端口转发。

  3. 下载速度慢：确认PT站点是否要求启用特定设置（如加密、DHT等），检查上传速度是否被限制。Transmission默认的上传连接数偏保守，可以适当调高 upload-slots-per-torrent 的值。

  4. Web界面无法访问：检查9091端口映射是否正确，以及rpc-whitelist是否包含你的客户端IP。如果在外网访问，建议通过反向代理或VPN，不要直接暴露端口。

高级优化建议：

  • 设置计划任务：编辑 /config/settings.json 中的 alt-speed 相关参数，可以实现定时限速，避免白天影响办公网络
  • 使用Watch目录配合FlexGet：实现RSS自动下载，彻底解放双手
  • 挂载远程存储：将下载目录映射到Samba或NFS共享，方便其他设备访问

总结

通过以上步骤，你在飞牛NAS上成功部署了Transmission，并完成了PT优化配置。这套方案具有资源占用低、运行稳定、配置灵活的特点，完全可以满足日常PT下载需求。建议定期检查日志（docker logs transmission），更新镜像版本，让你的下载工具始终保持最佳状态。现在，去享受高速下载的乐趣吧！

💬 评论区
leave a comment

no comments yet