部署
Docker
利用自管 Node.js 容器将 MuseMVP 部署至自建或 Kubernetes 服务器。
本指南指导您如何将 MuseMVP 打包为 Docker 容器并部署至任意支持容器的服务器环境。
配置流程
镜像构建
本地构建
docker build -f Dockerfile -t musemvp:dockerfile-check .因时效性，请参考 MVP手册最新代码 Docker全自动化脚本。
环境变量说明
除了 DATABASE_CONNECTION_STRATEGY 之外，其他环境变量在本地 .env 文件中都有说明，参见 快速构建 / 环境变量。
DATABASE_CONNECTION_STRATEGY="database_url_first"关于数据库连接策略
设置 DATABASE_CONNECTION_STRATEGY=database_url_first 是固定的，程序会在初始连接阶段使用标准方式直连数据库。
运行容器
本地启动验证：
docker run --env-file .env -p 3000:3000 musemvp:dockerfile-check验证通过后，即可将镜像推送至任意容器注册中心（如 Docker Hub、GHCR、阿里云 ACR）并在目标服务器上拉取运行。
问题排查
绝大多数部署异常来自环境变量缺失或数据库连接配置错误，排查时优先检查此项。
容器内无法连接数据库
如果 PostgreSQL 与应用同处于 docker-compose 网络中，DATABASE_URL 中的 localhost 需替换为对应的服务名称（如 db）。