【免费下载链接】Proxmox
Update your Proxmox VE
Ultimate Updater 是一款面向 Proxmox VE 的集中式更新管理工具：在集群中安装一次，就能统一检查和更新 Proxmox 主机、LXC 容器、虚拟机乃至外部 Linux 系统，并附带 Web UI、定时计划、快照/备份保护与邮件通知。本文带你从零开始，完成安装并跑通第一次只读检查（Check）。
安装前准备：3个关键前提 ✅
Ultimate Updater 是一次安装在集群中任意一个节点的集中式工具，协调全集群的清单、检查、更新、状态与通知。不要在每个节点各装一份管理实例（单节点环境则直接装在该节点即可）。
安装前请确认：
| 前提条件 | 说明 |
|---|---|
| root 权限 | 以 root 身份在受支持的 Proxmox VE 主机上安装 |
| 集群可互相解析 | 节点间能通过 Proxmox 使用的名称/地址互相解析，且 SSH 指纹可用 |
| 虚拟机访问方式 | 要检查/更新的 VM 需具备可用的 QEMU Guest Agent（guest-exec）或密钥 SSH |
| 现有备份 | 启用实际更新前，请确保已为重要机器做好备份 |
⚠️ 集群操作细节可阅读官方文档：docs/cluster.md，虚拟机访问方式详见 docs/ssh.md。
一键安装步骤
方式一：下载仓库后本地安装（推荐新手）
git clone https://gitcode.com/gh_mirrors/prox/Proxmox
cd Proxmox
bash install.sh
安装器会校验输入并保留已有配置，重复执行也安全。安装完成后，主程序为 ultimate-updater（另有 update 别名），配置文件位于 /etc/ultimate-updater/update.conf。
方式二：远程一键安装
官方文档 docs/installation.md 提供了一条命令式的远程安装流程：下载 install.sh 到临时文件、执行 bash -n 语法校验后再运行。如果你信任执行环境，这是最快捷的方式。
📌 相关入口文件：install.sh、ultimate-updater、update.conf
首次配置：3分钟了解核心设置
安装后，先浏览主配置文件 /etc/ultimate-updater/update.conf，新手只需关注几组开关：
WITH_HOST/WITH_LXC/WITH_VM：选择检查目标类型（主机 / LXC 容器 / 虚拟机）；CHECK_*：控制是否包含运行中、已停止、已暂停的虚拟机；REBOOT_IF_NEEDED：仅在更新路径生效，与检查无关；SNAPSHOT/BACKUP相关：更新前的快照与备份保护，两者相互独立。
完整配置说明见 docs/configuration.md。
确认 Web 服务并打开管理界面
Ultimate Updater 的 Web UI 由 ultimate-updater-web.service 提供，默认监听 8765 端口，优先使用 Proxmox 托管证书走 HTTPS：
systemctl status ultimate-updater-web
服务正常后，在浏览器打开：
https://<proxmox-node>:8765/
使用 Proxmox 本地管理员账号（PAM 认证）登录。登录后的仪表盘会一览全集群节点、虚拟机、LXC 与外部目标的可达性和待更新状态：
Web UI 的使用说明（导航、设置、任务、调度器）详见 docs/web-ui.md。
执行首次检查：Check 和 Update 是两回事 💡
这是新手最容易踩的坑：Check（检查）是只读操作，只发现更新状态，绝不重启虚拟机；Update（更新）才是会改变系统的操作。因此官方建议——先跑检查，看清楚结果，再决定是否更新。
CLI 方式
ultimate-updater check # 检查全部已配置目标
ultimate-updater status # 查看状态
Web UI 方式
在仪表盘中点击 Check all systems（检查所有系统）。任务在服务端持久化运行，即使断开浏览器或 SSH 也会继续，完成后可在 Jobs 页面查看结果与保留日志：
任务列表会展示每次作业的动作（CHECK / UPDATE）、目标、开始时间、退出码，以及 "completed / failed / Please check" 等结果状态，点 "Show log" 即可展开详细输出。
进阶：用调度器让检查自动跑
确认手动检查一切正常后，可以进入 Scheduler（调度器）配置定期检查计划：选择启用的排程、星期几，支持"立即运行、编辑、禁用、删除"等操作。调度复用同样的任务执行器与安全规则，不会绕过你设置的保护措施：
新手安全清单 🛡️
- 先 Check 后 Update——检查永不重启虚拟机，更新才可能触发重启（
REBOOT_IF_NEEDED仅作用于更新路径）； - 快照与备份独立配置——无效的备份存储会被直接拒绝，而不是被静默忽略；
- 不要把可执行操作的 Web UI 暴露到不可信网络——建议仅在受信管理网络访问；
- 检查可能临时启动已停止/暂停的虚拟机，完成后（含出错时）会恢复原有状态。
更多检查与更新的语义差异见 docs/checks-and-updates.md，备份与快照细节见 docs/backup-and-snapshots.md。
小结
到这一步，你已经完成了 Ultimate Updater 在 Proxmox 集群上的完整落地：
| 步骤 | 结果 |
|---|---|
克隆仓库 + bash install.sh | 中央安装完成，配置保留在 /etc/ultimate-updater/ |
ultimate-updater-web.service 运行 | 8765 端口 Web UI 可访问 |
首次 check 成功 | 全集群节点与虚拟机状态一目了然 |
后续可以探索 docs/scheduler.md 的定时计划、docs/notifications.md 的邮件通知，以及 docs/external-systems.md 中的外部系统管理。祝更新顺利！
【免费下载链接】Proxmox
Update your Proxmox VE
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
