eccube/postgres

PostgreSQL (ja_JP.UTF-8 locale) Docker镜像

镜像概述

本镜像为PostgreSQL数据库的扩展版本，在官方PostgreSQL镜像基础上预配置了ja_JP.UTF-8语言环境，旨在为需要处理日语数据的应用提供开箱即用的数据库支持。镜像完全兼容官方PostgreSQL镜像的所有功能和配置方式。

核心功能与特性

• 预配置ja_JP.UTF-8语言环境：无需手动配置即可支持日语字符集
• 官方兼容性：基于https://github.com/docker-library/postgres%E6%9E%84%E5%BB%BA%EF%BC%8C%E4%BF%9D%E7%95%99%E6%89%80%E6%9C%89%E6%A0%87%E5%87%86%E5%8A%9F%E8%83%BD
• 日语数据支持：正确处理日语字符存储、检索及排序规则
• 即开即用：简化日语环境下PostgreSQL的部署流程

使用场景

• 日本地区应用开发与测试环境
• 需要存储和处理日语文本数据的生产系统
• 要求正确排序日语字符串（如假名、汉字混合排序）的业务场景
• 多语言环境中需要单独隔离日语数据库实例的架构

使用方法

基本部署 (docker run)

bash
docker run -d \
  --name postgres-ja \
  -e POSTGRES_PASSWORD=your_password \
  -e POSTGRES_USER=your_user \
  -e POSTGRES_DB=your_db \
  -p 5432:5432 \
  -v postgres-ja-data:/var/lib/postgresql/data \
  [镜像名称]

Docker Compose配置

yaml
version: '3.8'
services:
  postgres-ja:
    image: [镜像名称]
    container_name: postgres-ja
    environment:
      POSTGRES_PASSWORD: your_password
      POSTGRES_USER: your_user
      POSTGRES_DB: your_db
    ports:
      - "5432:5432"
    volumes:
      - postgres-ja-data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres-ja-data:

环境变量

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

• POSTGRES_PASSWORD：数据库超级用户密码（必填）
• POSTGRES_USER：数据库超级用户名（默认：postgres）
• POSTGRES_DB：初始化数据库名称（默认与POSTGRES_USER相同）
• PGDATA：数据库数据存储路径（默认：/var/lib/postgresql/data）

验证语言环境

1. 进入容器：

bash
docker exec -it postgres-ja bash

2. 检查系统语言环境：

bash
locale

应输出包含ja_JP.UTF-8的语言环境信息

3. 通过psql验证数据库编码：

bash
psql -U your_user -d your_db -c "SHOW server_encoding;"

应返回UTF8

注意事项

• 镜像继承官方PostgreSQL镜像的所有行为和限制
• 数据卷挂载建议使用命名卷以确保数据持久化
• 生产环境中应配置适当的资源限制和备份策略
• 如需其他语言环境，可基于此镜像进一步扩展配置