上手

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

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

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

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

pigsty-arch

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

如果您想要在没有互联网连接的环境中安装 Pigsty,请参考 离线安装 模式。 如果您只需要 PostgreSQL 数据库本身,请参考 精简安装 模式。 如果您准备开始进行严肃的多节点生产部署,请参考 部署指南


快速开始

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

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

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

接下来,您可以探索 图形用户界面,访问 PostgreSQL 数据库服务;或者进行 配置定制执行剧本 部署更多集群。


快速上手 Pigsty 单机部署

快速上手 Pigsty,从一台全新的 Linux 主机开始,完成单机安装部署!

从浏览器访问图形用户界面

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

快速上手 PostgreSQL

快速上手 PostgreSQL,使用命令行与图形客户端连接上 PostgreSQL 并开始使用。

通过配置清单定制 Pigsty 部署

使用声明式的配置文件,表达你需要的基础设施与集群。

使用 Ansible 剧本完成部署

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

离线安装

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

精简安装

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

安全建议

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


最后修改 2026-01-09: add supabase asciinema demo (3104503)