PeerTube升级后WebTorrent文件路径变更问题解析

问题背景

PeerTube作为一款开源的分布式视频平台，在从5.2.1版本升级到6.0.2版本后，部分用户遇到了WebTorrent视频文件无法访问的问题。这个问题主要影响那些在升级前已经存在的视频文件，特别是通过WebTorrent方式转码的视频。

问题现象

升级后，用户发现之前通过WebTorrent转码的视频链接失效。具体表现为：

1. 旧视频的WebTorrent下载链接会被重定向到新的S3存储路径
2. 新路径中自动添加了"webtorrent"目录前缀
3. 由于文件实际存储位置未同步更新，导致访问时出现"NoSuchKey"错误

技术分析

存储结构变更

在PeerTube 5.2.1版本中，WebTorrent转码文件的存储路径为直接放在对象存储的根目录下。而在6.0.2版本中，PeerTube对存储结构进行了优化调整，所有WebTorrent转码文件都被统一存放在"webtorrent"子目录下。

路径重定向机制

PeerTube 6.0.2版本引入了新的路径重定向逻辑：

• 当用户请求旧版路径时，系统会自动将其转换为新版路径格式
• 转换过程中会自动添加"webtorrent"前缀
• 但由于实际文件并未迁移，导致访问失败

数据库记录

视频文件的存储路径信息保存在数据库中，升级过程中这些记录并未自动更新为新的路径格式，而文件系统层面的重定向又依赖于这些记录。

解决方案

要解决此问题，需要执行以下步骤：

1. 文件迁移：将所有旧的WebTorrent转码文件从对象存储根目录移动到"webtorrent"子目录下
2. 数据库更新：更新数据库中这些视频文件的存储路径记录，添加"webtorrent"前缀
3. 缓存清理：清除相关缓存，确保新的路径能够立即生效

预防措施

为避免未来升级时出现类似问题，建议：

1. 在升级前仔细阅读版本变更说明，特别是涉及存储结构变更的内容
2. 对重要数据进行备份
3. 在测试环境中先行验证升级过程
4. 制定详细的升级和迁移计划

总结

PeerTube 6.0.2版本对WebTorrent文件的存储结构进行了优化，但这一变更需要配合手动迁移操作才能完全生效。理解存储结构的变更原理有助于系统管理员更好地维护PeerTube实例，确保升级过程的平滑过渡。对于依赖WebTorrent功能的用户和应用，及时执行文件迁移和数据库更新是解决问题的关键。