dockette/postgres 镜像文档

镜像概述和主要用途

dockette/postgres 是一个经过优化的 PostgreSQL Docker 镜像，支持 10/11/12/13 版本。该镜像预安装了 unaccent 和 intarray 扩展，并配置了捷克语（Czech）全文搜索支持，适用于需要处理捷克语文本数据、文本去重音或依赖数组操作的应用场景，提供开箱即用的优化 PostgreSQL 环境。

核心功能和特性

• 多版本支持：基于 PostgreSQL 10、11、12、13 稳定版本构建。
• 预安装扩展：包含 unaccent（文本去重音）和 intarray（整数数组操作）扩展，无需手动安装。
• 捷克语配置：内置捷克语全文搜索配置（czech regconfig），支持捷克语文本的全文检索。
• 性能优化：基于*** PostgreSQL 镜像进行参数调优，提升运行效率。

使用场景和适用范围

• 捷克语应用：需支持捷克语全文搜索的本地化系统（如内容管理、文档检索）。
• 文本处理：需对含重音字符的文本进行标准化（如 Žluťoučký kůň → Zlutoucky kun）的场景。
• 数组操作：依赖 intarray 扩展进行高效整数数组运算的业务（如标签管理、权限控制）。

使用方法和配置说明

基础部署

通过 docker run 命令启动不同版本的镜像，默认暴露 5432 端口：

bash
# 启动 PostgreSQL 13
docker run --rm -it -p 5432:5432 dockette/postgres:13

# 启动 PostgreSQL 12
docker run --rm -it -p 5432:5432 dockette/postgres:12

# 启动 PostgreSQL 11
docker run --rm -it -p 5432:5432 dockette/postgres:11

# 启动 PostgreSQL 10
docker run --rm -it -p 5432:5432 dockette/postgres:10

数据持久化

为避免容器重启后数据丢失，建议通过 -v 挂载数据卷持久化数据：

bash
docker run -d \
  -p 5432:5432 \
  -v /本地路径/postgres-data:/var/lib/postgresql/data \
  --name postgres-czech \
  dockette/postgres:13

环境变量配置

支持 PostgreSQL ***镜像标准环境变量，用于自定义数据库初始化参数：

功能验证

启动容器后，可通过以下 SQL 验证扩展和捷克语配置是否生效：

sql
-- 验证捷克语全文搜索配置
SELECT to_tsvector('czech'::regconfig, 'test'); 

-- 验证 unaccent 扩展（文本去重音）
SELECT unaccent('Hôtel');  -- 结果：Hotel
SELECT unaccent('Žluťoučký kůň');  -- 结果：Zlutoucky kun 

-- 验证 intarray 扩展（需结合具体业务场景，例如数组交集）
-- SELECT '{1,2,3} & {2,3,4}'::int4[];  -- 结果：{2,3}

资源参考

• 灵感来源：
  • char0n/postgresql-czech-fulltext
  • tjelen/postgres-tsearch-czech
  • freaz/docker-postgres-czech-unaccent
• 扩展文档：
  • PostgreSQL.cz 全文搜索安装指南