一、把「配置」和「数据」分开
几乎所有应用都有两类文件:可以重建的配置,和不能丢的用户数据。
- 配置目录:应用名/config,备份体积小、频率高。
- 数据目录:应用名/data,体积大、变动多,需要单独考虑备份策略。
- 两者都放在存储池里,不要放在系统盘或容器内部。
二、每个应用一个独立目录
统一结构,出问题时能一眼看懂哪块属于谁。
- 例如 /vol1/docker/immich/{config,data}、/vol1/docker/qbittorrent/config。
- 不要多个应用共用一个 config 目录,升级时容易互相覆盖。
- 目录名用英文小写,避免路径里出现空格和中文,减少兼容问题。
三、权限用 PUID / PGID 对齐
「容器起来了但写不进文件」绝大多数是权限问题。
- 先查宿主机上目标目录的属主 UID / GID,再把容器的 PUID / PGID 设成同样的值。
- 不要图省事一律用 root 跑容器。
- 改完权限后重启容器再看日志,不要反复重建。
提示权限问题不要靠 chmod 777 解决,那只是把问题藏起来。
四、端口和反向代理提前规划
十几个应用各占一个端口,很快就记不住了。
- 固定一段端口范围给 Docker 使用,并记录每个应用占用的端口。
- 需要外网访问的应用,统一走反向代理 + 子域名,不直接暴露端口。
- 内网才用的管理类应用,不映射到公网。
五、升级前先备份配置
镜像升级失败是最常见的故障,配置目录在,恢复只要几分钟。
- 升级前把 config 目录打包一份。
- 把 compose 文件也一起存进去。
- 记录当前镜像版本号,方便回滚。
本文基于飞牛 fnOS 当前版本整理,实际操作以你设备上的界面为准。