PVE 8 升级到 9.0 正式版升级教程 (视频+官方教程)

Proxmox VE 9.x 版本引入了多项重大新特性，你可以在这里查看它的新功能介绍以及这里下载到最新版本的官方 PVE ISO 镜像，用来升级或全新安装。

下面将带领大家从 PVE 8.x 系统升级到 PVE 9 正式版的简单升级教程。升级前需仔细规划，确保备份完整并经过验证，同时进行充分测试。根据现有配置情况，升级过程可能需要执行多项手动操作（包括停机时间）。

下载最新版 PVE 系统镜像

Proxmox VE 8 升级到 PVE 9 的方案选择

现有 PVE 8.x 系统升级到 PVE 9.x 可选用以下两种升级路径。当然，在开始前需要注意：

• 开始升级流程前必须确保有经过测试的有效备份（建议在测试环境中预先验证备份可靠性）
• 若系统存在自定义配置/额外软件包/第三方软件源，需确保这些组件已适配 Debian Trixie

一、全新安装方案（配合备份恢复）

• 将虚拟机与容器备份至外部存储（参见官网备份与恢复文档）
• 备份 /etc 目录关键文件：包括 /etc/pve 目录内容、/etc/passwd、网络配置、DNS 解析配置等非默认配置项
• 使用 Proxmox VE 9.x ISO 执行全新安装（现有主机数据将被清除）
• 清空浏览器缓存并强制刷新管理界面 (Windows: Ctrl+Shift+R / MacOS: ⌘+Alt+R)
• 重建集群（如适用）
• 恢复 /etc/pve/storage.cfg 文件（使备份所用外部存储重新可用）
• 恢复防火土啬配置（如适用）
• 从备份还原所有虚拟机

注：对于所有虚拟机/容器均位于共享存储的环境，熟悉命令行的管理员可参考《升级过程中绕过备份恢复操作》流程。

二、原地升级方案

此方案通过 apt 工具执行升级，要求操作者具备 apt 使用经验。下面是一段视频升级教程以及文字教程 (二者无直接关系)，但大家可以以此了解更多升级过程中的步骤和注意内容。

Proxmox VE 8.4 升级到 PVE 9 视频教程

前提条件

1. 所有节点均已升级至 Proxmox VE 8.4 版本
2. 若 pve-manager 版本低于 8.4.1，需通过管理界面（节点 -> 软件源）配置正确的软件源
3. 超融合 Ceph 场景：在开始 Proxmox VE 9.0 升级前：
   • 将现有 Ceph Quincy/Reef 集群升级至 Ceph 19.2 Squid
   • 参照对应升级指南操作
4. 共置 Proxmox Backup Server 情况：参照 PBS 3 升 4 指南
5. 确保具备可靠的主机访问通道（推荐使用 IPMI 或物理控制台）
6. 健康运行的集群状态
7. 所有虚拟机和容器均有经过验证的有效备份
8. 根文件系统剩余空间 ≥5GB（建议保留 10GB 以上）

升级测试建议

建议使用独立测试服务器执行升级验证：

• 在测试设备安装 Proxmox VE 8.4 ISO
• 将其升级至 Proxmox VE 8.4 最新小版本
• 复制生产环境相关配置进行升级测试
• 也可在虚拟机内安装 Proxmox VE 8.4 进行验证

分步操作指南

以下操作需在集群各节点的命令行终端执行：

重要提示：

• 优先选用物理控制台操作（避免 SSH 中断风险）
• 切勿通过 Web 管理界面的虚拟控制台执行升级
• 必须确认已有完整备份
• 推荐使用终端复用工具（如 tmux/screen）

pve8to9 检查脚本使用

最新 Proxmox VE 8.4 已经内置了 pve8to9 升级脚本，并可全程提供风险预警：

pve8to9  # 基础检查
pve8to9 --full  # 完整检查（升级前必须执行）

注意：

• 该脚本仅进行检测提示，不会自动修复问题
• 由于系统可能存在深度定制，脚本可能无法识别全部潜在问题
• 建议每次修复问题后重新执行验证

虚拟机迁移规划

需持续运行的虚拟机/容器应迁移至其他节点，注意迁移兼容性原则：

• 从旧版本迁移至新版本永远可行
• 反向迁移可能工作但不被官方支持

注意：在部分升级的集群中，若通过已升级节点的 Web 界面操作未升级节点，可能出现兼容性问题（建议通过未升级节点的界面执行迁移操作）。

APT 软件源配置更新

1. 首先确保系统已更新至 Proxmox VE 8.4 最新版：

   apt update
   apt dist-upgrade
   pveversion  # 确认版本 ≥8.4.1
   

2. 超融合 Ceph 环境确认：
   • 必须已升级至 Ceph Squid (v19)
   • 通过 ceph --version 验证
   • 未达标请先完成 Ceph 升级

Debian 基础源更新至 Trixie

执行如下命令更新软件源指向：

sed -i 's/bookworm/trixie/g' /etc/apt/sources.list
sed -i 's/bookworm/trixie/g' /etc/apt/sources.list.d/pve-enterprise.list

检查确保无残留 Bookworm 软件源（可注释相关行），参考官方文档确认正确的软件源配置。

添加 Proxmox VE 9 软件源

企业版用户：

创建新的 deb822 格式企业源配置：

cat > /etc/apt/sources.list.d/pve-enterprise.sources << EOF
Types: deb
URIs: https://enterprise.proxmox.com/debian/pve
Suites: trixie
Components: pve-enterprise
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
EOF

验证配置后移除旧版 .list 文件。

无订阅用户：

参照文档配置或执行：

cat > /etc/apt/sources.list.d/proxmox.sources << EOF
Types: deb
URIs: http://download.proxmox.com/debian/pve
Suites: trixie
Components: pve-no-subscription
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
EOF

Ceph 软件源更新（仅限超融合场景）

替换所有 ceph.com 源为 proxmox.com 源，确保当前运行 Ceph 19.2 Squid。

企业版配置：

cat > /etc/apt/sources.list.d/ceph.sources << EOF
Types: deb
URIs: https://enterprise.proxmox.com/debian/ceph-squid
Suites: trixie
Components: enterprise
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
EOF

若遇 401 错误需刷新订阅：

pvesubscription update --force

无订阅配置：

cat > /etc/apt/sources.list.d/ceph.sources << EOF
Types: deb
URIs: http://download.proxmox.com/debian/ceph-squid
Suites: trixie
Components: no-subscription
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
EOF

注意：需移除所有 backports 源条目。

执行系统升级

1. 更新软件索引：apt update
2. 执行全面升级（耗时取决于存储性能）：apt dist-upgrade

升级过程中需处理以下常见配置变更：

最终检查与重启

升级完成后：

1. 再次运行 pve8to9 检查脚本
2. 必须重启以启用新内核（即使之前已使用 6.14 内核）

注意：重启可确保系统完全适配 Proxmox VE 9 的编译器与 ABI 版本。