Pigsty 中文文档 v4.5
“PostgreSQL In Great STYle”: Postgres, Infras, Graphics, Service, Toolbox, it’s all Yours.
—— 开源免费、开箱即用、本地优先、自主可控的企业级 PostgreSQL 发行版与 RDS 方案
开源免费 本地优先 生产可用
仓库 | 演示 | 博客 | 论坛 | 微信 | EN Docs
按 ⌘+ 加 K(macOS)或 Ctrl+ 加 K 可随时打开本地搜索与命令面板。
简介
从了解项目、理解概念,到单机上手、生产部署,四步掌握 Pigsty:
了解 Pigsty 项目本身的方方面面:功能特性、历史沿革、开源协议、隐私政策与社区动态。
理解 Pigsty 的核心概念、架构设计与设计理念,掌握高可用、备份恢复、安全合规等关键能力。
在你的笔记本或云服务器上拉起 Pigsty 单机版本,访问数据库服务与 Web 管理界面。
在生产环境中进行多节点、高可用的 Pigsty 架构规划、资源准备与正式部署。
安装
快速上手:准备 一台全新安装 Linux 操作系统的节点,使用具有免密 ssh 与 sudo 权限的用户运行:
curl -fsSL https://repo.pigsty.cc/get | bash -s v4.4.0 # 下载公开稳定版源码包
cd ~/pigsty # 进入源码目录
./configure # 生成配置文件
./deploy.yml # 执行安装部署
下载、配置 与 部署,Pigsty 会在几分钟内完成安装!您可以稍后 添加更多节点 与数据库集群。
接下来,您可以探索 图形界面,访问 5432 端口上的 PostgreSQL 服务,以及 3000 端口上的 Grafana 监控大盘(用户名 / 密码:admin / pigsty)。
您还可以将多种风味的 PostgreSQL 内核 封装为 RDS 服务:Citus、WiltonDB、IvorySQL、OpenHalo、Percona、OrioleDB、PolarDB,以及 Supabase。
模块
Pigsty 由多个 模块 组成。其中 PGSQL / INFRA / NODE / ETCD(PINE 组合)是自建 PostgreSQL RDS 服务的 必选 模块:
自治自愈的高可用 PostgreSQL 集群:HA、PITR、IaC、ACL 与监控齐备,海量扩展开箱即用。
Nginx、本地软件仓库、DNS、NTP,以及 VictoriaMetrics 与 Grafana 可观测性技术栈。
将主机节点纳管调整至期望状态:主机监控、日志收集、VIP 与 HAProxy 负载均衡。
可靠的分布式共识存储(DCS),为 PostgreSQL 高可用提供集群元数据支撑。
此外还有一些 可选 模块,它们与 PostgreSQL 配合良好,可为你的数据基础设施带来额外价值:
S3 兼容的对象存储,可用作数据库备份的集中存储仓库。
高性能内存数据结构服务器,主从、集群、哨兵三种模式。
容器运行时,一键拉起容器化的无状态软件与应用模板。
JuiceFS 分布式文件系统,将 PostgreSQL 挂载为文件系统
AI 编程沙箱,Claude/Codex 开发环境,Agent 运行时
Apache Kafka 4.x dynamic KRaft 消息队列集群,安全与监控齐备。
MySQL 数据库,广泛使用的关系型数据库管理系统。
试点功能模组:Kubernetes、DuckDB、MySQL、TigerBeetle……供尝鲜探索。
参考信息
详尽的参考资料、扩展目录、开箱即用的模板,以及周边组件的中文文档:
详尽的参考信息列表:操作系统、文件结构、参数、监控指标与同类产品对比。
575 个已打包 PostgreSQL 生态扩展:元数据、文档、下载与支持矩阵。
开箱即用的集群配置模板,以及容器化的软件与应用模板。
Pigsty 所用周边组件与工具的中文文档:包管理、高可用、连接池、备份与监控。