PVE Tools Pro

外观

使用指南 ​

快速开始 ​

在 PVE 终端中执行以下命令即可启动工具：

bash
bash <(curl -sSL https://pve.u3u.icu/PVE-Tools.sh)

该入口脚本会先识别当前地区并决定是否启用 GitHub 加速，然后让你选择 Go 版本或 Shell 版本。Shell 版本会询问是否保存到本地并添加 pvetools alias；Go 版本的本机安装提示由 Go 程序内部处理。Go 版本是后续主线重构方向，交互和结构更清晰；Shell 版本功能覆盖更完整，但已进入归档维护状态。

注意事项 ​

  1. 环境要求：建议在 Proxmox VE 9.0 或更高版本上运行。
  2. 权限要求：必须以 root 用户身份运行。
  3. 备份建议：脚本会自动备份部分关键配置，但任何重大操作前仍应手动完成可验证备份。
  4. 存储前提：Cloud-Init 的 cicustom 依赖 snippets 存储；链接克隆依赖模板与支持克隆的存储；集群迁移需要目标节点与目标存储映射可用。
  5. 执行环境建议：宿主机网络、防火墙、桥接、Bond、VLAN 等操作建议在控制台、iKVM、带外管理或可回滚窗口中执行。

高风险功能提醒 ​

  • 宿主机网络配置向导会直接改写 bridge、Bond、VLAN、IPv4、IPv6 与 PVE 防火墙规则；错误配置可能导致 SSH、WebUI 与业务网络立即中断。
  • "虚拟机高级运维工具箱"中的备份恢复、配置导入导出、模板/克隆/Cloud-Init、磁盘、快照、迁移都属于数据平面操作，会真实改写 VM 配置、磁盘卷或恢复链路。
  • 所有写入型数据操作都应先确认已有可恢复备份，再核对 VMID、磁盘槽位、目标节点、目标存储、保留策略与执行窗口。
  • 脚本只负责自动化执行您确认的操作，不替代业务侧备份策略、变更审批与灾难恢复演练；误操作、硬件故障、底层存储损坏、外部脚本副作用等风险仍需由操作者自行评估。
  • 如果发生误操作，请第一时间停止继续写入，并按误操作后的数据恢复中的顺序保留现场、导出日志、评估快照/备份可用性，再决定是否联系专业恢复团队。

主要功能 ​

  • 配置软件源：切换到更合适的 Debian / PVE / Ceph / CT 模板镜像源。
  • 去除订阅弹窗：处理登录时的无订阅提示。
  • 硬盘管理：完成常见的挂载、直通、镜像导入与存储维护操作。
  • 系统优化：提供针对 PVE 环境的常见增强项。
  • 宿主机网络配置向导：包括 bridge / Bond / VLAN 管理、接口 IPv4/IPv6 配置、PVE 防火墙、安全组、IPv6 助手与网络诊断工具箱。
  • 虚拟机高级运维工具箱：包括备份恢复、配置导入导出、模板与克隆、Cloud-Init、磁盘管理、快照管理、启动策略、网络管理与集群内迁移。
  • 第三方工具集成：整合常用社区脚本与辅助工具。

推荐使用路径 ​

  1. 准备模板或镜像：使用"IMG 镜像导入"导入磁盘镜像，或在"模板 / 克隆 / Cloud-Init"中直接导入 cloud image 并生成模板。
  2. 配置 Cloud-Init：为模板或现有 VM 设置 ciuser、sshkeys、ipconfig0、cicustom 等参数。
  3. 批量交付 VM：通过完整克隆或链接克隆快速复制新实例。
  4. 运行期运维：在磁盘管理、快照管理、网络管理与启动策略菜单中完成日常维护。
  5. 保护与迁移：使用备份与恢复保留可回滚副本，集群内迁移使用 qm migrate 完成节点切换。
  6. 宿主机网络变更：在维护窗口内使用宿主机网络配置向导处理 bridge、Bond、VLAN、IPv6 与防火墙变更，并优先通过控制台执行。