fengkx/postgres

postgres-docker 镜像文档

镜像概述

自用PostgreSQL Docker镜像，基于官方PostgreSQL镜像构建，集成了实用扩展和配置优化，旨在提供更便捷的中文全文搜索、SQL操作安全防护及查询性能监控能力。

核心功能与特性

扩展组件

1. postgresql-contrib
   包含pg_stat_statements扩展，启用后可监控SQL查询性能，帮助分析和优化数据库操作。

2. zhparser
   中文全文搜索扩展（https://github.com/amutu/zhparser/%EF%BC%89%EF%BC%8C%E6%94%AF%E6%8C%81%E4%B8%AD%E6%96%87%E6%96%87%E6%9C%AC%E7%9A%84%E5%88%86%E8%AF%8D%E4%B8%8E%E5%85%A8%E6%96%87%E6%A3%80%E7%B4%A2%E5%8A%9F%E8%83%BD%E3%80%82

3. pg-safeupdate
   SQL安全防护扩展（https://github.com/eradman/pg-safeupdate%EF%BC%89%EF%BC%8C%E5%BC%BA%E5%88%B6%E8%A6%81%E6%B1%82UPDATE/DELETE%E6%93%8D%E4%BD%9C%E5%BF%85%E9%A1%BB%E5%8C%85%E5%90%ABWHERE%E5%AD%90%E5%8F%A5%EF%BC%8C%E9%98%B2%E6%AD%A2%E8%AF%AF%E6%93%8D%E4%BD%9C%E5%AF%BC%E8%87%B4%E7%9A%84%E6%95%B0%E6%8D%AE%E6%89%B9%E9%87%8F%E4%BF%AE%E6%94%B9%E6%88%96%E5%88%A0%E9%99%A4%E3%80%82

配置优化

1. 默认文本搜索配置（default_text_search_config）设为'chinese'，无需额外配置即可直接使用zhparser进行中文全文搜索。

2. 自动加载扩展：pg_stat_statements和safeupdate扩展默认启用，无需手动配置。

3. 复制槽支持：当设置环境变量USE_REPLICATION时，自动配置max_replication_slots参数，支持数据库复制场景。

更多配置细节见https://github.com/fengkx/postgres-docker/blob/master/init_extension.sh%E3%80%82

使用场景

• 需要中文全文搜索功能的应用系统（如内容管理系统、文档检索平台）。
• 对SQL操作安全性有要求的开发或生产环境，需防止误操作的数据修改。
• 需要监控和分析SQL查询性能的数据库环境。

使用方法

基本启动命令

使用docker run启动容器：

bash
docker run -d \
  --name postgres-instance \
  -e POSTGRES_PASSWORD=your_secure_password \
  -p 5432:5432 \
  fengkx/postgres-docker:latest

启用复制配置

若需启用数据库复制功能，添加USE_REPLICATION环境变量：

bash
docker run -d \
  --name postgres-replication \
  -e POSTGRES_PASSWORD=your_secure_password \
  -e USE_REPLICATION=1 \
  -p 5432:5432 \
  fengkx/postgres-docker:latest

验证扩展加载

容器启动后，通过psql连接数据库验证扩展是否正常加载：

bash
psql -h localhost -U postgres -d postgres

在psql终端执行以下SQL检查扩展状态：

sql
-- 检查pg_stat_statements
SELECT extname FROM pg_extension WHERE extname = 'pg_stat_statements';

-- 检查zhparser
SELECT extname FROM pg_extension WHERE extname = 'zhparser';

-- 检查pg-safeupdate
SELECT extname FROM pg_extension WHERE extname = 'safeupdate';

中文全文搜索示例

使用zhparser进行中文全文搜索：

sql
-- 创建中文文本搜索配置（已默认配置，可直接使用）
-- CREATE TEXT SEARCH CONFIGURATION chinese (PARSER = zhparser);

-- 示例：搜索包含"数据库"的文本
SELECT to_tsvector('chinese', '这是一个PostgreSQL数据库镜像') @@ to_tsquery('chinese', '数据库');
-- 结果为t（true）表示匹配成功