下载与安装

官方发布、系统软件包、运行要求与源码安装方法

选择分发渠道

本站文档快照基于 13.2 源码树。下载前始终应查看发布页面：本地快照为了可复现而固定，上游版本仍会继续更新。

生成与查看 HTML 报告只需要：

下列可选功能需要额外依赖：

功能	依赖
解析 PostgreSQL CSV 日志	`Text::CSV_XS`
生成 JSON 输出	`JSON::XS`
读取 `.gz`、`.bz2`、`.lz4`、`.xz`、`.zip` 或 `.zst` 输入	对应的 `zcat`、`bzcat`、`lz4cat`、`xz`、`unzip` 或 `zstdcat` 工具

在 Debian 或 Ubuntu 上安装 JSON 支持：

$ sudo apt-get install libjson-xs-perl

在基于 RPM 的系统上：

$ sudo yum install perl-JSON-XS

可通过 --zcat 指定解压程序路径。显式指定一个自定义命令后，同一次调用将不能再混合处理多种压缩格式。

下载版本归档后，使用 Perl 的标准工具链构建并安装：

$ tar xzf pgbadger-13.2.tar.gz
$ cd pgbadger-13.2
$ perl Makefile.PL
$ make
$ sudo make install

默认的 site 布局会把程序安装为 /usr/local/bin/pgbadger，把手册页安装为 /usr/local/share/man/man1/pgbadger.1。

若要按 Linux 发行版惯例安装到 /usr，可这样生成 Makefile：

$ perl Makefile.PL INSTALLDIRS=vendor
$ make
$ sudo make install

上游也支持 INSTALLDIRS=perl 布局。向受包管理器管理的系统安装前，应先检查生成的目标路径。

$ git clone https://github.com/darold/pgbadger.git
$ cd pgbadger
$ perl Makefile.PL
$ make
$ make test
$ sudo make install

开发分支可能包含尚未进入正式版本说明的改动。生产打包应优先使用带标签的发布归档，以保证可复现性。

$ pgbadger --version
$ pgbadger --help