PostgreSQL Service Plus

生产就绪的 PostgreSQL 运行时, 包含向量搜索、中文分词、消息队列等扩展, 支持多种安全部署模式。

📋 部署要求

维度	要求 / 规格	说明
网络	公网 IP + 域名 (DNS)	域名需解析至主机 IP (用于 ACME 证书)
端口	开放 80, 443	80 用于证书验证 (HTTP-01)，443 为 Stunnel TLS 入口
最低	1 CPU / 2GB RAM / 20GB SSD	仅支持基础数据库功能
推荐	2 CPU / 4GB RAM / 50GB SSD	支持向量搜索、高并发等全量扩展

提示: 80/TCP 仅用于 ACME 证书验证。本服务默认使用 443/TCP 作为 Stunnel 安全入口。

🚀 快速开始

一键安装 (默认)

# 默认安装最新稳定版 (PG 16)，使用当前主机名作为域名
curl -fsSL https://raw.githubusercontent.com/cloud-neutral-toolkit/postgresql.svc.plus/main/scripts/init_vhost.sh | bash

指定版本与域名 (安装建议)

# bash -s -- <PG版本> <域名>
curl -fsSL https://raw.githubusercontent.com/cloud-neutral-toolkit/postgresql.svc.plus/main/scripts/init_vhost.sh \
  | bash -s -- 17 db.example.com

详细指南: 查看 docs/QUICKSTART.md | 完整指南

📦 核心特性

多模型数据库

一个 PostgreSQL 实例替代多个专用数据库:

传统方案	PostgreSQL 扩展	用途
Pinecone	pgvector	向量嵌入和语义搜索
Elasticsearch	pg_jieba + pg_trgm	中文分词和全文搜索
Kafka	pgmq	轻量级消息队列
MongoDB	JSONB + GIN	文档存储
Redis	hstore + UNLOGGED	高速键值缓存

🏗️ 部署模式

模式	复杂度	TLS隧道	适用场景
Stunnel + ACME	⭐	✅ (自动证书)	个人/生产单机
Kubernetes/Helm	⭐⭐⭐	✅ (Sidecar)	企业级生产

🔄 CI/CD 自动化

GitHub Actions 工作流:

• ✅ 自动构建和推送镜像
• ✅ 一键部署到 VM (Docker Compose)
• ✅ 一键部署到 K8s/K3s (Helm)
• ✅ 多环境支持 (dev/staging/prod)

🛠️ 技术栈

• PostgreSQL: 16/17/18 (PGDG)
• 扩展: pgvector, pg_jieba, pgmq, pg_cron, pg_trgm
• TLS 隧道: stunnel4
• 证书管理: Caddy (ACME) 或自签名
• 容器编排: Docker Compose 或 Kubernetes/Helm

---

📚 说明文档

• 快速入门 - 5分钟完成部署
• 详细指南 - 安全方案与高级配置
• 项目结构 - 了解代码组织
• 代码分析报告 - 技术实现细节

📝 许可证

MIT License - 详见 LICENSE 文件

🤝 贡献

欢迎贡献! 请查看文档并提交 Pull Request。

📞 支持

• 文档中心: docs/
• 示例配置: example/
• 报告问题: GitHub Issues

---

一个 PostgreSQL, 替代多个数据库 🚀