如何构建整合PostgreSQL与Node.js的Docker镜像？

我想构建一个包含PostgreSQL数据库和NodeJS前端的Docker镜像，外部只能通过JavaScript/NodeJS调用数据库功能，PostgreSQL的端口完全对外隐藏。

我搜索后发现多数方案用docker-compose，比如一个常见的模板，但我不需要docker-compose——因为可能要在k8s等环境使用，而且不需要PostgreSQL原生接口，只想把NodeJS+PostgreSQL作为单一单元/服务提供。目前找到最接近的是一个7年前的node-postgres镜像，但它没有公开Dockerfile。

我尝试自己写Dockerfile，但有个疑问：应该选择官方postgres镜像还是官方node镜像作为基础？

我熟悉Ubuntu，知道可以用apt install安装postgresql，但官方postgres镜像的入口点和Ubuntu虚拟机里运行后台服务的方式不一样，官方node镜像也有类似的入口点问题。

所以我的问题是：应该基于postgres镜像来添加NodeJS的部署步骤，还是基于node镜像来添加PostgreSQL的部署步骤？希望有经验的人能解释主要步骤或分享见解。

-- 补充说明 --
我知道通常不建议在一个容器里运行多个进程，也理解背后的扩展性原因。但我的场景里，NodeJS/node-postgres进程完全覆盖postgres进程，而且这类进程没法水平扩展（受限于PostgreSQL这类关系型数据库的特性），二者是1:1的对应关系，一般只需要一个数据库实例。所以我想避开docker-compose或k8s的额外复杂度，提供一个能直接运行数据库、用NodeJS交互的镜像，比让别人用docker-compose设置容器网络更简单。

基础镜像选择建议 #

优先选择官方postgres镜像作为基础，原因如下：

• 官方postgres镜像已经封装了PostgreSQL的正确初始化流程、用户权限配置、数据持久化逻辑，避免自己用apt install后还要手动处理大量初始化细节（比如postgres用户创建、默认数据库配置、日志处理等）。
• 基于postgres镜像添加NodeJS，只需要安装Node环境，相比基于node镜像去折腾PostgreSQL的初始化，步骤更简洁，踩坑更少。

核心步骤说明 #

1. 选择基础镜像
   选一个稳定版本的官方postgres镜像，比如postgres:16-alpine（alpine版本体积更小）。

2. 安装NodeJS环境
   在Dockerfile中添加NodeJS的安装步骤，以alpine为例：

   RUN apk add --no-cache nodejs npm
   

   如果是debian-based的postgres镜像，用apt-get安装：

   RUN apt-get update && apt-get install -y nodejs npm && rm -rf /var/lib/apt/lists/*
   

3. 复制NodeJS应用代码
   创建工作目录，复制你的NodeJS项目文件（package.json、源代码等），安装依赖：

   WORKDIR /app
   COPY package*.json ./
   RUN npm ci --only=production
   COPY . .
   

4. 配置PostgreSQL初始化脚本
   利用官方postgres镜像的/docker-entrypoint-initdb.d/目录，把数据库初始化的SQL脚本或NodeJS脚本放在这里，容器启动时会自动执行，完成数据库创建、表结构初始化等操作。

5. 设置容器启动命令
   因为需要同时启动PostgreSQL和NodeJS应用，你需要一个进程管理工具（比如supervisord）来管理两个进程：

   • 先安装supervisord：

     # alpine环境
     RUN apk add --no-cache supervisor
     # debian环境
     RUN apt-get update && apt-get install -y supervisor && rm -rf /var/lib/apt/lists/*
     

   • 创建supervisord配置文件supervisord.conf：

     [supervisord]
     nodaemon=true
     
     [program:postgres]
     command=/usr/local/bin/docker-entrypoint.sh postgres
     user=postgres
     stdout_logfile=/dev/stdout
     stdout_logfile_maxbytes=0
     stderr_logfile=/dev/stderr
     stderr_logfile_maxbytes=0
     
     [program:node-app]
     command=npm start
     user=root
     working_dir=/app
     stdout_logfile=/dev/stdout
     stdout_logfile_maxbytes=0
     stderr_logfile=/dev/stderr
     stderr_logfile_maxbytes=0
     

   • 在Dockerfile中复制配置文件，并设置启动命令为supervisord：

     COPY supervisord.conf /etc/supervisord.conf
     CMD ["supervisord", "-c", "/etc/supervisord.conf"]
     

6. 隐藏PostgreSQL端口
   不要在Dockerfile中暴露PostgreSQL默认的5432端口（不要加EXPOSE 5432），只暴露NodeJS应用的端口（比如EXPOSE 3000），确保外部只能访问NodeJS接口。

关键注意事项 #

• 数据持久化：如果需要保留数据库数据，还是要挂载卷到PostgreSQL的数据目录/var/lib/postgresql/data，即使是单容器部署，也避免容器销毁后数据丢失。
• 环境变量：用环境变量配置PostgreSQL的用户名、密码、数据库名（比如POSTGRES_USER、POSTGRES_PASSWORD、POSTGRES_DB），NodeJS应用通过这些环境变量连接数据库，不要硬编码。
• 镜像体积优化：用alpine版本的基础镜像，安装依赖后清理缓存（比如rm -rf /var/lib/apt/lists/*或apk cache clean），减少镜像体积。

内容的提问来源于stack exchange，提问作者thor