# Pigsty 中文文档 v4.5

LLMS index: [llms.txt](/llms.txt)

---

"<strong>P</strong>ostgreSQL <strong>I</strong>n <strong>G</strong>reat <strong>STY</strong>le": <strong>P</strong>ostgres, <strong>I</strong>nfras, <strong>G</strong>raphics, <strong>S</strong>ervice, <strong>T</strong>oolbox, it's all <strong>Y</strong>ours.

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

**开源免费** **本地优先** **生产可用**

> [仓库](https://github.com/pgsty/pigsty) | [演示](https://demo.pigsty.cc) | [博客](/blog) | [论坛](https://github.com/pgsty/pigsty/discussions) | [微信](https://mp.weixin.qq.com/s/-E_-HZ7LvOze5lmzy3QbQA) | [EN Docs](https://pigsty.io/docs/)

按 ⌘ + K（macOS）或 Ctrl + K 可随时打开本地搜索与命令面板。

## 简介

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

<div id="td-nav-cards-7e884e68a840edf8b20756fc47fcf074-5" class="td-content-cards" style="--td-card-columns: 2">
<article id="td-nav-card-7e884e68a840edf8b20756fc47fcf074-nav-cards-5-0" class="td-content-card">
  <div class="td-content-card__body">
    <div class="td-content-card__head"><i class="fa-solid fa-circle-info td-content-card__icon" aria-hidden="true"></i><a class="td-content-card__title" href="/docs/about/">关于</a></div><p class="td-content-card__description">了解 Pigsty 项目本身的方方面面：功能特性、历史沿革、开源协议、隐私政策与社区动态。</p>
    <div class="td-content-card__links"><a href="/docs/about/feature">功能特性</a> <a href="/docs/about/history">历史沿革</a> <a href="/docs/about/event">活动新闻</a> <a href="/docs/about/community">加入社区</a> <a href="/docs/about/license">开源协议</a> <a href="/docs/about/service">服务订阅</a></div>
  </div>
</article>

<article id="td-nav-card-7e884e68a840edf8b20756fc47fcf074-nav-cards-5-1" class="td-content-card">
  <div class="td-content-card__body">
    <div class="td-content-card__head"><i class="fa-solid fa-compass td-content-card__icon" aria-hidden="true"></i><a class="td-content-card__title" href="/docs/concept/">概念</a></div><p class="td-content-card__description">理解 Pigsty 的核心概念、架构设计与设计理念，掌握高可用、备份恢复、安全合规等关键能力。</p>
    <div class="td-content-card__links"><a href="/docs/concept/arch">系统架构</a> <a href="/docs/concept/model">集群模型</a> <a href="/docs/concept/monitor">监控系统</a> <a href="/docs/concept/iac">IaC</a> <a href="/docs/concept/ha">高可用</a> <a href="/docs/concept/pitr">PITR</a> <a href="/docs/pgsql/misc/svc">服务接入</a> <a href="/docs/concept/sec">安全加固</a></div>
  </div>
</article>

<article id="td-nav-card-7e884e68a840edf8b20756fc47fcf074-nav-cards-5-2" class="td-content-card">
  <div class="td-content-card__body">
    <div class="td-content-card__head"><i class="fa-solid fa-rocket td-content-card__icon" aria-hidden="true"></i><a class="td-content-card__title" href="/docs/setup/">上手</a></div><p class="td-content-card__description">在你的笔记本或云服务器上拉起 Pigsty 单机版本，访问数据库服务与 Web 管理界面。</p>
    <div class="td-content-card__links"><a href="/docs/setup/install">单机安装</a> <a href="/docs/setup/offline">离线安装</a> <a href="/docs/setup/config">声明配置</a> <a href="/docs/setup/playbook">执行剧本</a> <a href="/docs/setup/webui">图形界面</a> <a href="/docs/pgsql/faq">常见问题</a></div>
  </div>
</article>

<article id="td-nav-card-7e884e68a840edf8b20756fc47fcf074-nav-cards-5-3" class="td-content-card">
  <div class="td-content-card__body">
    <div class="td-content-card__head"><i class="fa-solid fa-download td-content-card__icon" aria-hidden="true"></i><a class="td-content-card__title" href="/docs/deploy/">部署</a></div><p class="td-content-card__description">在生产环境中进行多节点、高可用的 Pigsty 架构规划、资源准备与正式部署。</p>
    <div class="td-content-card__links"><a href="/docs/deploy/planning">架构规划</a> <a href="/docs/deploy/prepare">资源准备</a> <a href="/docs/deploy/install">生产部署</a> <a href="/docs/deploy/sandbox">沙箱环境</a> <a href="/docs/deploy/vagrant">Vagrant</a> <a href="/docs/deploy/terraform">Terraform</a></div>
  </div>
</article>

</div>


## 安装

[**快速上手**](/docs/setup/install)：[**准备**](/docs/deploy/prepare) 一台全新安装 [**Linux**](/docs/ref/linux) 操作系统的节点，使用具有免密 `ssh` 与 `sudo` 权限的用户运行：

```bash {filename="Terminal" copy="all" label="Pigsty 快速安装"}
curl -fsSL https://repo.pigsty.cc/get | bash -s v4.4.0   # 下载公开稳定版源码包
cd ~/pigsty      # 进入源码目录
./configure      # 生成配置文件
./deploy.yml     # 执行安装部署
```

[**下载**](/docs/setup/install#安装)、[**配置**](/docs/setup/install#配置) 与 [**部署**](/docs/setup/install#部署)，Pigsty 会在几分钟内完成安装！您可以稍后 [**添加更多节点**](/docs/deploy/install) 与数据库集群。

接下来，您可以探索 [**图形界面**](/docs/setup/webui)，访问 `5432` 端口上的 [**PostgreSQL 服务**](/docs/pgsql/service/)，以及 `3000` 端口上的 Grafana 监控大盘（用户名 / 密码：`admin` / `pigsty`）。

您还可以将多种风味的 [**PostgreSQL 内核**](/docs/pgsql/kernel/) 封装为 RDS 服务：[**Citus**](/docs/pgsql/kernel/citus)、[**WiltonDB**](/docs/pgsql/kernel/babelfish)、[**IvorySQL**](/docs/pgsql/kernel/ivorysql)、[**OpenHalo**](/docs/pgsql/kernel/openhalo)、[**Percona**](/docs/pgsql/kernel/percona)、[**OrioleDB**](/docs/pgsql/kernel/orioledb)、[**PolarDB**](/docs/pgsql/kernel/polardb)，以及 [**Supabase**](/docs/pgsql/kernel/supabase)。


## 模块

Pigsty 由多个 [**模块**](/docs/ref/module) 组成。其中 `PGSQL` / `INFRA` / `NODE` / `ETCD`（PINE 组合）是自建 PostgreSQL RDS 服务的 **必选** 模块：

<div id="td-nav-cards-7e884e68a840edf8b20756fc47fcf074-7" class="td-content-cards" style="--td-card-columns: 2">
<article id="td-nav-card-7e884e68a840edf8b20756fc47fcf074-nav-cards-7-0" class="td-content-card td-content-card--copper">
  <div class="td-content-card__body">
    <div class="td-content-card__head"><i class="fa-brands fa-postgresql td-content-card__icon" aria-hidden="true"></i><a class="td-content-card__title" href="/docs/pgsql/">PGSQL</a><span class="td-content-card__badge">核心</span></div><p class="td-content-card__description">自治自愈的高可用 PostgreSQL 集群：HA、PITR、IaC、ACL 与监控齐备，海量扩展开箱即用。</p>
    <div class="td-content-card__links"><a href="/docs/pgsql/config/">集群配置</a> <a href="/docs/pgsql/admin/">日常管理</a> <a href="/docs/pgsql/backup/">备份恢复</a> <a href="/docs/pgsql/service/">服务接入</a> <a href="/docs/pgsql/kernel/">内核分支</a> <a href="/docs/pgsql/param/">参数列表</a></div>
  </div>
</article>

<article id="td-nav-card-7e884e68a840edf8b20756fc47fcf074-nav-cards-7-1" class="td-content-card td-content-card--copper">
  <div class="td-content-card__body">
    <div class="td-content-card__head"><i class="fa-solid fa-bank td-content-card__icon" aria-hidden="true"></i><a class="td-content-card__title" href="/docs/infra/">INFRA</a><span class="td-content-card__badge">核心</span></div><p class="td-content-card__description">Nginx、本地软件仓库、DNS、NTP，以及 VictoriaMetrics 与 Grafana 可观测性技术栈。</p>
    <div class="td-content-card__links"><a href="/docs/infra/config">配置</a> <a href="/docs/infra/admin/">管理</a> <a href="/docs/infra/playbook">剧本</a> <a href="/docs/infra/monitor">监控</a> <a href="/docs/infra/param">参数</a></div>
  </div>
</article>

<article id="td-nav-card-7e884e68a840edf8b20756fc47fcf074-nav-cards-7-2" class="td-content-card td-content-card--copper">
  <div class="td-content-card__body">
    <div class="td-content-card__head"><i class="fa-solid fa-server td-content-card__icon" aria-hidden="true"></i><a class="td-content-card__title" href="/docs/node/">NODE</a><span class="td-content-card__badge">核心</span></div><p class="td-content-card__description">将主机节点纳管调整至期望状态：主机监控、日志收集、VIP 与 HAProxy 负载均衡。</p>
    <div class="td-content-card__links"><a href="/docs/node/config">配置</a> <a href="/docs/node/admin">管理</a> <a href="/docs/node/playbook">剧本</a> <a href="/docs/node/monitor">监控</a> <a href="/docs/node/param">参数</a></div>
  </div>
</article>

<article id="td-nav-card-7e884e68a840edf8b20756fc47fcf074-nav-cards-7-3" class="td-content-card td-content-card--copper">
  <div class="td-content-card__body">
    <div class="td-content-card__head"><i class="fa-solid fa-gears td-content-card__icon" aria-hidden="true"></i><a class="td-content-card__title" href="/docs/etcd/">ETCD</a><span class="td-content-card__badge">核心</span></div><p class="td-content-card__description">可靠的分布式共识存储（DCS），为 PostgreSQL 高可用提供集群元数据支撑。</p>
    <div class="td-content-card__links"><a href="/docs/etcd/config">配置</a> <a href="/docs/etcd/admin">管理</a> <a href="/docs/etcd/playbook">剧本</a> <a href="/docs/etcd/monitor">监控</a> <a href="/docs/etcd/param">参数</a></div>
  </div>
</article>

</div>


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

<div id="td-nav-cards-7e884e68a840edf8b20756fc47fcf074-8" class="td-content-cards" style="--td-card-columns: 3">
<article id="td-nav-card-7e884e68a840edf8b20756fc47fcf074-nav-cards-8-0" class="td-content-card td-content-card--gray">
  <div class="td-content-card__body">
    <div class="td-content-card__head"><i class="fa-solid fa-boxes-stacked td-content-card__icon" aria-hidden="true"></i><a class="td-content-card__title" href="/docs/minio/">MINIO</a><span class="td-content-card__badge">可选</span></div><p class="td-content-card__description">S3 兼容的对象存储，可用作数据库备份的集中存储仓库。</p>
  </div>
</article>

<article id="td-nav-card-7e884e68a840edf8b20756fc47fcf074-nav-cards-8-1" class="td-content-card td-content-card--gray">
  <div class="td-content-card__body">
    <div class="td-content-card__head"><i class="fa-solid fa-layer-group td-content-card__icon" aria-hidden="true"></i><a class="td-content-card__title" href="/docs/redis/">REDIS</a><span class="td-content-card__badge">可选</span></div><p class="td-content-card__description">高性能内存数据结构服务器，主从、集群、哨兵三种模式。</p>
  </div>
</article>

<article id="td-nav-card-7e884e68a840edf8b20756fc47fcf074-nav-cards-8-2" class="td-content-card td-content-card--gray">
  <div class="td-content-card__body">
    <div class="td-content-card__head"><i class="fa-brands fa-docker td-content-card__icon" aria-hidden="true"></i><a class="td-content-card__title" href="/docs/docker/">DOCKER</a><span class="td-content-card__badge">可选</span></div><p class="td-content-card__description">容器运行时，一键拉起容器化的无状态软件与应用模板。</p>
  </div>
</article>

<article id="td-nav-card-7e884e68a840edf8b20756fc47fcf074-nav-cards-8-3" class="td-content-card td-content-card--gray">
  <div class="td-content-card__body">
    <div class="td-content-card__head"><i class="fa-solid fa-folder-tree td-content-card__icon" aria-hidden="true"></i><a class="td-content-card__title" href="/docs/juice/">JUICE</a><span class="td-content-card__badge">可选</span></div><p class="td-content-card__description">JuiceFS 分布式文件系统，将 PostgreSQL 挂载为文件系统</p>
  </div>
</article>

<article id="td-nav-card-7e884e68a840edf8b20756fc47fcf074-nav-cards-8-4" class="td-content-card td-content-card--gray">
  <div class="td-content-card__body">
    <div class="td-content-card__head"><i class="fa-solid fa-laptop-code td-content-card__icon" aria-hidden="true"></i><a class="td-content-card__title" href="/docs/vibe/">VIBE</a><span class="td-content-card__badge">可选</span></div><p class="td-content-card__description">AI 编程沙箱，Claude/Codex 开发环境，Agent 运行时</p>
  </div>
</article>

<article id="td-nav-card-7e884e68a840edf8b20756fc47fcf074-nav-cards-8-5" class="td-content-card td-content-card--gray">
  <div class="td-content-card__body">
    <div class="td-content-card__head"><i class="fa-solid fa-share-nodes td-content-card__icon" aria-hidden="true"></i><a class="td-content-card__title" href="/docs/kafka/">KAFKA</a><span class="td-content-card__badge">可选</span></div><p class="td-content-card__description">Apache Kafka 4.x dynamic KRaft 消息队列集群，安全与监控齐备。</p>
  </div>
</article>

<article id="td-nav-card-7e884e68a840edf8b20756fc47fcf074-nav-cards-8-6" class="td-content-card td-content-card--gray">
  <div class="td-content-card__body">
    <div class="td-content-card__head"><i class="fa-solid fa-fish td-content-card__icon" aria-hidden="true"></i><a class="td-content-card__title" href="/docs/mysql/">MYSQL</a><span class="td-content-card__badge">可选</span></div><p class="td-content-card__description">MySQL 数据库，广泛使用的关系型数据库管理系统。</p>
  </div>
</article>

<article id="td-nav-card-7e884e68a840edf8b20756fc47fcf074-nav-cards-8-7" class="td-content-card td-content-card--gray">
  <div class="td-content-card__body">
    <div class="td-content-card__head"><i class="fa-solid fa-flask-vial td-content-card__icon" aria-hidden="true"></i><a class="td-content-card__title" href="/docs/pilot/">PILOT</a><span class="td-content-card__badge">试点</span></div><p class="td-content-card__description">试点功能模组：Kubernetes、DuckDB、MySQL、TigerBeetle……供尝鲜探索。</p>
  </div>
</article>

</div>



## 参考信息

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

<div id="td-nav-cards-7e884e68a840edf8b20756fc47fcf074-9" class="td-content-cards" style="--td-card-columns: 2">
<article id="td-nav-card-7e884e68a840edf8b20756fc47fcf074-nav-cards-9-0" class="td-content-card">
  <div class="td-content-card__body">
    <div class="td-content-card__head"><i class="fa-solid fa-map td-content-card__icon" aria-hidden="true"></i><a class="td-content-card__title" href="/docs/ref/">参考手册</a></div><p class="td-content-card__description">详尽的参考信息列表：操作系统、文件结构、参数、监控指标与同类产品对比。</p>
    <div class="td-content-card__links"><a href="/docs/ref/linux">操作系统</a> <a href="/docs/ref/module">模块列表</a> <a href="/docs/ref/fhs">文件结构</a> <a href="/docs/about/compare">同类产品</a> <a href="/docs/about/compare/cost">成本参考</a> <a href="/docs/sop/">运维 SOP</a></div>
  </div>
</article>

<article id="td-nav-card-7e884e68a840edf8b20756fc47fcf074-nav-cards-9-1" class="td-content-card">
  <div class="td-content-card__body">
    <div class="td-content-card__head"><i class="fa-solid fa-puzzle-piece td-content-card__icon" aria-hidden="true"></i><a class="td-content-card__title" href="/ext/">已打包扩展</a></div><p class="td-content-card__description">575 个已打包 PostgreSQL 生态扩展：元数据、文档、下载与支持矩阵。</p>
    <div class="td-content-card__links"><a href="/ext/list">扩展列表</a> <a href="/ext/os">系统支持</a> <a href="/docs/repo/">软件仓库</a></div>
  </div>
</article>

<article id="td-nav-card-7e884e68a840edf8b20756fc47fcf074-nav-cards-9-2" class="td-content-card">
  <div class="td-content-card__body">
    <div class="td-content-card__head"><i class="fa-solid fa-cubes td-content-card__icon" aria-hidden="true"></i><a class="td-content-card__title" href="/docs/conf/">开箱模板</a></div><p class="td-content-card__description">开箱即用的集群配置模板，以及容器化的软件与应用模板。</p>
    <div class="td-content-card__links"><a href="/docs/conf/">配置模板</a> <a href="/docs/app/">应用模板</a></div>
  </div>
</article>

<article id="td-nav-card-7e884e68a840edf8b20756fc47fcf074-nav-cards-9-3" class="td-content-card">
  <div class="td-content-card__body">
    <div class="td-content-card__head"><i class="fa-solid fa-toolbox td-content-card__icon" aria-hidden="true"></i><a class="td-content-card__title" href="/docs/pig/">组件手册</a></div><p class="td-content-card__description">Pigsty 所用周边组件与工具的中文文档：包管理、高可用、连接池、备份与监控。</p>
    <div class="td-content-card__links"><a href="/docs/pig/">pig</a> <a href="/docs/piglet/">piglet</a> <a href="/docs/patroni/">patroni</a> <a href="/docs/pgbouncer/">pgbouncer</a> <a href="/docs/pgbackrest/">pgbackrest</a> <a href="/docs/pg_exporter/">pg_exporter</a></div>
  </div>
</article>

</div>

---

Section pages:

- [PIGSTY](/docs/_div_pigsty/)
- [上手](/docs/setup/): 在你的笔记本/云服务器上部署 Pigsty 单机版本，访问数据库以及 Web 用户界面
- [部署](/docs/deploy/): 在生产环境中进行多节点、高可用的 Pigsty 规划、准备与部署工作。
- [概念](/docs/concept/): 理解 Pigsty 的核心概念、架构设计与设计理念，掌握高可用、备份恢复、安全合规等关键能力。
- [关于](/docs/about/): 了解 Pigsty 项目本身的方方面面：功能特性、历史发展，开源协议，隐私政策，社区活动与新闻。
- [参考信息](/docs/_div_ref/)
- [参考](/docs/ref/): 详细的参考信息与列表：支持的操作系统，模块，参数，监控指标，数据库扩展，同类对比，术语表等。
- [应用](/docs/app/): 基于 Pigsty 的应用模板与数据应用说明：使用 Docker Compose 拉起无状态应用，并将状态托管到外部 PostgreSQL / S3 兼容存储。
- [模板](/docs/conf/): 开箱即用的配置模板，针对具体场景的配置示例，以及配置文件的详细解释。
- [Linux 软件仓库](/docs/repo/): 用于交付 PostgreSQL 扩展的基础设施和软件包仓库
- [运维 SOP 索引](/docs/sop/): 面向新手用户的 Pigsty 与 PostgreSQL 运维文档索引：按常见任务找到应读文档。
- [功能模块](/docs/_div_module/)
- [模块：PGSQL](/docs/pgsql/): 使用 Pigsty v4.5 声明、部署、接入、监控、备份与管理 PostgreSQL 集群。
- [模块：INFRA](/docs/infra/): 可独立使用且可选的基础设施，为 PostgreSQL 提供 NTP，DNS，可观测性等基础服务。
- [模块：NODE](/docs/node/): 配置目标服务器，纳管主机节点，并将其调整至描述的状态。也包括节点上的 VIP，HAProxy 以及监控组件。
- [模块：ETCD](/docs/etcd/): Pigsty 可部署 etcd 模块，作为 DCS 为 PostgreSQL 高可用提供可靠的分布式配置存储支持。
- [模块：MINIO](/docs/minio/): 使用 MINIO 兼容模块部署 Silo S3 对象存储，并作为 PostgreSQL 备份仓库。
- [模块：REDIS](/docs/redis/): 使用统一的 REDIS 模块部署 Redis 或 Valkey，并支持独立主从、原生集群与 Sentinel 三种模式。
- [模块：DOCKER](/docs/docker/): Docker Daemon 服务，允许用户一键拉起容器化的无状态软件工具模板，加装各种功能。
- [模块：JUICE](/docs/juice/): 使用 JuiceFS 分布式文件系统，以 PostgreSQL 作为元数据引擎，提供可共享的 POSIX 存储。
- [模块：VIBE](/docs/vibe/): 使用 Pigsty 部署 AI 编程沙箱：Code-Server、JupyterLab、Node.js、Claude Code 与 Codex CLI。
- [模块：KAFKA](/docs/kafka/): 使用 Pigsty 部署、保护与监控 Apache Kafka 4.1+ 动态 KRaft 集群。
- [模块：MYSQL](/docs/mysql/): 使用 Pigsty 部署原生 MySQL 8.4 LTS 单机或三节点 InnoDB Cluster，附带 TLS、每日备份与完整监控。
- [模块：PILOT](/docs/pilot/): 试点开发的额外功能模组
- [其他组件](/docs/_div_misc/)
- [pig 1.8 文档](/docs/pig/): PostgreSQL 扩展生态包管理器与管理命令行工具
- [Piglet Runtime：AI 运行时沙箱](/docs/piglet/): Pigsty 轻量运行时，AI Vibe Coding 沙箱，一键在云端拉起你的写意编程环境
- [Patroni 4.1.4 中文文档](/docs/patroni/): Patroni PostgreSQL 高可用模板，v4.1.4 中文文档
- [pgBouncer 1.25 中文文档](/docs/pgbouncer/): PgBouncer —— PostgreSQL 轻量级连接池，v1.25 中文文档
- [pgBackRest 2.59 中文文档](/docs/pgbackrest/): 可靠的 PostgreSQL 备份与恢复工具 —— pgBackRest 文档与参考手册。
- [PG Exporter 1.4 中文文档](/docs/pg_exporter/): 高级 PostgreSQL 与 PgBouncer 监控指标导出器
