neatous/postgres Docker 镜像 - 轩辕镜像

PostgreSQL with CZ locale 镜像文档

镜像概述

本镜像基于官方PostgreSQL镜像构建，预配置并启用了捷克语(CZ)区域设置，解决了默认PostgreSQL镜像中缺少CZ locale导致的捷克语数据存储、排序及比较异常问题。镜像保持与官方PostgreSQL版本的兼容性，可直接替代官方镜像用于需要处理捷克语数据的应用。

核心功能与特性

• 预配置CZ Locale：已安装并启用cs_CZ.UTF-8、cs_CZ.ISO-8859-2等捷克语区域设置
• 支持捷克语排序规则：包含cs_CZ.utf8等捷克语排序规则，支持捷克语特有字符的正确排序（如č、ř、ž等）
• 版本一致性：与官方PostgreSQL镜像版本同步（如16、15等），继承官方镜像全部功能
• 开箱即用：无需手动编译或配置locale，启动后即可直接使用捷克语区域设置

使用场景与适用范围

• 需要存储和处理捷克语文本数据的应用系统
• 要求数据库支持捷克语特定排序规则（如字母"ch"视为单个字母排序）的业务场景
• 面向捷克用户或在捷克共和国部署的本地化应用
• 需符合捷克语数据处理合规性要求的系统

使用方法与配置说明

基本使用

通过docker run命令直接启动容器：

bash
docker run -d \
  --name postgres-cz \
  -p 5432:5432 \
  -v postgres-data:/var/lib/postgresql/data \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -e POSTGRES_DB=myczdb \
  -e POSTGRES_USER=czuser \
  your-image-name:tag

参数说明：

• -v postgres-data:/var/lib/postgresql/data：挂载数据卷以持久化数据库数据
• -e POSTGRES_PASSWORD：设置数据库超级用户密码（必填）
• -e POSTGRES_DB：指定初始数据库名称（可选，默认与POSTGRES_USER同名）
• -e POSTGRES_USER：指定数据库超级用户名（可选，默认postgres）

Docker Compose配置

创建docker-compose.yml文件：

yaml
version: '3.8'
services:
  postgres-cz:
    image: your-image-name:tag
    container_name: postgres-cz
    ports:
      - "5432:5432"
    volumes:
      - postgres-data:/var/lib/postgresql/data
    environment:
      POSTGRES_PASSWORD: mysecretpassword
      POSTGRES_USER: czuser
      POSTGRES_DB: myczdb
    restart: unless-stopped

volumes:
  postgres-data:

启动服务：

bash
docker-compose up -d

验证Locale配置

1. 进入运行中的容器：

bash
docker exec -it postgres-cz bash

2. 检查系统locale：

bash
locale -a | grep cs_CZ

预期输出包含：cs_CZ.utf8、cs_CZ.ISO-8859-2等

3. 通过psql验证数据库排序规则：

bash
psql -U czuser -d myczdb

在psql终端执行：

sql
SELECT name FROM pg_collation WHERE name LIKE 'cs\_CZ%';

预期输出包含cs_CZ.utf8等捷克语排序规则

配置自定义CZ Locale参数（可选）

如需调整捷克语排序规则细节（如是否区分大小写），可通过PostgreSQL配置文件自定义，例如修改postgresql.conf：

ini
# 在自定义配置文件中添加
collation_server = 'cs_CZ.utf8'
lc_messages = 'cs_CZ.utf8'
lc_monetary = 'cs_CZ.utf8'
lc_numeric = 'cs_CZ.utf8'
lc_time = 'cs_CZ.utf8'

通过挂载配置文件应用自定义设置：

bash
docker run -d \
  --name postgres-cz \
  -v /path/to/custom/postgresql.conf:/var/lib/postgresql/data/postgresql.conf \
  # 其他参数...
  your-image-name:tag

环境变量与配置继承

本镜像完全继承官方PostgreSQL镜像的所有环境变量和配置选项，常用参数包括：

• POSTGRES_INITDB_ARGS：传递给initdb的额外参数（如--lc-collate=cs_CZ.utf8，但本镜像已预配置，通常无需设置）
• POSTGRES_HOST_AUTH_METHOD：设置主机认证方式（默认md5）
• PGDATA：指定数据库数据存储路径（默认/var/lib/postgresql/data）

更多配置可参考官方PostgreSQL镜像文档。