Transmission客户端实现文件下载黑名单功能的技术方案

背景与需求分析

在文件共享场景中，用户经常需要过滤特定类型的文件。例如某些用户希望自动跳过下载视频样本(sample)、文本说明(nfo)等非必要文件。Transmission作为主流BT客户端，原生支持通过脚本扩展实现这一需求。

技术实现原理

Transmission提供了脚本触发机制，当种子添加完成后会自动执行预设脚本。该功能基于以下两个核心配置项：

1. script-torrent-added-enabled：启用种子添加时触发脚本
2. script-torrent-added-filename：指定要执行的脚本路径

具体实现步骤

1. 配置脚本触发

在settings.json配置文件中添加：

{
    "script-torrent-added-enabled": true,
    "script-torrent-added-filename": "/path/to/your_script.sh"
}

2. 脚本编写要点

脚本通过环境变量获取种子信息：

• TR_TORRENT_ID：当前种子的唯一标识符
• TR_TORRENT_NAME：种子名称

典型处理流程：

1. 使用Transmission RPC API获取种子文件列表
2. 应用过滤规则（如文件扩展名正则匹配）
3. 通过API标记不需要的文件为"files-unwanted"

3. 过滤规则示例

常见的过滤策略包括：

• 扩展名黑名单（如.exe, .bat等可执行文件）
• 文件大小阈值（如小于1MB的样本文件）
• 路径关键词匹配（含"sample"、"temp"等目录）

注意事项

1. 脚本执行时机：需等待种子元数据完全加载后才会触发
2. 权限要求：脚本需具有可执行权限
3. 错误处理：建议脚本包含完善的日志记录和异常处理

高级应用场景

对于复杂需求，可以：

• 结合数据库维护动态黑名单
• 实现多条件组合过滤
• 集成病毒扫描等安全检查

该方案既保持了Transmission的轻量级特性，又通过灵活的脚本扩展满足了文件过滤需求，是功能性与简洁性的良好平衡。