Immich-go处理Google Takeout大文件上传时的临时目录优化方案

问题背景

在使用Immich-go工具从Google Takeout导入大量照片视频到Immich系统时，用户遇到了"no space left on device"的错误提示。尽管服务器存储空间充足（显示有2.7TB可用空间），但工具在处理过程中因临时目录空间不足而中断。

问题分析

Immich-go默认会将临时文件和日志文件存储在/root/.cache/immich-go/temp/目录下。这个目录通常位于系统分区，空间有限，特别是当处理大量数据时（如37个50GB的ZIP文件），很容易耗尽空间。错误信息明确指出了临时文件写入失败的问题。

解决方案

1. 修改临时文件目录

通过设置环境变量IMMICHGO_TEMPDIR，可以将临时文件存储到空间更大的位置：

export IMMICHGO_TEMPDIR=/path/to/large/space/temp

2. 自定义日志文件路径

使用--log-file参数指定日志文件的完整路径，避免日志文件占用临时目录空间：

./immich-go upload from-google-photos --server=http://192.168.86.112:2283 --time-zone=Asia/Seoul --api-key=xxxxxx --log-file=/path/to/large/space/immich-go.log takeout-*.zip

最佳实践建议

1. 预处理检查：在开始导入前，预估临时空间需求，确保目标目录有足够空间
2. 分批处理：对于特别大的Takeout数据集，考虑分批处理多个较小的ZIP文件
3. 监控空间使用：在导入过程中监控临时目录的空间使用情况
4. 清理策略：定期清理旧的临时文件，特别是当导入过程中断时

技术原理

Immich-go在处理Google Takeout文件时需要临时空间用于：

• 解压缩ZIP文件
• 预处理媒体文件
• 缓存上传队列
• 存储处理日志

这些操作都需要足够的磁盘空间支持，特别是在处理高分辨率视频等大文件时。通过将临时目录重定向到专用的大容量存储位置，可以有效解决空间不足的问题。

总结

对于大规模数据迁移项目，合理配置临时文件存储位置是确保流程顺利进行的关键因素。Immich-go提供了灵活的配置选项，允许用户根据实际环境调整存储策略。通过上述方法，用户可以顺利完成从Google Photos到Immich的大规模数据迁移工作。