使用 Docker 部署 Node.js 应用的实践记录

2026-06-05 · DevOps · 学习笔记

将 Node 应用容器化后，本地与服务器环境一致，部署流程可重复。 以下记录个人项目在腾讯云上使用 Docker Compose 部署的过程与经验。

多阶段构建

Dockerfile 分为 deps、build、runner 阶段，最终镜像只包含生产依赖与编译产物， 体积更小、更安全。包管理器选用 pnpm，配合 BuildKit 缓存加速构建。

Compose 编排

• API 服务与 MongoDB、Redis 同网络通信
• 环境变量通过 .env 注入，敏感信息不写入镜像
• healthcheck 确保依赖就绪后再启动应用

踩坑记录

compose 文件在子目录时，需注意 project-directory 与 env_file 路径； 修改 .env 后须 --force-recreate 容器而非简单 restart。 静态站点可用 nginx 容器挂载 html 目录，适合个人博客部署。