OpenWrt中Transmission下载完成后脚本执行问题的深度解析与解决方案

问题背景

在OpenWrt 24.10版本中，Transmission作为常用的BT下载工具，其安全机制进行了重要升级。新版本引入了ujail进程隔离系统，这导致用户在配置"下载完成后执行脚本"功能时频繁遇到"找不到脚本路径"的错误。这种现象实际上是系统安全机制与用户自定义需求之间的冲突表现。

技术原理剖析

ujail安全机制

ujail是OpenWrt 24.10引入的类容器化安全方案，其工作原理类似于Docker的命名空间隔离：

1. 进程沙箱化：将服务运行在隔离的环境中
2. 资源访问控制：通过白名单机制限制可访问的路径
3. 系统调用过滤：使用seccomp策略限制危险操作

Transmission的安全策略

新版本Transmission默认启用了以下保护措施：

1. 严格的seccomp策略（/etc/seccomp/transmission-daemon.json）
2. 文件系统访问白名单
3. 子进程执行限制

问题复现与诊断

当用户尝试配置下载完成脚本时，系统会抛出两类典型错误：

1. 权限拒绝错误：由于seccomp默认策略设置为SCMP_ACT_KILL
2. 路径访问错误：ujail未将脚本所在目录加入可访问白名单

通过查看系统日志（logread），可以观察到类似以下关键信息：

Couldn't call script '/path/to/script.sh': Child process setup failed: No such file or directory

完整解决方案

第一步：调整seccomp策略

编辑/etc/seccomp/transmission-daemon.json文件，将默认动作改为记录而非终止：

{
    "defaultAction": "SCMP_ACT_LOG",
    ...
}

第二步：配置ujail访问规则

修改/etc/init.d/transmission启动脚本，在适当位置（约78行附近）添加：

local script_torrent_done_filename
config_get script_torrent_done_filename "$cfg" 'script_torrent_done_filename' '$config_dir/done.sh'

第三步：扩展访问白名单

在启动脚本中（约174行后）添加必要的路径访问权限：

procd_add_jail_mount_rw "/tmp"
procd_add_jail_mount "/bin"
procd_add_jail_mount "/usr/bin"
procd_add_jail_mount "/usr/lib/sudo"
procd_add_jail_mount "$script_torrent_done_filename"

第四步：完整重启服务

执行以下命令使配置生效：

service transmission restart

安全注意事项

1. 最小权限原则：仅添加必要的路径访问权限
2. 脚本安全：确保外部脚本来源可信
3. 定期审查：检查/var/log/messages中的seccomp日志
4. 替代方案：考虑使用transmission内置通知机制替代外部脚本

进阶建议

对于高级用户，还可以考虑：

1. 创建专用目录存放执行脚本
2. 为Transmission创建专用系统账户
3. 使用AppArmor进行更精细的访问控制
4. 定期备份settings.json配置文件

通过以上方案，用户可以在保证系统安全性的前提下，灵活使用Transmission的下载后处理功能。需要注意的是，任何安全策略的放宽都可能带来潜在风险，建议用户根据实际需求谨慎调整配置。