如何在Docker Compose中为PostgreSQL 14.7安装第三方扩展（含wal2json）

1. Docker Compose环境中安装第三方PostgreSQL扩展的通用方案 #

第三方PostgreSQL扩展大多需要编译后才能使用，官方镜像默认仅包含少量内置扩展，核心思路是自定义镜像预装扩展，步骤如下：

• 编写Dockerfile，基于官方postgres:14.7镜像，安装编译依赖、获取扩展源码、编译并安装
• 在docker-compose.yml中引用自定义镜像，同时配置PostgreSQL必要参数（如扩展加载、WAL设置等）
• 部分扩展可通过系统包管理器安装（如Debian/Ubuntu的预编译包），可跳过编译步骤直接安装

基础Dockerfile示例：

FROM postgres:14.7

# 安装编译依赖（Debian/Ubuntu环境）
RUN apt-get update && apt-get install -y --no-install-recommends \
    build-essential \
    git \
    postgresql-server-dev-14 \
    && rm -rf /var/lib/apt/lists/*

# 在此添加具体扩展的编译/安装步骤

2. PostgreSQL 14.7能否安装Supabase PG15列表中的扩展 #

能否安装取决于单个扩展的PostgreSQL版本兼容性：

• Supabase列出的多数第三方扩展支持多PG版本（如wal2json、pgcrypto等），但部分扩展可能仅适配PG15及以上
• 验证方式：针对目标扩展，查看其官方文档或仓库说明，确认是否支持PG14.7
• 结论：只要扩展明确支持PG14.x，即可通过自定义Docker镜像的方式在你的PG14.7环境中安装，逻辑与PG15环境一致

3. wal2json扩展安装到PG14.7 Docker环境的具体步骤 #

步骤1：编写自定义Dockerfile #

FROM postgres:14.7

# 安装编译依赖
RUN apt-get update && apt-get install -y --no-install-recommends \
    build-essential \
    git \
    postgresql-server-dev-14 \
    && rm -rf /var/lib/apt/lists/*

# 克隆wal2json仓库并切换到兼容PG14的v2.5版本
RUN git clone --branch v2.5 `https://github.com/eulerto/wal2json.git` /tmp/wal2json \
    && cd /tmp/wal2json \
    && make \
    && make install \
    && rm -rf /tmp/wal2json

步骤2：编写docker-compose.yml #

version: '3.8'
services:
  postgres:
    build: .  # 基于当前目录的Dockerfile构建镜像
    environment:
      POSTGRES_USER: your_user
      POSTGRES_PASSWORD: your_password
      POSTGRES_DB: your_db
    volumes:
      - postgres_data:/var/lib/postgresql/data
      # 可选：挂载自定义配置文件覆盖默认设置
      # - ./postgresql.conf:/var/lib/postgresql/data/postgresql.conf
    ports:
      - "5432:5432"
    # 启动时配置wal2json所需的逻辑复制参数
    command: postgres -c wal_level=logical -c max_replication_slots=10 -c max_wal_senders=10

volumes:
  postgres_data:

步骤3：启用扩展 #

容器启动后，进入PostgreSQL命令行执行：

CREATE EXTENSION wal2json;

验证安装结果：

SELECT * FROM pg_extension WHERE extname = 'wal2json';

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