下载 PG Exporter

长期运行的 Linux 主机推荐这条路径：APT/YUM 升级、systemd 单元、合并后的采集器配置与 /etc/default/pg_exporter 作为一个受管整体交付。

sudo tee /etc/apt/sources.list.d/pigsty-infra.list > /dev/null <<'EOF'
deb [trusted=yes] https://repo.pigsty.io/apt/infra generic main
EOF

sudo apt update
sudo apt install -y pg-exporter

sudo tee /etc/yum.repos.d/pigsty-infra.repo > /dev/null <<'EOF'
[pigsty-infra]
name=Pigsty Infra for $basearch
baseurl=https://repo.pigsty.io/yum/infra/$basearch
enabled=1
gpgcheck=0
module_hotfixes=1
EOF

sudo yum makecache
sudo yum install -y pg-exporter

# PG_EXPORTER_URL='postgres://[email protected]:5432/postgres?sslmode=disable'
sudoedit /etc/default/pg_exporter

sudo systemctl enable --now pg_exporter
curl -fsS http://127.0.0.1:9630/up

适用于离线交付或需要逐级晋级的流水线，安装的 systemd 单元与默认参数与仓库软件包完全一致。

RPM / DEB

ARCH=amd64
curl -fLO "https://github.com/pgsty/pg_exporter/releases/download/v1.4.1/pg-exporter_1.4.1-1_$ARCH.deb"
sudo apt install "./pg-exporter_1.4.1-1_$ARCH.deb"

ARCH=$(uname -m)
curl -fLO "https://github.com/pgsty/pg_exporter/releases/download/v1.4.1/pg-exporter-1.4.1-1.$ARCH.rpm"
sudo dnf install "./pg-exporter-1.4.1-1.$ARCH.rpm"

免安装器的二进制，适合 CI、macOS、Windows 以及由你自己定义服务的主机。Linux 提供 amd64、arm64 与 ppc64le，macOS 提供 amd64 与 arm64，Windows 提供 amd64。

OS=linux ARCH=amd64
ARCHIVE="pg_exporter-1.4.1.$OS-$ARCH.tar.gz"

curl -fLO "https://github.com/pgsty/pg_exporter/releases/download/v1.4.1/$ARCHIVE"
mkdir -p stage && tar -xzf "$ARCHIVE" -C stage
sudo install -m 0755 stage/pg_exporter /usr/local/bin/pg_exporter
sudo install -m 0644 stage/pg_exporter.yml /etc/pg_exporter.yml

pg_exporter --version

curl -fLO "https://github.com/pgsty/pg_exporter/releases/download/v1.4.1/checksums.txt"
sha256sum -c checksums.txt --ignore-missing

多架构 amd64/arm64 镜像。它基于 scratch 构建，只包含静态二进制、合并配置与许可证，没有 shell 也没有系统 CA 证书；使用 verify-full 时请显式挂载 CA。

容器

docker run -d \
  --name pg_exporter \
  --restart unless-stopped \
  -p 127.0.0.1:9630:9630 \
  -e PG_EXPORTER_URL='postgres://monitor:S3cret@postgres:5432/postgres' \
  pgsty/pg_exporter:1.4.1

curl -fsS http://127.0.0.1:9630/up

docker run -d \
  --name pg_exporter \
  --restart unless-stopped \
  -p 127.0.0.1:9630:9630 \
  -e PG_EXPORTER_URL_FILE=/run/secrets/pgurl \
  -v ./pgurl:/run/secrets/pgurl:ro \
  -v ./pg_exporter.yml:/etc/pg_exporter.yml:ro \
  pgsty/pg_exporter:1.4.1

集成路径：PG Exporter 随 PostgreSQL 发行版、Prometheus 兼容存储、记录与告警规则以及 Grafana 仪表盘一同交付。引导脚本只负责取得 Pigsty，请先选定清单再对主机执行。

Pigsty

curl -fsSL https://repo.pigsty.io/get | bash
cd ~/pigsty

适用于审计、二次开发与自定义构建参数。源码构建不会创建服务账号，也不会注册系统服务；如果需要这些控制，请自行显式实现。

源码

git clone https://github.com/pgsty/pg_exporter.git
cd pg_exporter
git checkout "v1.4.1"
make build

./pg_exporter --version
PG_EXPORTER_URL='postgres://[email protected]:5432/postgres' ./pg_exporter --dry-run

发布中的每个文件及其 SHA-256 摘要。在 macOS 上使用 shasum -a 256 <文件> 与对应条目比对。

全部产物

`.rpm`

下载资产
文件	校验和
pg-exporter-1.4.1-1.aarch64.rpm Linuxarm64SHA-256	`7648f1852f12a17c5ecc9c2f6aed1888f443d6e650c5001f9c8a05d7e4822f13`
pg-exporter-1.4.1-1.ppc64le.rpm LinuxSHA-256	`09037731e2d4bd22dcabb9a386f381c67a782a05a0f9ed54517312d7ea8e6631`
pg-exporter-1.4.1-1.x86_64.rpm Linuxamd64SHA-256	`8dbf85ff6adc4b46b225b3a1e3be5a4a61130118eabee499865a88d04a3e1a93`

`.deb`

下载资产
文件	校验和
pg-exporter_1.4.1-1_amd64.deb Linuxamd64SHA-256	`cbe06eb161421a160d07b8c757864919d2ce1717b402630906235c471e411f38`
pg-exporter_1.4.1-1_arm64.deb Linuxarm64SHA-256	`36bc07ef2e3189b2acef06cf602ec9800ad6dc8b619ab5b2bfa5f900d9975cff`
pg-exporter_1.4.1-1_ppc64le.deb LinuxSHA-256	`8228e6a9b73d68aafedf6b4ed795636b9528c254052709086de4fa5084707aad`

`.tar.gz`

下载资产
文件	校验和
pg_exporter-1.4.1.darwin-amd64.tar.gz macOSamd64SHA-256	`e6de4c890af8d1c54b4a597e9fd02329e9caa543604c8406270a7a3c842d76f4`
pg_exporter-1.4.1.darwin-arm64.tar.gz macOSarm64SHA-256	`6fe0b19398983587fbe5e9a31dd8de0aeaf03b6b91a6fe22fc71f63ba703a79f`
pg_exporter-1.4.1.linux-amd64.tar.gz Linuxamd64SHA-256	`f2f952dbcf1ae09027bcee4ea4921d2b34f9f58ffbc7e3a2d42113f2cc94a340`
pg_exporter-1.4.1.linux-arm64.tar.gz Linuxarm64SHA-256	`e111974a12175d5f65c4ee0fb888604e6b343d893476ef4e88264a4c9601e8b4`
pg_exporter-1.4.1.linux-ppc64le.tar.gz LinuxSHA-256	`7b8679de0d58373f5f570c0560125fb465f91e7a4d71223699e81c9ca6b84469`
pg_exporter-1.4.1.windows-amd64.tar.gz Windowsamd64SHA-256	`93c0231fbd3eae45604b0c723cf413b2bec5e0cfa652912b12fdf400f1761db4`

安装 PG Exporter

挑选与主机匹配的路径

`.rpm`

`.deb`

`.tar.gz`

从这里继续

生产部署

采集器配置

HTTP API

安装参考

兼容性矩阵

发布归档