在Synology NAS上运行Immich-Go时解决"mkdir /var/services/homes: file exists"错误

在使用Immich-Go工具从Google Photos迁移照片到自托管Immich服务器时，部分用户在Synology NAS设备上遇到了一个特殊错误。本文将深入分析这个问题的成因，并提供完整的解决方案。

问题现象

当用户在Synology NAS上执行以下命令时：

./immich-go upload from-google-photos --server=http://192.168.86.112:2283 --time-zone=Asia/Seoul --api-key=xxx takeout-*.zip

系统会返回错误信息：

Error: mkdir /var/services/homes: file exists

同时伴随完整的命令使用说明输出。这个错误看似简单，但实际上反映了NAS系统权限管理的特殊性。

问题根源分析

1. 权限限制：Synology NAS的DSM操作系统对普通用户权限有严格限制，特别是对系统目录如/var/services/homes的访问。

2. 目录结构特性：/var/services/homes是Synology为每个用户自动创建的主目录位置，普通用户通常没有权限在此创建子目录。

3. 临时文件处理：Immich-Go在处理Google Takeout压缩包时，可能需要创建临时目录来解压文件，而默认尝试在系统目录操作导致了权限问题。

解决方案

方法一：使用sudo提升权限（推荐）

最简单的解决方案是使用sudo命令以root权限运行：

sudo ./immich-go upload from-google-photos [其他参数]

方法二：指定工作目录

可以通过--workdir参数指定一个有写入权限的目录：

./immich-go upload from-google-photos --workdir=/volume1/your_folder [其他参数]

方法三：调整用户权限

1. 通过Synology DSM控制面板将执行用户加入administrators组
2. 或通过SSH使用root账户执行命令

最佳实践建议

1. 专用数据卷：建议在NAS上创建专门的数据卷(如/volume1/photo_migration)用于迁移工作
2. 环境准备：

   mkdir -p /volume1/temp/immich
   chmod 777 /volume1/temp/immich
   

3. 带工作目录执行的完整命令示例：

   sudo ./immich-go upload from-google-photos \
   --server=http://192.168.86.112:2283 \
   --time-zone=Asia/Seoul \
   --api-key=your_api_key \
   --workdir=/volume1/temp/immich \
   takeout-*.zip
   

技术原理延伸

Synology NAS的DSM系统基于Linux，但做了深度定制：

• 用户主目录统一存放在/var/services/homes下
• 普通用户权限受到严格限制，特别是对系统目录的写操作
• 数据卷(如/volume1)才是设计用于存储用户数据的区域

理解这些特性有助于在NAS环境下更好地部署各类自托管应用。对于Immich-Go这类需要临时文件处理空间的工具，明确指定工作目录是最稳妥的做法。