jlsalvador/postgres

PostgreSQL 定制镜像（禁用 huge_pages）

镜像概述

本镜像基于官方 postgres:alpine 镜像构建，主要对 PostgreSQL 配置进行定制，将默认的 huge_pages = try 修改为 huge_pages = off，同时添加了 locales 支持。适用于需要禁用 huge_pages 功能的 PostgreSQL 部署场景。

核心功能与特性

• 继承官方镜像特性：完全继承 postgres:alpine 镜像的所有功能，包括轻量级 Alpine 基础、PostgreSQL 数据库服务及官方默认配置。
• 禁用 huge_pages：通过修改 PostgreSQL 配置文件 postgresql.conf.sample，将 huge_pages 参数从默认的 try 显式设置为 off，禁用内存大页功能。
• 添加 locales 支持：额外安装 musl-locales 和 musl-locales-lang 包，提供多语言环境支持。

使用场景

• 需要禁用 PostgreSQL huge_pages 功能的部署环境（如某些对内存大页支持有限或存在兼容性问题的系统）。
• 基于 Alpine Linux 且需轻量级 PostgreSQL 服务的场景。
• 需要多语言支持的 PostgreSQL 应用。

使用方法

基本使用

与官方 postgres 镜像使用方式一致，可直接通过 docker run 启动：

bash
docker run -d --name my-postgres -e POSTGRES_PASSWORD=mysecretpassword your-image-name:tag

常用启动参数示例

• 指定数据库用户和密码：

  bash
  docker run -d \
    --name my-postgres \
    -e POSTGRES_USER=myuser \
    -e POSTGRES_PASSWORD=mypassword \
    -e POSTGRES_DB=mydb \
    your-image-name:tag
  

• 挂载数据卷（持久化数据）：

  bash
  docker run -d \
    --name my-postgres \
    -e POSTGRES_PASSWORD=mysecretpassword \
    -v /host/path/to/data:/var/lib/postgresql/data \
    your-image-name:tag
  

• 暴露端口：

  bash
  docker run -d \
    --name my-postgres \
    -e POSTGRES_PASSWORD=mysecretpassword \
    -p 5432:5432 \
    your-image-name:tag
  

配置说明

默认配置修改

本镜像主要修改了 PostgreSQL 默认配置文件 postgresql.conf.sample 中的以下参数：

• huge_pages = off（原默认值为 try），禁用内存大页功能。

自定义配置

如需进一步调整配置，可通过以下方式：

1. 使用自定义配置文件：通过 -v 挂载本地配置文件到容器内的 /var/lib/postgresql/data/postgresql.conf（容器运行时会加载该路径的配置文件）。
2. 环境变量覆盖：部分配置可通过环境变量调整，具体参考 https://hub.docker.com/_/postgres 中的环境变量说明。

注意事项

• 本镜像基于 postgres:alpine，Alpine 系统使用 musl libc，与 glibc 系统存在部分差异，使用前请确认应用兼容性。
• locales 支持通过 musl-locales 提供，如需设置特定语言环境，可通过环境变量 LANG、LC_ALL 等指定（例如 -e LANG=en_US.UTF-8）。