docker compose本身不支持跨节点数据共享，必须依赖外部存储系统（如nfs、cephfs或minio）并通过挂载方式接入；其volumes仅限本地或插件驱动，无法原生实现分布式卷管理。
使用 Docker Compose 本身无法直接实现跨节点数据共享，因为它默认只在单机上编排容器和服务。真正实现跨节点分布式存储卷，必须引入外部存储系统（如 Ceph、MinIO、NFS 或云存储），再通过 Docker 卷插件或挂载方式接入 Compose 配置。
明确 Docker Compose 的定位与局限
Docker Compose 是一个本地服务编排工具，不提供集群调度或跨主机卷管理能力。它的 volumes 声明仅支持本地路径、命名卷或第三方插件驱动，但原生不支持跨节点自动同步或分布。
- 本地命名卷（
driver: local）只存在于当前宿主机，其他节点无法访问 - 若需跨节点共享，必须将存储“外置”——即把数据存放在所有节点都能访问的统一后端
- Compose 可以声明挂载该后端（如 NFS 路径、S3 挂载点、CephFS 挂载目录），但不负责部署或维护该后端
推荐方案：用 NFS 作为轻量级跨节点共享底座
NFS 简单可靠，适合中小规模场景。先在一台服务器（如 192.168.10.100）部署 NFS 服务并导出目录，再在各 Docker 主机上挂载该目录，最后在 Compose 中以 bind mount 方式使用。
- 在 NFS 服务端配置
/etc/exports，例如：/data/shared *(rw,sync,no_subtree_check) - 各节点执行：
mkdir -p /mnt/nfs-shared && mount -t nfs 192.168.10.100:/data/shared /mnt/nfs-shared - Compose 文件中定义服务时，用
volume绑定挂载：services:<br> app:<br> image: nginx<br> volumes:<br> - /mnt/nfs-shared:/usr/share/nginx/html:rw
进阶方案：对接 CephFS 或 MinIO（对象存储适配）
对一致性、高可用要求更高的场景，可选 CephFS（POSIX 兼容）或 MinIO（S3 API）。注意二者接入方式不同：
- CephFS 需在每台宿主机安装 ceph-common 包，并挂载为本地目录（如
/mnt/cephfs），再通过 Compose 的bind mount引入 - MinIO 不是文件系统，不能直接挂载为卷；需改用应用层集成（如 SDK 访问 S3 接口），或借助 mergerfs + s3fs-fuse 实现类文件系统挂载（性能与稳定性需实测评估）
- 避免在 Compose 中硬编码 Ceph 或 MinIO 凭据；建议通过
env_file或 secrets 注入敏感配置
关键注意事项与避坑提示
跨节点共享的核心不是 Compose 写法，而是底层存储的一致性保障和权限对齐。
- 确保所有节点挂载点 UID/GID 一致（尤其 NFS/CephFS），否则容器内进程可能无权读写
- 禁用 NFS 的
noac（关闭属性缓存）或启用actimeo=1，避免多节点缓存不一致导致文件更新延迟可见 - 不要在 Compose 中用
driver: local创建跨节点同名卷——这只会创建多个孤立卷，造成数据割裂 - 若用 Swarm 模式，可结合
docker plugin install安装分布式卷插件（如 Portworx、Rancher Longhorn），但需额外部署插件服务，已超出 Compose 范畴
