Debian 13 安装 Proxmox Backup Server 4.2 指南

目标：在 Debian 13 (trixie) 服务器上从零安装 Proxmox Backup Server（PBS）4.2 稳定版，完成官方仓库配置、软件包安装、systemd 服务托管、datastore 初始化与 Web 管理台验证，并给出官方 ISO 裸机安装的备用方案、Ubuntu 宿主机的兼容性差异实测与升级/卸载方法。全部命令与回显已在 Debian 13（trixie）+ proxmox-backup-server 4.2.8-1 环境逐条实测通过。

一、环境信息

本文实测环境与关键参数如下：

操作系统：Debian GNU/Linux 13 (trixie)，x86_64（实测 cat /etc/debian_version 返回 13.7）
软件版本：proxmox-backup-server 4.2.8-1（官方 pbs-no-subscription 免费仓库最新包）；proxmox-backup-client 4.2.8-1
管理端口：TCP 8007（HTTPS，Web 管理台与 API/备份协议共用）
服务单元：proxmox-backup（内部 API）、proxmox-backup-proxy（Web/API 网关）
配置目录：/etc/proxmox-backup/；证书文件 proxy.pem/proxy.key
datastore 独立目录：/datastore（生产环境建议为独立磁盘上的 ZFS/XFS 文件系统挂载点；本文实测挂在独立数据盘）
演示账号：root@pam，密码 q1w2e3r4（文档演示用固定测试口令）

cat /etc/os-release | head -3 && cat /etc/debian_version

实测回显：

PRETTY_NAME="Debian GNU/Linux 13 (trixie)"
NAME="Debian GNU/Linux"
VERSION_ID="13"
13.7

二、前置条件

64 位 Debian 13 (trixie) 系统：PBS 4.x 与 Debian 13 配套（官方口径：可在裸机 ISO 安装，或安装在「已有 Debian 13」系统上）。Debian 12 (bookworm) 对应 PBS 3.x 系。
独立的备份存储：为 datastore 准备一块独立磁盘或分区（推荐 ZFS 或 XFS），格式化并挂载为独立目录（本文用 /datastore）。动工前先确认磁盘余量：
```
df -h /datastore | tail -1
```
实测回显（数据盘 786 GB，余量充足）：
```
/dev/sda3       786G  268G  484G  36% /datastore
```
网络可达官方仓库：download.proxmox.com（免费仓库）与 enterprise.proxmox.com（GPG key 下载）。内网受限时可走 HTTP 代理，apt 代理配置见 FAQ。
端口 8007 未被占用：安装前复核：
```
ss -ltn | grep 8007 || echo "8007 空闲"
```
实测回显：
```
8007 空闲
```
root 权限：以下命令均以 root 执行。

三、版本选型说明

安装目标	对应 PBS 稳定分支	Debian 基线	软件包仓库 suite	本文是否实测
PBS 4.2（最新稳定）	4.2.x	Debian 13 (trixie)	`trixie`	✅（主线实测）
PBS 3.4（上一稳定，延伸维护）	3.4.x	Debian 12 (bookworm)	`bookworm`	❌（同一套流程，替换 suite 名）

生产环境建议直接用 4.2.x 稳定分支：新装无历史包袱，4.2 带来 S3 后端、同步加密、并发同步等特性（官方 4.2 发布公告）。
已有 Debian 12 且不便升级：按本文流程把 trixie 全部替换为 bookworm 即可安装 3.4 分支。

四、方案 A：在已有 Debian 13 上以 apt 包安装（推荐，本文实测主线）

4.1 方案说明

官方支持把 PBS 直接安装在「已有的 Debian 13」上：添加 Proxmox 官方 apt 仓库后，用普通 apt-get install 完成，软件以系统包形态交付，服务由 systemd 托管。适合「已有 Debian 系统不想重装」的场景。

4.2 安装依赖与下载 GPG key

先确保 curl 可用，并下载 Proxmox 的仓库签名 key（来自官方安装文档的 proxmox-release-trixie.gpg）：

apt-get install -y curl
curl -fsSL https://enterprise.proxmox.com/debian/proxmox-release-trixie.gpg \
  -o /etc/apt/trusted.gpg.d/proxmox-release-trixie.gpg
ls -l /etc/apt/trusted.gpg.d/proxmox-release-trixie.gpg

实测回显：

-rw-r--r-- 1 root root 1185 Oct 19 09:20 /etc/apt/trusted.gpg.d/proxmox-release-trixie.gpg

4.3 配置官方仓库（含仓库布局报错排障）

⚠️ 排障实录：不要照抄旧文章的仓库格式。 PBS 4.x 时代 Proxmox 改用了组件式仓库布局。若按旧格式（debian/trixie + pbs-no-subscription 组件）配置，apt-get update 会报错：

Err:7 http://download.proxmox.com/debian/trixie pbs-no-subscription Release
E: The repository 'http://download.proxmox.com/debian/trixie pbs-no-subscription Release' does not have a Release file.

正确的 4.x 仓库布局是 download.proxmox.com/debian/pbs，suite 为 trixie，组件名为 pbs-no-subscription。写入仓库定义：

# 客户端仓库（为其他主机安装 proxmox-backup-client 预备）
echo "deb http://download.proxmox.com/debian/pbs-client trixie main" \
  > /etc/apt/sources.list.d/pbs-client.list
# 服务端仓库（4.x 新布局）
echo "deb http://download.proxmox.com/debian/pbs trixie pbs-no-subscription" \
  > /etc/apt/sources.list.d/pbs.list
cat /etc/apt/sources.list.d/pbs.list

实测回显：

deb http://download.proxmox.com/debian/pbs trixie pbs-no-subscription

⚠️ 注意：组件名就是 pbs-no-subscription，行尾不要再写 main。多写 main 会得到警告 Skipping acquire of configured file 'main/binary-amd64/Packages' ... doesn't have the component 'main'（实测出现过），虽不阻断安装但属于配置错误。

刷新索引并确认候选版本：

apt-get update
apt-cache policy proxmox-backup-server | head -6

实测回显（节选）：

Get:5 http://download.proxmox.com/debian/pbs trixie InRelease [2785 B]
Get:6 http://download.proxmox.com/debian/pbs trixie/pbs-no-subscription amd64 Packages [223 kB]
Fetched 226 kB in 3s (80.9 kB/s)
proxmox-backup-server:
  Installed: (none)
  Candidate: 4.2.8-1
  Version table:
     4.2.8-1 500
        500 http://download.proxmox.com/debian/pbs trixie/pbs-no-subscription amd64 Packages

4.4 安装 proxmox-backup-server

DEBIAN_FRONTEND=noninteractive apt-get install -y proxmox-backup-server

实测回显（尾部节选，包安装过程约 1-2 分钟，会自动拉取 proxmox-kernel、ZFS、postfix 等依赖包）：

Setting up proxmox-backup-server (4.2.8-1) ...
Created symlink '/etc/systemd/system/timers.target.wants/proxmox-backup-daily-update.timer' → '/usr/lib/systemd/system/proxmox-backup-daily-update.timer'.
Created symlink '/etc/systemd/system/sysinit.target.wants/pbs-network-config-commit.service' → '/usr/lib/systemd/system/pbs-network-config-commit.service'.
Created symlink '/etc/systemd/system/getty.target.wants/proxmox-backup-banner.service' → '/usr/lib/systemd/system/proxmox-backup-banner.service'.
Created symlink '/etc/systemd/system/multi-user.target.wants/proxmox-backup-proxy.service' → '/usr/lib/systemd/system/proxmox-backup-proxy.service'.
Created symlink '/etc/systemd/system/multi-user.target.wants/proxmox-backup.service' → '/usr/lib/systemd/system/proxmox-backup.service'.
Processing triggers for libc-bin (2.41-12+deb13u4) ...
Processing triggers for postfix (3.10.13-0+deb13u1) ...

可以看到安装器已把 proxmox-backup.service 与 proxmox-backup-proxy.service 注册进 multi-user.target（systemd 托管完成）。标准裸机 Debian 上两服务会在安装完成后自动启动；若系统里有 policy-rc.d 拦截（如最小化系统/chroot 环境），安装期不会自动启动，实测环境即出现该拦截日志 policy-rc.d returned 101, not running 'start proxmox-backup.service proxmox-backup-proxy.service'，此时手动启动即可（见 4.5）。

4.5 启动服务（systemd 托管）

逐个启动并设置开机自启（每行仅针对一个服务单元）：

systemctl enable proxmox-backup.service
systemctl enable proxmox-backup-proxy.service
systemctl start proxmox-backup.service
systemctl start proxmox-backup-proxy.service

验证服务状态与端口监听：

systemctl is-active proxmox-backup
systemctl is-active proxmox-backup-proxy
ss -ltn | grep 8007

实测回显：

active
active
LISTEN 0      1024               *:8007            *:*

4.6 验证安装版本与 Web 管理台

proxmox-backup-manager version
curl -sk -o /dev/null -w "HTTP状态码: %{http_code}\n" https://localhost:8007

实测回显：

proxmox-backup-server 4.2.8-1 running version: 4.2.8
HTTP状态码: 200

浏览器访问 https://<服务器IP>:8007（自签证书需点击「继续访问」），用 root@pam 登录：

# 包安装方式下，root@pam 的 PBS 密码需单独设置（与系统 root 密码相互独立）
proxmox-backup-manager user update root@pam --password q1w2e3r4

实测回显：命令无输出即成功（可用 Web 登录验证）。

⚠️ 注意：PBS 的用户密码保存在 /etc/proxmox-backup/shadow.json，与 Linux 系统的 /etc/shadow 是两套独立凭据。官方 ISO 安装会在向导里设置；包安装方式必须用上面的命令补设，否则 Web 无法登录（实测教训：只改系统 root 密码时，API 返回 authentication failed）。

4.7 初始化 datastore

datastore 必须建立在独立目录（独立磁盘的挂载点）上。创建名为 pbs-demo、路径 /datastore 的 datastore：

proxmox-backup-manager datastore create pbs-demo /datastore

实测回显（去重块库初始化进度）：

Chunkstore create: 1%
Chunkstore create: 2%
...
Chunkstore create: 99%
Access time update check successful.
TASK OK

确认创建结果：

proxmox-backup-manager datastore list

实测回显：

+==========+============+=========+
| name     | path       | comment |
+==========+============+=========+
| pbs-demo | /datastore |         |
+==========+============+=========+

💡 说明：datastore create 会初始化 .chunks 去重块存储目录并注册到 /etc/proxmox-backup/datastore.cfg。生产环境应把 /datastore 放在独立 ZFS/XFS 文件系统上，避免与系统盘争用 IO、避免去重存储随系统重装丢失。

至此方案 A 完成：服务 active、8007 监听、Web 200、datastore 就绪。

五、方案 B：官方 ISO 裸机安装（备选）

5.1 方案说明

官方提供自带安装向导的 ISO 安装文件（当前 4.2-1，1.48 GB），把 PBS 作为独立操作系统安装到裸机，基于 Debian 13.4 + 内核 7.0。适合「专用备份服务器」场景，也是官方最推荐的交付形态。

5.2 下载与校验

从官方下载页获取 ISO 与 SHA256 值（官方 Downloads 页实查：proxmox-backup-server_4.2-1.iso，SHA256 前缀 2fb299deac3929253712c9c3dfc9237ed...）：

# 下载（内网走代理时加 -x）
wget -x http://192.168.1.62:7897 https://download.proxmox.com/iso/proxmox-backup-server_4.2-1.iso
sha256sum proxmox-backup-server_4.2-1.iso

⚠️ 注意：本节为官方流程转述（认知性步骤），本文实测环境采用方案 A，未对 ISO 做装机实测；SHA256 完整值以官方下载页当日公布的为准。

5.3 安装向导流程（官方口径）

将 ISO 写入 U 盘（dd 或 Rufus/Ventoy），从 U 盘引导；
安装向导依次确认：目标磁盘（支持 ext4/XFS/ZFS RAID0/1/10 文件系统选择）、国家时区、root 密码与邮箱、网络（网卡/IP/网关/DNS）；
安装完成后重启，Web 管理台在 https://<安装时设置的IP>:8007，用向导中设置的 root 密码登录；
首次登录后在 Web 的 Administration → Storage 或命令行 proxmox-backup-manager datastore create 创建 datastore（ISO 安装时选择的文件系统即为推荐的数据盘）。

⚠️ 注意：ISO 安装会清空目标磁盘，动工前确认磁盘上无其他数据；企业仓库（enterprise）在 ISO 安装后默认启用，无订阅时需按 FAQ 8.1 禁用，否则 apt update 报签名错误。

六、方案对比与选择建议

维度	方案 A：apt 包安装	方案 B：官方 ISO
适用场景	已有 Debian 13 服务器复用	专用备份机从零装机
操作系统	保留现有 Debian 13	内置 Debian 13.4 专用系统
安装介质	官方 apt 仓库	ISO（1.48 GB）
systemd 服务	同一套（proxmox-backup / proxmox-backup-proxy）	同一套
datastore	自行准备独立目录/文件系统	安装向导分配（可选 ZFS）
root 密码	需用 manager 命令补设 PBS 密码	向导中一次设置
卸载/回退	apt purge 即可，系统保留	重装系统

选择建议：能联网且有现成 Debian 13 → 方案 A（本文实测主线，回退成本低）；新购/专用备份机 → 方案 B（官方推荐形态，向导把系统+存储一次配好）。

七、Ubuntu 宿主机的官方口径与兼容性差异（实测）

7.1 官方口径

PBS 官方支持的安装方式是：官方 ISO 裸机安装，或安装在已有 Debian 上。Ubuntu 不在官方支持矩阵内（官方公告与文档仅给出 Debian 安装路径，proxmox-backup-server 包基于 Debian glibc 与 Debian 特有包构建）。

7.2 Ubuntu 22.04 上直接安装的依赖差异（实测）

在 Ubuntu 22.04.4 LTS（jammy，glibc 2.35）上添加官方 pbs-client 仓库（bookworm）后，模拟安装 proxmox-backup-client（apt-get install -s）依赖解析失败，实测报错：

E: 无法修正错误，因为您要求某些软件包保持现状，就是它们破坏了软件包间的依赖关系。

对照官方包索引取证根因（download.proxmox.com/debian/pbs-client/dists/.../binary-amd64/Packages）：

依赖项	Ubuntu 22.04 实测版本	仓库要求（trixie 4.2.8-1）	结论
libc6	2.35-0ubuntu3.15	>= 2.39	❌ 不满足
libfuse3-4	未安装（jammy 只有 libfuse3-3 3.10.5）	>= 3.17.2	❌ 包名与版本均不满足
libssl3t64	未安装（jammy 只有 libssl3）	>= 3.0.0	❌ t64 包名不存在
libzstd1	1.4.8+dfsg-3build1	>= 1.5.5	❌ 不满足（bookworm 线同样要求 >= 1.5.2）

结论：Ubuntu 宿主机不能按官方仓库直接安装 PBS 服务端/动态客户端，强行加仓库只会得到依赖破坏错误。

7.3 Ubuntu 上可用的官方替代：静态链接客户端（实测可用）

官方 pbs-client 仓库同时提供静态链接的客户端包 proxmox-backup-client-static，其依赖清单只有一个 qrencode，在 Ubuntu 22.04 上可以正常安装（实测）：

# Ubuntu 上添加 pbs-client 仓库（trixie）后：
apt-get install -y proxmox-backup-client-static
proxmox-backup-client version

实测回显：

正在设置 proxmox-backup-client-static (4.2.8-1) ...
client version: 4.2.8

并用该客户端对 Debian 上的 PBS 服务端完成了一次跨机备份实测（客户端在 Ubuntu，服务端在 Debian，目标 10.0.0.9:8007）：

No previous manifest available.
Upload directory '/tmp/pbs-client-demo' to 'root@pam@10.0.0.9:8007:pbs-demo' as root.pxar.didx
root.pxar: had to backup 32 MiB of 32 MiB (compressed 1.306 KiB) in 0.07 s (average 441.896 MiB/s)
Uploaded backup catalog (73 B)
Duration: 0.43s
End Time: Mon Oct 19 17:40:16 2026

7.4 Ubuntu 场景结论

服务端：放弃在 Ubuntu 上装，用 Debian 13 裸机/ISO 或已有 Debian 装机（官方口径）；
客户端：Ubuntu 上用官方 proxmox-backup-client-static（实测 4.2.8-1 可用，可跨机备份到 PBS 服务端）；
其余被保护主机（CentOS/Rocky 等）同理优先 static 客户端，或按官方文档从源码构建。

八、升级与版本管理

8.1 常规升级（同大版本内滚动更新）

apt-get update
apt-get install --only-upgrade proxmox-backup-server
proxmox-backup-manager version

实测回显（已是最新版时）：

proxmox-backup-server is already the newest version (4.2.8-1).
0 upgraded, 0 newly installed, 0 to remove and 3 not upgraded.
proxmox-backup-server 4.2.8-1 running version: 4.2.8

💡 说明：升级过程会自动重启 proxmox-backup/proxmox-backup-proxy 两个服务，运行中的备份任务建议避开升级窗口。官方公告明确：跨大版本（如 3.4 → 4.2）也可用标准 APT 完成「无缝发行版升级」，但跨版本前务必阅读官方发行说明并完成全量备份。

8.2 锁定版本（可选）

生产环境在验证窗口内可临时锁定版本，避免自动更新：

apt-mark hold proxmox-backup-server   # 锁定
apt-mark unhold proxmox-backup-server # 解锁

九、常见问题（FAQ）

Q1：apt update 报 E: The repository 'https://enterprise.proxmox.com/debian/pbs trixie InRelease' is not signed.

包安装时自带了企业仓库文件（/etc/apt/sources.list.d/pbs-enterprise.sources），无订阅 key 访问企业仓库即报此错（实测复现）。处理：禁用企业仓库，保留免费仓库：

mv /etc/apt/sources.list.d/pbs-enterprise.sources /etc/apt/sources.list.d/pbs-enterprise.sources.disabled
apt-get update

实测确认：禁用后 apt-get update 的 E: 错误计数为 0。

Q2：apt-get update 报仓库 does not have a Release file。

按旧文章把仓库写成了 deb http://download.proxmox.com/debian/trixie pbs-no-subscription main（旧布局）。PBS 4.x 的新布局见 4.3 节：URL 为 download.proxmox.com/debian/pbs，suite trixie，组件 pbs-no-subscription，行尾不加 main。

Q3：Web 登录 authentication failed，但系统 root 密码是对的。

PBS 凭据与系统密码独立（shadow.json vs /etc/shadow）。包安装后必须执行 proxmox-backup-manager user update root@pam --password <密码> 设置 PBS 密码（见 4.6）。

Q4：内网环境 apt 走代理。

echo 'Acquire::http::Proxy "http://192.168.1.62:7897";' > /etc/apt/apt.conf.d/95proxy
echo 'Acquire::https::Proxy "http://192.168.1.62:7897";' >> /etc/apt/apt.conf.d/95proxy

实测该代理可用（本文 GPG key 下载即走代理完成）。

Q5：安装日志出现 policy-rc.d returned 101, not running 'start ...'。

系统存在 /usr/sbin/policy-rc.d 拦截了安装期的服务自启（最小化系统常见）。不影响安装结果，按 4.5 节手动 systemctl start 即可。

Q6：datastore create 报路径不可写或权限错误。

datastore 目录必须存在且归备份服务可写，且建议为独立文件系统挂载点。确认 df -h /datastore 正常、目录属主正确后再创建；不要把 datastore 建在系统根分区下与系统共用。

Q7：Ubuntu 上装不了服务端怎么办？

见第七节：服务端换 Debian 13（官方口径）；被保护端在 Ubuntu 上安装 proxmox-backup-client-static（实测通过），把备份推送到 PBS 服务端。

十、卸载与清理

仅卸载软件包并保留备份配置与数据（按需选择）：

# 卸载服务端与客户端（保留 /etc/proxmox-backup 配置与 datastore 数据）
apt-get purge proxmox-backup-server proxmox-backup-client
apt-get autoremove
# 移除仓库定义与 GPG key（恢复系统原状）
rm -f /etc/apt/sources.list.d/pbs.list /etc/apt/sources.list.d/pbs-client.list
rm -f /etc/apt/trusted.gpg.d/proxmox-release-trixie.gpg
apt-get update

彻底清理（数据销毁，确认备份已迁移后执行）：

# 删除配置目录
rm -rf /etc/proxmox-backup
# 卸载并清空 datastore 挂载点（先 umount 再格式化/删除）
umount /datastore

⚠️ 注意：datastore 内是全量去重备份块，删除后所有历史快照不可恢复。本文实测现场（服务 + /datastore 数据）按惯例保留，未执行卸载。

十一、参考链接

官方文档：安装（ISO / Debian 包安装路径）：https://pbs.proxmox.com/docs/installation.html
PBS 4.2 发布公告（版本基线与升级口径）：https://www.proxmox.com/en/about/company-details/press-releases/proxmox-backup-server-4-2
官方下载页（ISO 4.2-1 + SHA256）：https://www.proxmox.com/en/downloads
免费仓库包索引：http://download.proxmox.com/debian/pbs/dists/trixie/
客户端仓库包索引（static client 取证）：http://download.proxmox.com/debian/pbs-client/dists/trixie/
系列文档：《Proxmox Backup Server 4.2 介绍与选型指南》第八节（选型对比）、《Proxmox Backup Server 4.2 配置参数详解》（datastore/用户/同步配置详解）、《Proxmox Backup Server 日常运维手册》（巡检与告警）