Linux安装BorgBackup备份工具完整详细操作步骤与注意事项

在 Linux 系统上安装 BorgBackup 这款强大的备份工具比想象中更简单，无需手动编译或处理复杂的依赖关系。主流 Linux 发行版大多已通过官方软件源提供现成安装包。接下来，我们将逐一介绍不同操作系统下的具体部署步骤。

在 Ubuntu/Debian 系统上使用 apt 安装 BorgBackup

两条命令即可完成：

sudo apt update
sudo apt install borgbackup

安装完毕后，运行 borg --version 如果能看到版本号，就说明安装成功。请务必先执行 update 更新软件包索引，否则可能安装到旧版本——比如 Ubuntu 22.04 默认源中仍是 1.1.x，而最新稳定版已是 1.2.9 以上，版本差距较大。

在 CentOS/RHEL/AlmaLinux 上使用 dnf 或 yum 安装 BorgBackup

首先确保 EPEL（Extra Packages for Enterprise Linux）源已启用：

sudo dnf install epel-release -y
sudo dnf install borgbackup -y

对于 CentOS 7 等较老的系统，可能没有 dnf 命令，此时应改用 yum：

sudo yum install epel-release -y
sudo yum install borgbackup -y

安装完成后，运行 borg --help 应该能正常输出帮助信息。实际运维中最常见的安装失败原因就是 EPEL 源未启用，导致系统找不到 borgbackup 软件包。

在 Arch Linux 及其衍生版上使用 pacman 安装 BorgBackup

一条命令就能搞定：

sudo pacman -S borgbackup

Arch 用户通常不会遇到依赖问题，但有一个常见陷阱需要留意：如果系统长时间没有执行 pacman -Syu 更新，可能因为 glibc 或 Python 版本不匹配导致 borg 启动时报错。典型错误信息为 ImportError: cannot import name 'ABC' from 'collections'。这并非 Borg 本身的问题，而是 Python 标准库变更引发的兼容性问题，解决办法是先升级整个系统。

不想使用包管理器？直接下载 BorgBackup 二进制文件

适用于无法联网、或需要特定版本的场景（例如要 v1.2.9 修复某个已知 bug）：

• 前往 GitHub Releases 页面，根据系统架构下载对应的 borg-linux64 文件
• 赋予可执行权限：chmod +x borg-linux64
• 将文件移动到 PATH 路径中：sudo mv borg-linux64 /usr/local/bin/borg

这种安装方式绕过了包管理器的依赖校验，需要注意两点：一是二进制文件依赖系统的 glibc 版本——CentOS 7 的 glibc 较旧，可能无法运行较新版本的 Borg 二进制文件；二是某些极简容器镜像（如 distroless）缺少 libc 库，也会导致启动失败。

安装完成后，不要急于初始化仓库（init repo）。请先检查 shell 环境中是否定义了冲突的环境变量，例如 BORG_REPO 或 BORG_PASSPHRASE。这些旧值会在后续执行 create 或 init 命令时导致静默失败，错误信息不明显，排查起来颇为耗时。