软件置备
本文档介绍 Pigsty 部署前的软件相关准备工作。
Linux
Pigsty 运行在 Linux 操作系统上，它支持 14 种主流 Linux 发行版：兼容操作系统列表
我们推荐使用 RockyLinux 9.6、Debian 12.11 或 Ubuntu 24.04.5 作为默认操作系统选项。
您可以在 macOS 上安装 Pigsty，并使用 ansible 从本地笔记本电脑发起控制（用作管理节点）。
但数据库/基础设施/节点/ETCD 服务仍在 Linux 节点上运行。
我们 强烈建议 使用全新安装的操作系统环境，并将 en_US 设置为主要语言。
在使用其他主要语言时确保 en_US 区域设置可用：
localedef -i en_US -f UTF-8 en_US.UTF-8
localectl set-locale LANG=en_US.UTF-8
Pigsty 不 使用容器，主要组件针对特定发行版主版本打包。
请在单个部署中的所有节点上使用相同的操作系统主版本和次版本。
文件系统
Pigsty 建议使用 ext4 或 xfs 文件系统，两者在 PostgreSQL 用例上都有最好的性能表现。
如果您清楚知道自己在做什么，也可以考虑使用 zfs 这样的文件系统，但切勿使用 nfs 等网络文件系统运行数据库服务。
如果您需要使用到 MinIO，建议使用 xfs 文件系统，这是 MinIO 唯一推荐使用的文件系统。
它在大量小文件的场景中有更好的性能表现，但工具生态（例如数据恢复）略逊于 ext4。
如果您只是运行标准 PostgreSQL 服务，我们建议您默认使用 Linux ext4 文件系统。
防火墙
您的安全策略和防火墙设置应该允许访问所需的端口。
要访问 WebUI 服务，您必须允许 HTTP（80）/ HTTPS（443）访问。
要访问 PostgreSQL 数据库服务，您必须允许 PostgreSQL 的 5432 端口。
5432: PostgreSQL 数据库6432: Pgbouncer 连接池5433: PG 主要服务5434: PG 副本服务5436: PG 默认服务5438: PG 离线服务
如果您通过其他端口访问 PostgreSQL 服务，请相应地允许它们。
在典型的公有云 VPS 设置中，端口 22/80/443/5432 通常是开放的。
直接向互联网暴露数据库服务端口是非常危险的。 如果您需要这样做，请考虑咨询 安全最佳实践 并谨慎进行。
在典型的生产设置中，端口 22/80/443 从 LAN / 跳板机向 DBA/OPS 开放。
其他端口从内网访问。您必须确保它们在内部开放：使用的端口。
Ansible
Pigsty 使用 Ansible 从管理节点发起对所有被管理节点的控制。
您不需要关心细节，Ansible 在 Bootstrap 阶段安装。
Debian / Ubuntu
sudo apt install -y ansible python3-jmespath
EL 9 / EL 10
sudo dnf install -y ansible python3-jmespath
EL 8
sudo dnf install -y ansible python3.12-jmespath
macOS
brew install ansible
pip3 install jmespath
Ansible 只在管理节点上需要，您可以在 macOS 上运行 Ansible 将您的笔记本电脑用作管理节点。
Pigsty
您可以使用以下方式获取并提取最新稳定版本的 Pigsty 源代码：
curl -fsSL https://repo.pigsty.io/get | bash; cd ~/pigsty # 国际区域
curl -fsSL https://repo.pigsty.cc/get | bash; cd ~/pigsty # 中国镜像
curl -fsSL https://repo.pigsty.io/get | bash -s v4.0.0; cd ~/pigsty # 安装特定版本
您也可以使用 git 从 GitHub 克隆 Pigsty 源代码仓库：
git clone https://github.com/pgsty/pigsty.git; cd pigsty; git checkout v4.0.0
默认的 main 分支可能处于不稳定的开发状态，使用前请 git checkout v4.0.0。
如果您的环境没有互联网访问，请考虑与源代码压缩包一起下载离线软件包并将其上传到您的节点。 详情请查看 离线安装。