极空间 NAS 上跑 Docker 的踩坑记录

这台极空间 Z4Pro 用了快一年，最近才把常用服务都搬进 Docker。记录几个坑，给同样在极空间上折腾的人。

第一个坑是存储路径。极空间的「常用」共享目录在系统里是 /tmp/zfsv3/nvme13//data/，但 Web 界面显示的是「常用」。写 compose 挂载时如果照着界面路径填，容器里大概率找不到目录。要先用 ls 确认真实路径，或者干脆用 docker volume 让 Docker 自己管。

第二个坑是 zfuse 挂载权限。极空间的 zfuse 文件系统对容器内 uid/gid 很敏感，容器里跑的服务如果以 root 跑，写进挂载目录的文件 owner 会变成 root，之后在 Web 界面删不掉。解决办法是给容器显式指定 PUID/PGID，和共享目录的所有者一致。

第三个坑是端口。极空间自带一些服务占了常见端口，比如 5005、8080，写 compose 前先 netstat 看看有没有冲突，不然容器起不来还找不到原因。

最后是备份。极空间 Web 界面重建容器很方便，但 compose 文件最好也存一份在共享目录里，方便回滚。

—— 完 ——