# Patroni 4.1.4 中文文档

> Patroni PostgreSQL 高可用模板，v4.1.4 中文文档

---

LLMS 索引： [llms.txt](/llms.txt)

---

> 原始页面： https://patroni.readthedocs.io/en/latest/index.html

Patroni 是一个基于 Python 的 PostgreSQL 高可用（HA）解决方案模板。为了最大程度地兼容各种环境，Patroni 支持多种分布式配置存储后端，包括 [ZooKeeper](https://zookeeper.apache.org/)、[etcd](https://github.com/coreos/etcd)、[Consul](https://github.com/hashicorp/consul) 和 [Kubernetes](https://kubernetes.io)。希望在数据中心或任何其他环境中快速部署 PostgreSQL 高可用的数据库工程师、DBA、DevOps 工程师和 SRE 们，都能从中受益。

我们将 Patroni 称为"模板"，是因为它远非一套放之四海而皆准的即插即用复制系统，使用时需要结合实际情况量力而行。实现 PostgreSQL 高可用的方案有很多，详情可参阅 [**PostgreSQL 文档**](https://wiki.postgresql.org/wiki/Replication,_Clustering,_and_Connection_Pooling)。

目前支持的 PostgreSQL 版本：9.3 至 18。

**Citus 用户注意**：从 3.0 版本起，Patroni 已与 PostgreSQL 扩展 [Citus](https://github.com/citusdata/citus) 深度集成。如需了解如何将 Patroni 高可用与 Citus 分布式集群结合使用，请参阅文档中的 [**Citus 支持页面**](/docs/patroni/citus#citus)。

**Kubernetes 用户注意**：Patroni 可原生运行在 Kubernetes 之上。请参阅文档中的 [**Kubernetes**](/docs/patroni/kubernetes#kubernetes) 章节。

<img src="/img/docs/patroni/patroni-logo.png" width="128" height="128" alt="image" />

---

本节页面：

- [简介](/docs/patroni/readme/): Patroni 简介、快速上手以及高可用核心概念。
- [安装](/docs/patroni/installation/): 在各支持平台上安装和升级 Patroni 的详细说明。
- [Patroni 配置](/docs/patroni/config/): Patroni 配置模型、优先级规则与验证工具。
- [Patroni REST API](/docs/patroni/rest_api/): Patroni REST API 端点与操作行为参考。
- [patronictl 命令行](/docs/patroni/patronictl/): patronictl 的配置说明、语法参考与子命令完整参考。
- [从库镜像与引导](/docs/patroni/replica_bootstrap/): 从库镜像、引导及自定义从库创建工作流。
- [复制模式](/docs/patroni/replication_modes/): Patroni 管理的异步与同步复制模式。
- [备用集群](/docs/patroni/standby_cluster/): 备用集群的搭建、行为及从远程主库复制的说明。
- [Watchdog 支持](/docs/patroni/watchdog/): Patroni 集群的 watchdog 集成与隔离（fencing）注意事项。
- [集群的暂停/恢复模式](/docs/patroni/pause/): Patroni 集群管理中的暂停与恢复模式行为说明。
- [DCS 故障安全模式](/docs/patroni/dcs_failsafe_mode/): DCS 故障安全模式的行为机制、启用条件与操作注意事项。
- [在 Kubernetes 中使用 Patroni](/docs/patroni/kubernetes/): 结合 Kubernetes 对象、标签和服务发现使用 Patroni。
- [Citus 支持](/docs/patroni/citus/): Patroni 与 Citus 协调节点及工作节点组的集成详情。
- [将独立实例转换为 Patroni 集群](/docs/patroni/existing_data/): 将现有 PostgreSQL 数据迁移并转换为 Patroni 集群的操作步骤。
- [与其他工具的集成](/docs/patroni/tools_integration/): Patroni 与外部备份及编排工具的集成方法。
- [安全注意事项](/docs/patroni/security/): DCS、REST API 及凭据处理的安全注意事项。
- [多数据中心高可用](/docs/patroni/ha_multi_dc/): 基于 Patroni 复制的多数据中心高可用架构模式。
- [常见问题](/docs/patroni/faq/): 关于 Patroni 运维与故障排查的常见问题解答。
- [版本历史](/docs/patroni/releases/): Patroni 各版本发布说明与变更历史。
- [贡献指南](/docs/patroni/contributing_guidelines/): 贡献工作流程、支持渠道与开发指南。
