Transmission 下载完成后自动复制种子文件的技术实现

背景介绍

Transmission 是一个轻量级的 BT 客户端，广泛应用于 Linux 服务器环境。在实际使用中，用户经常需要在下载完成后执行一些自动化操作，比如复制种子文件到指定目录以便后续做种或备份。

问题分析

在 Ubuntu 22.04 系统上运行 Transmission 4.0.5 版本时，用户希望通过脚本在下载完成后将种子文件从 Transmission 的默认存储位置复制到其他目录。但遇到了权限问题和脚本执行错误。

关键知识点

1. Transmission 的脚本触发机制：通过设置 script-torrent-done-filename 参数可以指定下载完成时执行的脚本。

2. 种子文件存储位置：默认情况下，Transmission 将种子文件存储在 /var/lib/transmission-daemon/.config/transmission-daemon/torrents/ 目录下，文件名格式为 [哈希值].torrent。

3. 权限管理：Transmission 默认以 debian-transmission 用户运行，该用户对种子文件有读写权限。

解决方案

正确的脚本编写方法

1. 环境变量使用：Transmission 会向脚本传递多个环境变量，如 TR_TORRENT_HASH 和 TR_TORRENT_NAME，可以直接在脚本中使用。

2. 路径处理：在脚本中正确处理路径和引号，避免语法错误。例如：

#!/bin/bash
set -x -v
exec &> /tmp/script.log

# 正确写法：变量在双引号外展开
cp "/var/lib/transmission-daemon/.config/transmission-daemon/torrents/${TR_TORRENT_HASH}.torrent" "/media/Download/torrent/reseed/${TR_TORRENT_NAME}.torrent"

权限配置要点

1. 目标目录权限：确保 debian-transmission 用户对目标目录有写入权限。对于 NTFS 挂载的分区，需要在 /etc/fstab 中正确配置挂载选项。

2. 测试脚本权限：可以使用 sudo -u debian-transmission bash 命令以 Transmission 的运行用户身份测试脚本。

系统服务配置注意事项

1. 不推荐以 root 运行：虽然可以修改 systemd 服务文件让 Transmission 以 root 运行，但这会带来安全隐患。

2. 正确的服务配置：保持默认的 debian-transmission 用户运行，只需确保脚本和目录权限正确即可。

最佳实践建议

1. 日志记录：在脚本中添加日志记录功能，便于排查问题。

2. 错误处理：增加错误判断逻辑，确保脚本健壮性。

3. 定期维护：定期清理旧的种子文件备份，避免占用过多存储空间。

通过以上方法，可以可靠地实现 Transmission 下载完成后自动复制种子文件的功能，同时保证系统的安全性和稳定性。