直接安装 borgbackup 无需编译，主流发行版均支持：ubuntu/debian 用 apt（需先 update），centos/rhel 等需启用 epel 源，arch 用 pacman，也可下载 github 官方二进制文件；安装后须检查环境变量避免冲突。
直接装就行，不用编译、不依赖特殊环境，主流发行版都自带包。
Ubuntu/Debian 系统用 apt 装
执行这两条命令：
sudo apt update sudo apt install borgbackup
装完运行 borg --version 能看到版本号就说明成功了。注意别漏掉 update，否则可能装到旧版本（比如 Ubuntu 22.04 默认源里还是 1.1.x，而最新稳定版已是 1.2.9+）。
CentOS/RHEL/AlmaLinux 用 dnf 或 yum
先确保 EPEL 源已启用：
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
一条命令搞定：
sudo pacman -S borgbackup
Arch 用户一般不会遇到依赖问题，但要注意：如果系统长期未更新（pacman -Syu 没跑过），可能因 glibc 或 python 版本不匹配导致 borg 启动报错，典型错误是 ImportError: cannot import name 'ABC' from 'collections'。此时不是 Borg 本身的问题，而是 Python 标准库变动引起的兼容性断裂，必须先升级系统。
不想用包管理器？下载二进制文件
适用于无法联网、或需要指定版本的场景（比如要 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 时静默失败，错误还不明显。
