上手

在你的笔记本/云服务器上部署 Pigsty 单机版本,访问数据库以及 Web 用户界面,试用 Pigsty 的功能。

Pigsty 采用可伸缩的架构设计,既可用于 超大规模生产环境,也可用于 单机开发演示环境,本文关注后者。


快速开始

准备 一台具有 SSH 权限节点, 安装 兼容的 Linux 系统,使用具有免密 sshsudo 权限的 管理用户 执行以下命令:

curl -fsSL https://repo.pigsty.cc/get | bash  # 安装 Pigsty 与依赖
cd ~/pigsty; ./configure -g                   # 生成配置(使用默认单机配置模板,-g 参数会生成随机密码)
./deploy.yml                                  # 执行部署剧本,完成部署

是的,就是这么简单。您完全可以在不了解任何细节的情况下,使用预制配置模板一键拉起 Pigsty。

接下来,您可以探索 用户界面,并通过 5432 端口访问 PostgreSQL 服务


单机环境

如果您打算学习了解 Pigsty,可以从 快速上手 开始。一台 1C/2G 的 Linux 虚拟机即可运行 Pigsty。

您可以利用一台 Linux MiniPC,或者云厂商提供的免费/优惠虚拟机,或者在自己的笔记本上创建虚拟机。 Pigsty 提供了开箱即用的 Vagrant 模板与 Terraform 模版,可以帮助您一键在本地或云端置备虚拟机环境。

单机版本的 Pigsty 包含了所有核心功能,440+ 个 PG 扩展,自包含的 Grafana / Victoria 监控,IaC 制备能力。 以及本地 PITR 时间点恢复。如果您配备了外部的对象存储(用于 PostgreSQL 备份),那么对于 Demo,个人网站,小型服务等场景, 即使是单机环境,也可以提供一定程度的数据持久性保证。但单机无法实现高可用性 —— 故障自动切换至少需要 3 个节点。

如果您只需要 PostgreSQL 数据库本身,不需要监控基础设施,可以考虑 精简安装 模式。

如果您想要在没有互联网连接的环境中安装 Pigsty,请参考 离线安装 模式。


生产环境

生产质量的 Pigsty 集群需要规划与准备,如果你的 Pigsty 集群是用来支撑关键业务系统的, 那么请务必使用至少三个节点以实现标准的高可用性。更详细的说明请参考 部署

Pigsty 提供了一个 4 节点的小型 沙箱环境,与一个 42 节点的大型 仿真环境,用于模拟生产测试。 您可以在单台高规格的笔记本/PC/服务器上运行这些沙箱环境,以便进行功能测试与验证。


本章内容

文档说明
快速上手在联网环境中安装标准的 Pigsty 单机版本
用户界面探索仪表盘并访问数据库服务
上手 PG新手上路,PostgreSQL 101 基本知识
配置定制使用声明式配置描述基础设施与集群
剧本执行使用 Ansible 剧本部署管理集群
离线安装在没有互联网访问的情况下从离线包引导安装
精简安装仅安装高可用 Postgres 集群所必须的组件
安全加固生产环境的安全加固和最佳实践

快速上手

单机安装 Pigsty,从全新的 Linux 主机开始!

Web 图形用户界面

探索 Pigsty 提供的 Web 图形管理界面,Grafana 大盘,以及如何通过域名和 HTTPS 访问它们。

使用 PostgreSQL

快速上手 PostgreSQL,连接上 PostgreSQL 并开始使用。

配置定制

使用声明式的配置文件描述你需要的基础设施与集群

剧本执行

使用 Ansible 剧本部署与管理 Pigsty 集群

离线安装

在没有互联网访问的环境中,使用离线安装包安装 Pigsty

精简安装

只安装高可用 PostgreSQL 集群及其最小依赖的精简安装模式

安全加固

单机部署,快速上手时的三点安全加固建议


最后修改 2025-12-28: batch update (73c7f8e)