area51/postgresql

PostgreSQL 9.5 (增强IPv6支持) 镜像文档

镜像概述

本镜像基于官方PostgreSQL 9.5基础镜像构建，额外集成了专用启动脚本，旨在简化IPv6网络环境下的配置流程，使PostgreSQL数据库能够更便捷地支持IPv6连接。

核心功能与特性

• 基于官方镜像：保留PostgreSQL 9.5官方镜像的全部功能，包括完整的数据库服务、数据持久化、用户管理等核心能力。
• 增强IPv6支持：通过新增启动脚本，自动处理IPv6相关配置，降低手动修改配置文件的复杂度。
• 兼容标准用法：保持与官方PostgreSQL镜像一致的使用方式，支持标准环境变量、数据卷挂载等配置。

使用场景

• 部署在纯IPv6网络环境中的PostgreSQL数据库服务。
• 需要同时支持IPv4和IPv6双栈访问的数据库场景。
• 对IPv6配置自动化有需求的容器化部署环境。

使用方法与配置说明

基本运行命令

bash
docker run -d \
  --name postgres-ipv6 \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -p 5432:5432 \
  --sysctl net.ipv6.conf.all.disable_ipv6=0 \
  [镜像名称]

关键配置说明

1. IPv6网络启用：
   容器需运行在支持IPv6的Docker环境中，启动时需添加--sysctl net.ipv6.conf.all.disable_ipv6=0参数以启用容器内IPv6。

2. 自动IPv6配置：
   镜像内置启动脚本会自动检测IPv6环境，并调整postgresql.conf中的listen_addresses参数，默认监听0.0.0.0（IPv4）和::（IPv6）。

3. 持久化数据：
   通过挂载数据卷保存数据库数据，避免容器重启后数据丢失：

   bash
   docker run -d \
     --name postgres-ipv6 \
     -e POSTGRES_PASSWORD=mysecretpassword \
     -v /host/path/to/data:/var/lib/postgresql/data \
     -p 5432:5432 \
     --sysctl net.ipv6.conf.all.disable_ipv6=0 \
     [镜像名称]
   

环境变量支持

支持官方PostgreSQL镜像的所有标准环境变量，主要包括：

• POSTGRES_PASSWORD：数据库超级用户密码（必填）。
• POSTGRES_USER：自定义超级用户名（默认postgres）。
• POSTGRES_DB：初始化数据库名称（默认与POSTGRES_USER同名）。

验证IPv6连接

容器启动后，可通过IPv6地址连接数据库验证配置：

bash
psql -h [容器IPv6地址] -p 5432 -U postgres