在 Linux 上安装 Percona Toolkit

Percona Toolkit 的官方支持平台是 Linux。推荐从 Percona 软件仓库安装，仓库会自动处理 Perl、DBI、DBD::mysql 等依赖。本文给出三种方式：仓库安装（推荐）、手动下载包安装、源码编译安装。

安装前的准备

• 需要 sudo 或 root 权限（或容器内的 root）。
• 需要能访问外网，以下载仓库元数据和软件包。
• 工具运行依赖 Perl 解释器、DBI 与 DBD::mysql 模块；通过仓库安装时会作为依赖自动装上，无需手动处理。
• 本文命令中的包版本号（如 3.5.1）为示例，实际安装时请替换为 Percona 下载页 上的最新版本号。

方式一：通过 Percona 仓库安装（推荐）

先用 percona-release 配置工具把 Percona 仓库写入系统的包管理器源，再启用 Percona Toolkit 子仓库并安装。

Debian / Ubuntu

1. 下载并安装 percona-release 配置包：

   wget https://repo.percona.com/apt/percona-release_latest.generic_all.deb
   sudo dpkg -i percona-release_latest.generic_all.deb

2. 刷新软件包索引：

   sudo apt-get update

3. 启用 Percona Toolkit 仓库：

   sudo percona-release enable pt release

4. 安装 Percona Toolkit：

   sudo apt-get install percona-toolkit

RHEL / CentOS / Rocky / AlmaLinux

1. 安装 percona-release 配置包（RHEL 7 及 CentOS 7 用 yum，RHEL 8+/CentOS 8+ 推荐用 dnf）：

   sudo yum install https://repo.percona.com/yum/percona-release-latest.noarch.rpm

   RHEL 8 或 CentOS 8 及以上：

   sudo dnf install https://repo.percona.com/yum/percona-release-latest.noarch.rpm

2. 启用 Percona Toolkit 仓库：

   sudo percona-release enable pt release

3. 安装 Percona Toolkit：

   sudo yum install percona-toolkit

   使用 dnf 的系统把上一条命令中的 yum 换成 dnf 即可：

   sudo dnf install percona-toolkit

方式二：下载软件包手动安装

如果不便配置仓库，可以从 Percona 网站直接下载对应发行版的 .deb 或 .rpm 包，再用系统包管理器安装。

Debian / Ubuntu（.deb）

下载指定发行版的包（以下以 Debian 11 "bullseye" 为例）：

wget https://downloads.percona.com/downloads/percona-toolkit/3.5.1/binary/debian/bullseye/x86_64/percona-toolkit_3.5.1-2.bullseye_amd64.deb

用 dpkg 安装，缺失依赖时再用 apt-get -f install 补齐：

sudo dpkg -i percona-toolkit_3.5.1-2.bullseye_amd64.deb
sudo apt-get -f install

RHEL / CentOS（.rpm）

下载 .rpm 包后用 rpm 或 yum/dnf 安装（包管理器会自动解析依赖）：

wget https://downloads.percona.com/downloads/percona-toolkit/3.5.1/binary/redhat/8/x86_64/percona-toolkit-3.5.1-2.el8.x86_64.rpm
sudo yum install ./percona-toolkit-3.5.1-2.el8.x86_64.rpm

如果只想单独下载某个工具，可以使用短链接 http://www.percona.com/get。例如下载 pt-summary：

wget percona.com/get/pt-summary

方式三：从源码 / tar.gz 安装

适合无法使用包管理器的环境。先安装编译依赖（Perl、DBI、DBD::mysql、make 等），再解压官方 tar.gz 源码包编译安装：

wget https://downloads.percona.com/downloads/percona-toolkit/3.5.1/source/tarball/percona-toolkit-3.5.1.tar.gz
tar -xzf percona-toolkit-3.5.1.tar.gz
cd percona-toolkit-3.5.1
perl Makefile.PL
make
sudo make install

注意

从 tar.gz 源码包直接运行工具时，安装程序不会写入实例 UUID，每个运行实例都会生成一个随机 UUID（详见 安装概述 - 实例 UUID）。如果需要稳定的实例标识，建议优先使用仓库或包安装。

验证安装

任意一条命令能正常输出版本号即表示安装成功：

pt-summary --version
pt-query-digest --version

查看已安装的全部工具（默认装在 /usr/bin）：

ls /usr/bin/pt-*

能连接数据库时，可运行 pt-mysql-summary 生成一份服务器状态报告，确认工具链完整可用。

更多细节请阅读 官方文档。