# PGSQL 仓库

> PostgreSQL 扩展和内核分支仓库

---

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

---

`pigsty-pgsql` 仓库包含特定于 PostgreSQL 主版本的软件包（通常也特定于特定的 Linux 发行版主版本），包括扩展和一些内核分支。

当前活跃维护的 PostgreSQL 扩展构建范围为 **14-18**，PG 13 已退出当前维护窗口。

您可以参考 [**发布 - RPM 变更日志**](/docs/repo/pgsql/rpm/) / [**发布 - DEB 变更日志**](/docs/repo/pgsql/deb/) 查阅最近的版本更新情况。


---------

## 快速上手

### PIG

您可以安装 [**`pig`**](/docs/pig/) CLI 工具，并使用它添加 pgdg / pigsty 仓库（推荐）：

```bash
pig repo add pigsty                         # 添加 pigsty-pgsql 仓库
pig repo add pigsty -u                      # 添加 pigsty-pgsql 仓库，并更新本地缓存
pig repo add pigsty -u --region=default     # 强制使用全球默认区域的仓库（pigsty.io）
pig repo add pigsty -u --region=china       # 使用中国镜像仓库 (pigsty.cc)
pig repo add pgsql -u                       # pgsql = pgdg + pigsty-pgsql (同时添加 Pigsty 与 PGDG 官方仓库)
pig repo add -u                             # all = node + pgsql (pgdg + pigsty) + infra，一次性添加所有仓库
```

> **提示**：如果您在中国大陆区域，可以考虑使用中国 CDN 镜像（将 pigsty.io 替换为 pigsty.cc）


### APT

您也可以直接在 Debian / Ubuntu 上使用 `apt` 启用此仓库：

**默认**

<div class="td-code td-code--untitled" id="td-code-8c11568f-fence-0-tabpane-0-tab-0" data-td-code data-td-code-auto-id
     data-language="bash" data-line-count="11"><div class="td-code__utilities td-code__utilities--compact">
  <span class="td-code__language">BASH</span>
</div>
  <div class="td-code__viewport" id="td-code-8c11568f-fence-0-tabpane-0-tab-0-viewport" data-td-code-viewport><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="c1"># 将 Pigsty 的 GPG 公钥添加到您的系统密钥链以验证包签名</span>
</span></span><span class="line"><span class="cl">curl -fsSL https://repo.pigsty.io/key <span class="p">|</span> sudo gpg --dearmor -o /etc/apt/keyrings/pigsty.gpg
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># 获取 Debian / Ubuntu 发行版代号（bookworm, trixie, jammy, noble, resolute），并将相应的上游仓库地址写入 APT List 文件</span>
</span></span><span class="line"><span class="cl"><span class="nv">distro_codename</span><span class="o">=</span><span class="k">$(</span>lsb_release -cs<span class="k">)</span>
</span></span><span class="line"><span class="cl">sudo tee /etc/apt/sources.list.d/pigsty-io.list &gt; /dev/null <span class="s">&lt;&lt;EOF
</span></span></span><span class="line"><span class="cl"><span class="s">deb [signed-by=/etc/apt/keyrings/pigsty.gpg] https://repo.pigsty.io/apt/pgsql/${distro_codename} ${distro_codename} main
</span></span></span><span class="line"><span class="cl"><span class="s">EOF</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># 刷新 APT 仓库缓存</span>
</span></span><span class="line"><span class="cl">sudo apt update</span></span></code></pre></div></div>
</div>

**镜像**

<div class="td-code td-code--untitled" id="td-code-8c11568f-fence-0-tabpane-0-tab-1" data-td-code data-td-code-auto-id
     data-language="bash" data-line-count="12"><div class="td-code__utilities td-code__utilities--compact">
  <span class="td-code__language">BASH</span>
</div>
  <div class="td-code__viewport" id="td-code-8c11568f-fence-0-tabpane-0-tab-1-viewport" data-td-code-viewport><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="c1"># 在中国大陆或 Cloudflare 不可用时使用</span>
</span></span><span class="line"><span class="cl"><span class="c1"># 将 Pigsty 的 GPG 公钥添加到您的系统密钥链以验证包签名</span>
</span></span><span class="line"><span class="cl">curl -fsSL https://repo.pigsty.cc/key <span class="p">|</span> sudo gpg --dearmor -o /etc/apt/keyrings/pigsty.gpg
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># 获取 Debian 发行版代号，并将相应的上游仓库地址写入 APT List 文件</span>
</span></span><span class="line"><span class="cl"><span class="nv">distro_codename</span><span class="o">=</span><span class="k">$(</span>lsb_release -cs<span class="k">)</span>
</span></span><span class="line"><span class="cl">sudo tee /etc/apt/sources.list.d/pigsty-io.list &gt; /dev/null <span class="s">&lt;&lt;EOF
</span></span></span><span class="line"><span class="cl"><span class="s">deb [signed-by=/etc/apt/keyrings/pigsty.gpg] https://repo.pigsty.cc/apt/pgsql/${distro_codename} ${distro_codename} main
</span></span></span><span class="line"><span class="cl"><span class="s">EOF</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># 刷新 APT 仓库缓存</span>
</span></span><span class="line"><span class="cl">sudo apt update</span></span></code></pre></div></div>
</div>


### DNF

您也可以直接在兼容 EL 的系统上使用 `dnf`/`yum` 启用此仓库：

**默认**

<div class="td-code td-code--untitled" id="td-code-8c11568f-fence-0-tabpane-1-tab-0" data-td-code data-td-code-auto-id
     data-language="bash" data-line-count="18"><div class="td-code__utilities td-code__utilities--compact">
  <span class="td-code__language">BASH</span>
</div>
  <div class="td-code__viewport" id="td-code-8c11568f-fence-0-tabpane-1-tab-0-viewport" data-td-code-viewport><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="c1"># 将 Pigsty 的 GPG 公钥添加到您的系统密钥链以验证包签名</span>
</span></span><span class="line"><span class="cl">curl -fsSL https://repo.pigsty.io/key <span class="p">|</span> sudo tee /etc/pki/rpm-gpg/RPM-GPG-KEY-pigsty &gt;/dev/null
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># 将 Pigsty 仓库定义文件添加到 /etc/yum.repos.d/ 目录，包括两个仓库</span>
</span></span><span class="line"><span class="cl">sudo tee /etc/yum.repos.d/pigsty-pgsql.repo &gt; /dev/null <span class="s">&lt;&lt;-&#39;EOF&#39;
</span></span></span><span class="line"><span class="cl"><span class="s">[pigsty-pgsql]
</span></span></span><span class="line"><span class="cl"><span class="s">name=Pigsty PGSQL For el$releasever.$basearch
</span></span></span><span class="line"><span class="cl"><span class="s">baseurl=https://repo.pigsty.io/yum/pgsql/el$releasever.$basearch
</span></span></span><span class="line"><span class="cl"><span class="s">skip_if_unavailable = 1
</span></span></span><span class="line"><span class="cl"><span class="s">enabled = 1
</span></span></span><span class="line"><span class="cl"><span class="s">priority = 1
</span></span></span><span class="line"><span class="cl"><span class="s">gpgcheck = 1
</span></span></span><span class="line"><span class="cl"><span class="s">gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-pigsty
</span></span></span><span class="line"><span class="cl"><span class="s">module_hotfixes=1
</span></span></span><span class="line"><span class="cl"><span class="s">EOF</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># 刷新 YUM/DNF 仓库缓存</span>
</span></span><span class="line"><span class="cl">sudo yum makecache<span class="p">;</span></span></span></code></pre></div></div>
</div>

**镜像**

<div class="td-code td-code--untitled" id="td-code-8c11568f-fence-0-tabpane-1-tab-1" data-td-code data-td-code-auto-id
     data-language="bash" data-line-count="19"><div class="td-code__utilities td-code__utilities--compact">
  <span class="td-code__language">BASH</span>
</div>
  <div class="td-code__viewport" id="td-code-8c11568f-fence-0-tabpane-1-tab-1-viewport" data-td-code-viewport><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="c1"># 在中国大陆或 Cloudflare 不可用时使用</span>
</span></span><span class="line"><span class="cl"><span class="c1"># 将 Pigsty 的 GPG 公钥添加到您的系统密钥链以验证包签名</span>
</span></span><span class="line"><span class="cl">curl -fsSL https://repo.pigsty.cc/key <span class="p">|</span> sudo tee /etc/pki/rpm-gpg/RPM-GPG-KEY-pigsty &gt;/dev/null
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># 将 Pigsty 仓库定义文件添加到 /etc/yum.repos.d/ 目录</span>
</span></span><span class="line"><span class="cl">sudo tee /etc/yum.repos.d/pigsty-pgsql.repo &gt; /dev/null <span class="s">&lt;&lt;-&#39;EOF&#39;
</span></span></span><span class="line"><span class="cl"><span class="s">[pigsty-pgsql]
</span></span></span><span class="line"><span class="cl"><span class="s">name=Pigsty PGSQL For el$releasever.$basearch
</span></span></span><span class="line"><span class="cl"><span class="s">baseurl=https://repo.pigsty.cc/yum/pgsql/el$releasever.$basearch
</span></span></span><span class="line"><span class="cl"><span class="s">skip_if_unavailable = 1
</span></span></span><span class="line"><span class="cl"><span class="s">enabled = 1
</span></span></span><span class="line"><span class="cl"><span class="s">priority = 1
</span></span></span><span class="line"><span class="cl"><span class="s">gpgcheck = 1
</span></span></span><span class="line"><span class="cl"><span class="s">gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-pigsty
</span></span></span><span class="line"><span class="cl"><span class="s">module_hotfixes=1
</span></span></span><span class="line"><span class="cl"><span class="s">EOF</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># 刷新 YUM/DNF 仓库缓存</span>
</span></span><span class="line"><span class="cl">sudo yum makecache<span class="p">;</span></span></span></code></pre></div></div>
</div>


---------

## 源代码

此仓库的构建脚本与源代码在 GitHub 上开源：

- https://github.com/pgsty/rpm
- https://github.com/pgsty/deb

如果平台不受支持，您也可以自行从源代码构建软件包。

[`pig build`](/docs/pig/build/) 提供了简便的扩展构建基础设施，您可以方便地在自己的系统上制作 RPM/DEB 包。




---------

## 兼容性

|   系统 / 架构    |  代码  |            x86_64            |           aarch64            |
|:------------:|:----:|:----------------------------:|:----------------------------:|
|     EL8      | el8  | `18`, `17`, `16`, `15`, `14` | `18`, `17`, `16`, `15`, `14` |
|     EL9      | el9  | `18`, `17`, `16`, `15`, `14` | `18`, `17`, `16`, `15`, `14` |
|     EL10     | el10 | `18`, `17`, `16`, `15`, `14` | `18`, `17`, `16`, `15`, `14` |
|  Debian 12   | d12  | `18`, `17`, `16`, `15`, `14` | `18`, `17`, `16`, `15`, `14` |
|  Debian 13   | d13  | `18`, `17`, `16`, `15`, `14` | `18`, `17`, `16`, `15`, `14` |
| Ubuntu 22.04 | u22  | `18`, `17`, `16`, `15`, `14` | `18`, `17`, `16`, `15`, `14` |
| Ubuntu 24.04 | u24  | `18`, `17`, `16`, `15`, `14` | `18`, `17`, `16`, `15`, `14` |
| Ubuntu 26.04 | u26  | `18`, `17`, `16`, `15`, `14` | `18`, `17`, `16`, `15`, `14` |
{.full-width}

---

Section pages:

- [DNF 变更日志](/docs/repo/pgsql/rpm/): PostgreSQL 和扩展 RPM 包变更日志和发布说明
- [APT 变更日志](/docs/repo/pgsql/deb/): PostgreSQL 和扩展 DEB 包变更日志和发布说明
