feat: init v16.

Author: Ricco Xie

.github/workflows/docker-build.yml

@@ -0,0 +1,44 @@
+name: Build and Push PostgreSQL 16 Image
+
+on:
+  push:
+    branches: [ v16 ]
+  pull_request:
+    branches: [ v16 ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Login to Docker Hub
+        if: github.event_name != 'pull_request'
+        uses: docker/login-action@v3
+        with:
+          username: ${{ secrets.DOCKER_HUB_USERNAME }}
+          password: ${{ secrets.DOCKER_HUB_ACCESS_TOKEN }}
+
+      - name: Extract metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: riccoxie/postgres-zh
+          tags: |
+            type=ref,event=branch
+            type=ref,event=tag
+            type=sha,format=short
+
+      - name: Build and push
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          push: ${{ github.event_name != 'pull_request' }}
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

Dockerfile

@@ -0,0 +1,48 @@
+# 基于官方PostgreSQL 16镜像
+FROM postgres:16
+
+# 切换为root用户执行安装操作
+USER root
+
+# 安装依赖包
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+    git \
+    libpq-dev \
+    postgresql-server-dev-16 \
+    wget \
+    unzip \
+    cmake \
+    && rm -rf /var/lib/apt/lists/*
+
+# 安装zhparser扩展（基于SCWS的中文分词器）
+RUN git clone https://github.com/amutu/zhparser.git /tmp/zhparser && \
+    cd /tmp/zhparser && \
+    make && make install && \
+    rm -rf /tmp/zhparser
+
+# 安装pg_jieba扩展（结巴分词的PostgreSQL版本）
+RUN git clone https://github.com/jaiminpan/pg_jieba.git /tmp/pg_jieba && \
+    cd /tmp/pg_jieba && \
+    mkdir build && cd build && \
+    cmake .. && make && make install && \
+    rm -rf /tmp/pg_jieba
+
+# 安装其他常用扩展包
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    postgresql-16-contrib \
+    postgresql-16-pg-trgm \
+    postgresql-16-hstore \
+    postgresql-16-btree-gist \
+    postgresql-16-pg-bigm \
+    && rm -rf /var/lib/apt/lists/*
+
+# 复制初始化脚本到容器中
+COPY init-scripts/ /docker-entrypoint-initdb.d/
+
+# 确保初始化脚本权限正确
+RUN chmod -R 755 /docker-entrypoint-initdb.d/ && \
+    chown -R postgres:postgres /docker-entrypoint-initdb.d/
+
+# 切换回postgres用户
+USER postgres

README.md

@@ -1,2 +1,228 @@
-# docker-postgres-zh
-支持常用中文功能的PGSQL镜像
+# Docker PostgreSQL 中文全文搜索镜像
+
+这是一个基于 PostgreSQL 16 的 Docker 镜像，预装了中文全文搜索功能和相关扩展，特别适用于中文应用开发。
+
+## 功能特性
+
+### 🚀 核心功能
+
+- **PostgreSQL 16**: 基于官方 PostgreSQL 16 镜像
+- **中文分词支持**: 集成 zhparser 和 pg_jieba 中文分词器
+- **全文搜索**: 支持中文全文搜索和模糊匹配
+- **扩展丰富**: 预装常用 PostgreSQL 扩展
+
+### 📦 预装扩展
+
+#### 中文分词扩展
+
+- **zhparser**: 基于 SCWS 的中文分词器
+- **pg_jieba**: 结巴分词的 PostgreSQL 版本
+
+#### 全文搜索扩展
+
+- **pg_trgm**: 三元组匹配，支持模糊搜索
+- **pg_bigm**: 双字组匹配，提升中文搜索性能
+- **unaccent**: 去除重音符号
+
+#### 其他实用扩展
+
+- **hstore**: 键值对存储
+- **btree_gist**: B-tree 索引支持
+- **pg_stat_statements**: 查询性能统计
+
+## 快速开始
+
+### 使用 Docker 运行
+
+```bash
+# 拉取镜像
+docker pull riccoxie/postgres-zh:v16
+
+# 运行容器
+docker run -d \
+  --name postgres-zh \
+  -e POSTGRES_DB=zh-test \
+  -e POSTGRES_USER=postgres \
+  -e POSTGRES_PASSWORD=your_password \
+  -p 5432:5432 \
+  riccoxie/postgres-zh:v16
+```
+
+### 使用 Docker Compose
+
+```yaml
+version: '3.8'
+services:
+  postgres:
+    image: riccoxie/postgres-zh:v16
+    container_name: postgres-zh
+    environment:
+      POSTGRES_DB: zh-test
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: your_password
+    ports:
+      - "5432:5432"
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    restart: unless-stopped
+
+volumes:
+  postgres_data:
+```
+
+## 中文全文搜索使用示例
+
+### 1. 连接数据库并创建测试表
+
+```sql
+-- 连接到数据库
+\c zh-test
+
+-- 创建文章表
+CREATE TABLE articles (
+    id SERIAL PRIMARY KEY,
+    title TEXT NOT NULL,
+    content TEXT NOT NULL,
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+-- 插入测试数据
+INSERT INTO articles (title, content) VALUES
+('人工智能的发展', '人工智能技术正在快速发展，深度学习、机器学习等技术不断突破'),
+('数据库优化技巧', 'PostgreSQL 数据库性能优化需要从多个方面考虑，包括索引、查询优化等'),
+('中文分词技术', '中文分词是自然语言处理的基础技术，对搜索引擎和文本分析至关重要');
+```
+
+### 2. 创建全文搜索索引
+
+```sql
+-- 使用中文配置创建全文搜索索引
+CREATE INDEX idx_articles_fts ON articles 
+    USING gin(to_tsvector('zhcn', title || ' ' || content));
+```
+
+### 3. 执行中文全文搜索
+
+```sql
+-- 搜索包含"人工智能"的文章
+SELECT title, content, 
+       ts_rank(to_tsvector('zhcn', title || ' ' || content), 
+               to_tsquery('zhcn', '人工智能')) as rank
+FROM articles 
+WHERE to_tsvector('zhcn', title || ' ' || content) @@ to_tsquery('zhcn', '人工智能')
+ORDER BY rank DESC;
+
+-- 使用 pg_trgm 进行模糊搜索
+SELECT title, content, similarity(title, '人工智能') as sim
+FROM articles 
+WHERE title % '人工智能' OR content % '人工智能'
+ORDER BY sim DESC;
+```
+
+### 4. 使用 pg_jieba 分词
+
+```sql
+-- 使用 jieba 分词
+SELECT jieba_cut('这是一个中文分词的测试');
+
+-- 创建基于 jieba 的全文搜索
+CREATE INDEX idx_articles_jieba ON articles 
+    USING gin(jieba_to_tsvector('simple', title || ' ' || content));
+```
+
+## 配置说明
+
+### 环境变量
+
+| 变量名 | 默认值 | 说明 |
+|--------|--------|------|
+| `POSTGRES_DB` | `postgres` | 默认数据库名 |
+| `POSTGRES_USER` | `postgres` | 数据库用户名 |
+| `POSTGRES_PASSWORD` | - | 数据库密码（必需） |
+| `POSTGRES_INITDB_ARGS` | - | 初始化参数 |
+
+## 开发指南
+
+### 构建镜像
+
+```bash
+# 克隆仓库
+git clone https://github.com/riccox/docker-postgres-zh.git
+cd docker-postgres-zh
+
+# 构建镜像
+docker build -t riccoxie/postgres-zh .
+```
+
+### 本地开发
+
+```bash
+# 运行开发环境
+docker run -it --rm \
+  -e POSTGRES_PASSWORD=dev_password \
+  -p 5432:5432 \
+  -v $(pwd)/script:/docker-entrypoint-initdb.d \
+  riccoxie/postgres-zh:v16
+```
+
+## 性能优化建议
+
+### 1. 索引优化
+
+- 为经常搜索的字段创建 GIN 索引
+- 使用 `pg_trgm` 扩展进行模糊搜索
+- 考虑使用 `pg_bigm` 提升中文搜索性能
+
+### 2. 查询优化
+
+- 使用 `ts_rank()` 函数进行相关性排序
+- 合理使用 `LIMIT` 限制结果集大小
+- 避免在 `WHERE` 子句中使用函数
+
+### 3. 配置调优
+
+```sql
+-- 调整全文搜索相关参数
+SET default_text_search_config = 'zhcn';
+SET pg_trgm.similarity_threshold = 0.3;
+```
+
+## 故障排除
+
+### 常见问题
+
+1. **扩展安装失败**
+
+   ```bash
+   # 检查扩展是否正确安装
+   docker exec -it postgres-chinese psql -U postgres -c "\dx"
+   ```
+
+2. **中文分词不工作**
+
+   ```sql
+   -- 检查中文配置
+   \dF+ zhcn
+   
+   -- 测试分词
+   SELECT to_tsvector('zhcn', '这是一个测试');
+   ```
+
+3. **性能问题**
+
+   ```sql
+   -- 检查索引使用情况
+   EXPLAIN ANALYZE SELECT * FROM articles WHERE to_tsvector('zhcn', title) @@ to_tsquery('zhcn', '测试');
+   ```
+
+## 许可证
+
+本项目基于 [MIT 许可证](LICENSE) 开源。
+
+## 贡献
+
+欢迎提交 Issue 和 Pull Request 来改进这个项目！
+
+## 路线图
+
+✅ 支持 PostgreSQL 16 和中文全文搜索

init-scripts/01-extensions.sql

@@ -0,0 +1,27 @@
+-- 启用核心扩展
+CREATE EXTENSION IF NOT EXISTS pg_trgm;
+CREATE EXTENSION IF NOT EXISTS hstore;
+CREATE EXTENSION IF NOT EXISTS btree_gist;
+CREATE EXTENSION IF NOT EXISTS pg_stat_statements;
+CREATE EXTENSION IF NOT EXISTS unaccent;
+CREATE EXTENSION IF NOT EXISTS pg_bigm;
+
+-- 启用中文分词扩展
+CREATE EXTENSION IF NOT EXISTS zhparser;
+CREATE EXTENSION IF NOT EXISTS jieba;
+
+-- 为zhparser创建配置
+CREATE TEXT SEARCH CONFIGURATION zhcn (PARSER = zhparser);
+ALTER TEXT SEARCH CONFIGURATION zhcn ADD MAPPING FOR n,v,a,i,e,l,j WITH simple;
+
+-- 创建测试表和索引示例
+CREATE TABLE IF NOT EXISTS articles (
+    id SERIAL PRIMARY KEY,
+    title TEXT NOT NULL,
+    content TEXT NOT NULL,
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+-- 创建全文搜索索引
+CREATE INDEX IF NOT EXISTS idx_articles_fts ON articles 
+    USING gin(to_tsvector('zhcn', title || ' ' || content));