PT & 媒体

我会怎么用

搭建下载、整理和播放链路，希望媒体库稳定且不反复返工的人。

推荐顺序

1. 先确定目录结构、文件命名和权限，再安装下载器、整理器和播放器，避免后期大规模迁移。
2. 用 TRaSH Guides 的通用原则建立质量档案和命名规则，但按自己的存储和带宽限制做取舍。
3. 下载一部小体积内容走完整链路，检查下载、校验、重命名、刮削和播放是否都成功。
4. 给磁盘、队列和转码资源设上限，并用 docker compose logs 定期查看失败原因。

结果怎么看

• “下载成功”与“播放流畅”是两件事，转码能力、字幕格式和客户端网络都要单独验证。
• 硬链接、挂载路径和容器内外 UID 不一致，是整理器重复下载或无法移动文件的常见原因。
• 先做小规模自动化，确认规则不会误删和误命名，再扩展到整个媒体库。

常见坑

• 把下载目录和媒体库放在不同文件系统，导致硬链接退化为复制并迅速吃满磁盘。
• 容器更新后环境变量或路径变化，服务能启动但看不到原有数据。
• 公开分享私人媒体入口或 PT 信息，带来账号和合规风险。

安全提醒

• 只处理自己有权访问和保存的内容，遵守站点规则与当地法律。
• 不要把下载器 WebUI、Cookie 或站点 passkey 放进公开截图和日志。

维护者备注：媒体服务先追求“可恢复、可解释”，自动化规则宁可慢一点，也不要让错误悄悄扩大。