Tdarr项目中的空间统计修复指南

在使用Tdarr进行媒体文件转码管理时，有时会遇到空间统计信息不准确的情况。本文将详细介绍如何手动修复Tdarr中的空间统计信息，特别是当文件系统配置错误导致统计偏差时。

问题背景

当用户错误配置了/etc/fstab文件导致挂载点失效时，Tdarr服务器容器无法访问实际文件。这种情况下，系统会将文件大小误报为0字节，导致转码流程失败。更严重的是，这些失败操作会被错误地计入"成功/无需处理"的统计中，造成空间节省统计数据的严重偏差。

技术原理

Tdarr的空间节省统计主要基于两个核心数据存储：

1. 全局统计数据：存储在server/Tdarr/DB2/StatisticsJSONDB中
2. 各媒体库的独立统计：存储在LibrarySettingsJSONDB中

这些数据以JSON格式保存，其中sizeDiff字段记录了空间节省的累计值。系统不会保留单个文件的历史处理记录，只有聚合的统计值。

解决方案

要手动修正空间统计信息，需要直接编辑上述两个数据库文件中的sizeDiff值：

1. 首先停止Tdarr服务，确保数据不会被同时修改
2. 备份原始数据库文件
3. 使用文本编辑器打开StatisticsJSONDB文件
4. 定位到sizeDiff字段，将其值调整为正确的空间节省数值
5. 对于各媒体库的独立统计，同样编辑LibrarySettingsJSONDB中的对应值
6. 保存修改后重启Tdarr服务

注意事项

1. 修改前务必备份原始数据，防止意外损坏
2. 建议在系统负载较低时进行操作
3. 对于大型媒体库，可能需要重新计算所有文件的实际节省空间
4. 修正后应监控系统运行一段时间，确认统计信息正常更新

预防措施

为避免类似问题再次发生，建议：

1. 在修改/etc/fstab前进行充分测试
2. 使用mount -a命令测试配置是否正确
3. 设置监控检查挂载点状态
4. 定期备份Tdarr数据库

通过以上方法，可以有效修复因配置错误导致的空间统计偏差问题，确保Tdarr系统提供准确的数据分析。