ronasit/postgres

PostgreSQL多语言本地化镜像

镜像概述

本镜像为PostgreSQL数据库的衍生版本，基于官方PostgreSQL镜像构建，核心特点是预包含多种本地化语言（locales）支持。它保留了官方镜像的全部功能特性，同时扩展了语言环境覆盖范围，可直接满足多语言数据存储、排序、比较等需求，无需额外配置本地化环境。

核心功能与特性

• 丰富的本地化支持：预安装并配置多种常用语言环境，包括但不限于英语、中文、日语、法语、西班牙语等
• 官方兼容性：完全兼容官方PostgreSQL镜像的标签、环境变量、数据持久化方式及使用习惯
• 即开即用：无需手动编译或配置locale，容器启动后可直接使用预配置的语言环境
• 多版本支持：提供与官方PostgreSQL镜像同步的版本标签（如16、15、14等），适配不同应用需求

使用场景

• 国际化应用：需存储和处理多语言数据的应用系统，如跨国企业业务系统、多语言内容管理平台
• 多语言数据处理：需要按不同语言规则进行字符串排序、比较或全文搜索的场景
• 开发测试环境：为开发团队提供统一的多语言数据库环境，避免本地环境差异导致的问题
• 本地化服务部署：需满足特定地区语言编码要求的数据库服务部署

使用方法

快速启动

使用默认配置启动容器（默认使用en_US.UTF-8 locale）：

bash
docker run -d --name postgres-multilang -e POSTGRES_PASSWORD=mysecretpassword -p 5432:5432 postgres-multilang:latest

指定自定义语言环境启动（如中文环境）：

bash
docker run -d --name postgres-zhcn -e POSTGRES_PASSWORD=mysecretpassword -e LANG=zh_CN.UTF-8 -e LC_ALL=zh_CN.UTF-8 -p 5432:5432 postgres-multilang:latest

查看可用本地化语言

进入容器查看已安装的locales：

bash
docker exec -it postgres-multilang locale -a

Docker Compose配置示例

yaml
version: '3'
services:
  db:
    image: postgres-multilang:16
    container_name: postgres-multilang
    environment:
      POSTGRES_PASSWORD: mysecretpassword
      POSTGRES_USER: myuser
      POSTGRES_DB: mydb
      LANG: ja_JP.UTF-8  # 设置为日语环境
      LC_ALL: ja_JP.UTF-8
    ports:
      - "5432:5432"
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres_data:

配置说明

环境变量

数据持久化

推荐使用Docker卷（volumes）持久化数据库数据，避免容器删除导致数据丢失，如上述Docker Compose示例中的postgres_data卷。

自定义本地化配置

如需添加镜像未包含的locale，可通过Dockerfile扩展或启动时挂载自定义locale配置文件：

dockerfile
FROM postgres-multilang:latest
RUN apt-get update && apt-get install -y locales && \
    sed -i 's/^# \(xx_XX.UTF-8\)/\1/' /etc/locale.gen && \
    locale-gen

其中xx_XX.UTF-8替换为所需的语言代码。