下载与安装

选择分发渠道

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

运行要求

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

• 一套现代 Perl 发行版；
• 一个可运行内嵌 JavaScript 图表的浏览器。

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

在 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

接下来请阅读命令行参考 与 PostgreSQL 日志配置 。