Pigsty 中文文档 v4.4

PostgreSQL In Great STYle”: Postgres, Infras, Graphics, Service, Toolbox, it’s all Yours.

—— 开源免费、开箱即用、本地优先、自主可控的企业级 PostgreSQL 发行版与 RDS 方案

仓库 | 演示 | 博客 | 论坛 | 微信 | EN Docs

简介

从了解项目、理解概念,到单机上手、生产部署,四步掌握 Pigsty:

了解 Pigsty 项目本身的方方面面:功能特性、历史沿革、开源协议、隐私政策与社区动态。

理解 Pigsty 的核心概念、架构设计与设计理念,掌握高可用、备份恢复、安全合规等关键能力。

在你的笔记本或云服务器上拉起 Pigsty 单机版本,访问数据库服务与 Web 管理界面。

在生产环境中进行多节点、高可用的 Pigsty 架构规划、资源准备与正式部署。

安装

快速上手准备 一台全新安装 Linux 操作系统的节点,使用具有免密 sshsudo 权限的用户运行:

curl -fsSL https://repo.pigsty.cc/get | bash -s v4.4.0   # 下载 Pigsty 源码包
cd ~/pigsty      # 进入源码目录
./configure      # 生成配置文件
./install.yml    # 执行安装部署

下载配置部署,Pigsty 会在几分钟内完成安装!您可以稍后 添加更多节点 与数据库集群。

接下来,您可以探索 图形界面,访问 5432 端口上的 PostgreSQL 服务,以及 3000 端口上的 Grafana 监控大盘(用户名 / 密码:admin / pigsty)。

您还可以将多种风味的 PostgreSQL 内核 封装为 RDS 服务:CitusWiltonDBIvorySQLOpenHaloPerconaOrioleDBPolarDB,以及 Supabase

模块

Pigsty 由多个 模块 组成。其中 PGSQL / INFRA / NODE / ETCD(PINE 组合)是自建 PostgreSQL RDS 服务的 必选 模块:

PGSQL核心

自治自愈的高可用 PostgreSQL 集群:HA、PITR、IaC、ACL 与监控齐备,海量扩展开箱即用。

INFRA核心

Nginx、本地软件仓库、DNS、NTP,以及 Prometheus 与 Grafana 可观测性技术栈。

NODE核心

将主机节点纳管调整至期望状态:主机监控、日志收集、VIP 与 HAProxy 负载均衡。

ETCD核心

可靠的分布式共识存储(DCS),为 PostgreSQL 高可用提供集群元数据支撑。

此外还有一些 可选 模块,它们与 PostgreSQL 配合良好,可为你的数据基础设施带来额外价值:

MINIO可选

S3 兼容的对象存储,可用作数据库备份的集中存储仓库。

REDIS可选

高性能内存数据结构服务器,主从、集群、哨兵三种模式。

DOCKER可选

容器运行时,一键拉起容器化的无状态软件与应用模板。

FERRET可选

基于 PostgreSQL 提供 MongoDB 协议兼容能力。

JUICE可选

JuiceFS 分布式文件系统,将 PostgreSQL 挂载为文件系统

VIBE可选

AI 编程沙箱,Claude/Codex 开发环境,Agent 运行时

KAFKA可选

Apache Kafka 4.x dynamic KRaft 消息队列集群,安全与监控齐备。

PILOT试点

试点功能模组:Kubernetes、DuckDB、MySQL、TigerBeetle……供尝鲜探索。

参考信息

详尽的参考资料、扩展目录、开箱即用的模板,以及周边组件的中文文档:

详尽的参考信息列表:操作系统、文件结构、参数、监控指标与同类产品对比。

555 个 PostgreSQL 生态扩展的完整目录:元数据、文档、下载与支持矩阵。

开箱即用的集群配置模板,以及容器化的软件与应用模板。

Pigsty 所用周边组件与工具的中文文档:包管理、高可用、连接池、备份与监控。