本地Node Express连接Docker容器中PostgreSQL数据库的方法

问题描述 #

我有一个基于Express的Node项目，已通过docker-compose.yml配置了PostgreSQL数据库容器。不想将Node Express服务放入Docker容器，但希望它能连接容器内的PostgreSQL。在Mac上本地启动服务时，使用Sequelize连接数据库失败，求无需容器化服务也无需硬编码本地IP的解决办法。

现有配置文件 #

docker-compose.yml #

version: '3.8'

services:
  db:
    container_name: db
    image: 'postgres:12'
    ports:
      - 5432:5432
    environment:
      - POSTGRES_USER=test
      - POSTGRES_PASSWORD=12345
      - POSTGRES_DB=testdb
    volumes:
      - pgdata1:/var/lib/postgresql/data
volumes:
  pgdata1: {}

server.js #

import * as express from "express";
import { sequelize } from "./util/database";

const PORT = process.env.STAGE === "local" ? 8080 : 80;
const HOST = "0.0.0.0";

const app = express();

app.get("/", (req: any, res: any) => {
  res.status(200).send("hello world!");
});

app.get("/ping", (req: any, res: any) => {
  res.status(200).send("pong");
});

app.get("/healthy", (req: any, res: any) => {
  res.status(200).send("healthy");
});

const start = async () => {
  try {
    await sequelize.sync({ force: true });

    app.listen(PORT, HOST);

    console.log(`Running on http://${HOST}:${PORT}`);
  } catch (error) {
    console.log(error);
  }
};

start();

utils/database.ts #

import { Sequelize } from "sequelize-typescript";

export const sequelize = new Sequelize({
  database: process.env.PGDATABASE,
  username: process.env.PGUSER,
  password: process.env.PGPASSWORD,
  host: process.env.PGHOST,
  dialect: "postgres",
  models: [],
});

解决办法 #

1. 利用Mac Docker专属DNS地址 #

在Mac的Docker Desktop环境中，宿主机可以通过host.docker.internal这个特殊DNS名称直接访问容器内的服务，无需硬编码本地IP。这个地址是Docker官方提供的跨平台解决方案，Mac上默认生效。

2. 配置本地环境变量 #

• 首先安装dotenv用于加载本地环境变量：

  yarn add dotenv --dev
  

• 在项目根目录创建.env.local文件，填入以下内容：

  STAGE=local
  PGHOST=host.docker.internal
  PGUSER=test
  PGPASSWORD=12345
  PGDATABASE=testdb
  

• 修改server.js，在最顶部添加环境变量加载代码：

  import dotenv from 'dotenv';
  dotenv.config({ path: '.env.local' });
  

3. 验证端口映射 #

检查docker-compose.yml中的ports: - 5432:5432配置，确保宿主机的5432端口未被其他PostgreSQL实例占用。如果端口冲突，可修改宿主机侧端口（比如改为5433:5432），同时在.env.local中添加PGPORT=5433，并在utils/database.ts的Sequelize配置中加入端口配置：

export const sequelize = new Sequelize({
  database: process.env.PGDATABASE,
  username: process.env.PGUSER,
  password: process.env.PGPASSWORD,
  host: process.env.PGHOST,
  port: process.env.PGPORT ? parseInt(process.env.PGPORT) : 5432,
  dialect: "postgres",
  models: [],
});

调整后的操作步骤 #

1. 启动PostgreSQL容器：

   docker compose up -d db
   

2. 安装依赖并启动服务：

   yarn install
   yarn start
   

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