生产环境必须使用命名卷（Named Volume）并显式指定name字段，避免匿名卷和绑定挂载；按服务职责分离卷（如pg-data、app-uploads）、预设UID/GID权限、配套日志轮转与磁盘监控。

生产环境用 Docker 数据卷（Volume），核心是可靠、可维护、不依赖宿主机路径。直接挂宿主机目录（Bind Mount）在开发阶段方便，但上线后容易出问题——比如路径硬编码、权限错乱、集群无法迁移。真正稳的方案，是用命名卷（Named Volume）配合 Compose 显式管理。

用命名卷替代匿名卷和绑定挂载

匿名卷（如 - /var/lib/postgresql/data）由 Docker 自动分配随机名，不好追踪、难备份；绑定挂载（如 - ./config:/app/config）把项目路径耦合进配置，换机器或 CI 环境就失效。生产必须用命名卷，并显式指定名称。

• 在 docker-compose.yml 中定义带 name: 的卷，确保跨环境名称一致
• 数据库、上传目录、缓存等持久化路径全部走命名卷，不写绝对路径
• 避免在 volumes: 下只写 db-data: 这种简写，必须补全 name: 字段

按服务职责分离卷，避免混用

一个卷对应一类数据，比如数据库数据、用户上传、日志归档，各自独立。混用会导致权限冲突、备份粒度失控、升级时误删。

minimax-mcp-docker版（适配极空间）

MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境（极空间等），支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件，不暴露在代码中。

下载

• pg-data：专用于 PostgreSQL 的数据目录
• app-uploads：存放用户上传的图片/文件
• redis-data：Redis 的 RDB/AOF 存储位置
• 每个卷在 Compose 中单独声明，不复用同一卷名

设置合理属主与权限，容器内非 root 运行

很多崩溃源于权限不匹配：容器以 node 用户启动，却要往 root 权限的卷里写日志。解决办法是提前初始化卷并设好属主。

• 启动前用 docker volume create --driver local --opt o=uid=1001,gid=1001 myapp-uploads 创建带 UID/GID 的卷（适用于支持 o= 选项的驱动）
• 或在容器启动时用 init 容器先 chown 目录（适合复杂权限场景）
• Dockerfile 中用 USER 1001，且确保该 UID 在宿主机上存在或兼容

配套健康检查与日志轮转，防止卷撑爆磁盘

卷本身不自动清理，日志、临时文件、上传残留都可能填满磁盘。不能只靠“挂上了”就完事。

• 对日志类挂载点（如 /var/log/app），在容器内启用 logrotate 或用 docker run 的 --log-driver=local --log-opt max-size=10m --log-opt max-file=3
• 数据库卷建议定期备份到外部存储，用 docker run --rm -v pg-data:/data -v $(pwd):/backup alpine tar cf /backup/pg-backup-$(date +%s).tar -C /data .
• 监控 /var/lib/docker/volumes/ 所在分区使用率，设置告警阈值（如 >85%）