PIG 文档
—— Packager Index Gateway，PostgreSQL 扩展包管理器
PIG 是一个自包含的 Go 命令行工具，用于安装、管理、构建 PostgreSQL 扩展软件包，并提供部分 PostgreSQL/Pigsty 运维能力；实际的软件包事务仍由操作系统原生工具完成。
PIG 包管理器并非重新发明的土鳖轮子，而是 依托 （PiggyBack）现有 Linux 发行版包管理器 （apt/dnf）的一个高级抽象层。
它通过目录把操作系统、CPU 架构与 PostgreSQL 大版本映射为原生软件包名，让您用统一 CLI 安装 PG 内核、查询 575 个已打包扩展条目；具体目标组合是否有包，仍以可用矩阵为准。
许多 PIG 原生工作流适合自动化：只有在具体命令文档明确支持时，才使用结构化输出、--plan、确认控制与结果码。透传、交互式和流式命令仍保留上游工具或终端自身的行为。
请注意：对于扩展安装来说，pig 并非必须组件，您依然可以使用 apt / dnf 等包管理器直接访问 Pigsty PGSQL 仓库。
按 Ctrl 加 K（macOS 为 ⌘ 加 K）打开搜索与页面操作，或按 / 直接进入命令模式。
AI 助手操作只会在您主动选择后打开 ChatGPT 或 Claude；届时会把当前页面的公开 URL 与阅读提示交给对应的第三方服务，PIG 不会自动发送页面正文。
快速上手
安装 pig
使用默认的 Cloudflare 加速安装入口：
中国大陆可改用镜像入口：
软件包、发布压缩包、升级与卸载方式详见 安装。
配置软件仓库
在 Linux 上一次性注册 Pigsty 与 PGDG 仓库；该命令会覆盖对应配置，请先检查生成结果：
安装 PostgreSQL 与扩展
安装 PostgreSQL 18 内核，以及 pg_duckdb 与 vector 扩展软件包：
这些命令安装的是主机软件包。请用 pig ext info NAME 配合各扩展文档，在每个目标数据库中完成预加载、重启、CREATE EXTENSION 与 SQL 升级步骤。目录查询、别名解析与安装后检查详见完整的 上手教程。
命令参考
你可以执行 pig help <command> 获取子命令的详细帮助。
扩展管理：
- pig repo：管理 APT/YUM 软件仓库
- pig ext：管理 PostgreSQL 扩展
- pig build：从源码构建扩展
- pig install：通过原生包管理器安装 PostgreSQL 与扩展包
Pigsty 管理：
- pig sty：管理 Pigsty 安装与 Grafana 仪表盘
- pig inventory：检视、编辑、校验与交换 Pigsty 配置清单
- pig context：采集主机、PostgreSQL、Patroni、pgBackRest 与扩展上下文
- pig do：执行有边界的 Pigsty 管理 Playbook 任务
- pig pg：管理本地 PostgreSQL 服务
- pig pt：透明运行 patronictl 管理 Patroni HA 集群
- pig pe：检查并重载运行中的 pg_exporter
- pig pb：管理 pgBackRest 备份
- pig pitr：时间点恢复工作流
设计归档解释这些命令契约背后的决策与取舍。
关于
pig 命令行工具由 Vonng（冯若航 [email protected]）开发，并以 Apache 2.0 许可证开源。
您还可以参考 PIGSTY 项目，提供了包括扩展交付在内的完整 PostgreSQL RDS DBaaS 使用体验。