Docker容器中transmission-remote因数据持续丢失无法完成种子下载

成因 #

• VPN链路传输错误：NordVPN容器的UDP转发丢包/端口限制是最可能的诱因。Transmission默认使用UDP协议进行Peer数据传输，当VPN链路UDP丢包率超过2%时，接收到的文件块校验失败会被直接丢弃，进度随之回落。越接近下载完成，剩余未下载块的重复校验逻辑越密集，错误块被识别回收的频率越高，就会出现进度反复波动的现象。
• Transmission 3.00 版本已知缺陷：3.00正式版存在块索引记录bug，当多任务同时运行、或通过代理/VPN链路传输时，会出现已完成校验的块被误标记为未下载的问题，触发重复下载，表现为进度回退、总下载量异常升高。
• Docker卷IO异步缓存丢失：映射的主机卷默认使用异步写入模式，Transmission写入到系统缓存的块还未同步到磁盘时，如果容器出现网络阻塞、CPU调度卡顿，缓存数据会被回收，已接收的块被判定为丢失需要重新下载。

防范方案 #

• 优化VPN链路配置
  • 透传Transmission默认端口51413的UDP/TCP规则到NordVPN容器，避免端口封禁导致的传输失败
  • 临时开启Transmission的强制TCP传输参数--tcp-enabled true测试，如果波动消失则更换UDP丢包率更低的VPN节点
• 调整Transmission运行参数
  • 增大磁盘缓存：修改配置文件中cache-size-mb参数为物理内存的1/8（最低不小于64），减少磁盘写入频率
  • 开启磁盘预分配：设置preallocation = 2，提前占满下载所需的磁盘空间，避免写入时磁盘不足导致块丢失
  • 条件允许可升级到Transmission 3.00-r1及以上稳定版本，修复块索引记录bug
• 优化Docker卷挂载配置
  • 挂载主机卷时添加sync,noatime参数，关闭异步写入缓存，确保收到的块及时写入物理磁盘
  • 不要使用网络存储、overlay联合文件系统作为下载存储卷，优先使用本地ext4/xfs分区的物理磁盘
• 临时规避策略：下载进度超过95%后，暂停其他所有下载、做种任务，减少带宽和IO争抢，降低块校验错误概率

内容的提问来源于stack exchange，提问作者xian16