Docker 应用部署前,数据目录应该怎么规划

容器可以随时删了重建,数据目录规划错了却要迁移很久。开工前花十分钟定好这几件事。

Docker更新于 2026-11-15约 6 分钟读完

一、把「配置」和「数据」分开

几乎所有应用都有两类文件:可以重建的配置,和不能丢的用户数据。

  • 配置目录:应用名/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 当前版本整理,实际操作以你设备上的界面为准。