一、pvetools 脚本简介

1. 快速替换 PVE 软件源（禁用企业源、切换国内开源源）；

2. 配置 IOMMU、VFIO 直通环境（适配 AMD/Intel）；

3. 安装 QEMU Guest Agent、VirtIO 工具等；

4. 优化系统参数、清理缓存、关闭无用服务；

5. 辅助配置核显 / 独显直通、虚拟机优化等。

注意：pvetools 为第三方开源脚本，建议优先备份 PVE 重要配置（如 /etc/pve/ 目录）后再执行操作。

二、两种安全下载方法（任选其一）

方法 1：直接通过 curl 下载并运行（推荐，快速便捷）

1. 登录 PVE 宿主机（SSH 或网页端「Shell」，确保 root 权限）；

2. 执行以下命令直接下载并运行最新版 pvetools（国内节点，速度更快）：

   bash

   运行

   # 核心下载运行命令（国内镜像）curl -sSL https://raw.githubusercontent.com/ivanhao/pvetools/master/pvetools.sh | bash

3. 若上述命令访问失败（网络限制），使用备用国内 Gitee 镜像：

   bash

   运行

   # 备用镜像（Gitee）curl -sSL https://gitee.com/ivanhao/pvetools/raw/master/pvetools.sh | bash

方法 2：先下载脚本文件，再赋予权限运行（更安全，可查看脚本内容）

1. 登录 PVE 宿主机，执行以下命令下载脚本到当前目录：

   bash

   运行

   # 下载脚本文件wget https://raw.githubusercontent.com/ivanhao/pvetools/master/pvetools.sh -O pvetools.sh

2. 若访问失败，替换为 Gitee 镜像下载：

   bash

   运行

   # 备用下载（Gitee）wget https://gitee.com/ivanhao/pvetools/raw/master/pvetools.sh -O pvetools.sh

3. 给脚本赋予可执行权限：

   bash

   运行

   chmod +x pvetools.sh

4. 运行脚本：

   bash

   运行

   ./pvetools.sh

三、pvetools 核心操作（适配你的需求）

1. 选项 1：更换 PVE 软件源

• 选择「禁用企业源」→ 「切换为国内开源源（阿里云 / 清华）」，无需手动编辑配置，自动完成源替换和更新。

2. 选项 3：配置 IOMMU/VFIO 直通环境

• 脚本会自动识别 AMD/Intel CPU，一键配置 GRUB 内核参数（amd_iommu=on/intel_iommu=on）、屏蔽显卡驱动、绑定 VFIO，与你之前的核显直通需求完全兼容。

3. 选项 5：安装 QEMU Guest Agent 与 VirtIO 工具

• 一键安装宿主机侧依赖，同时提供虚拟机侧 VirtIO 驱动 ISO 下载路径，优化虚拟机 IO 性能和管理效率。

4. 选项 7：系统优化（清理缓存、禁用无用服务）

• 自动禁用 pve-ha-crm、postfix 等无用服务，清理系统缓存和冗余包，释放资源。

四、注意事项

1. 脚本运行过程中会有交互提示，按「回车」确认默认选项即可，针对核显直通，无需额外修改默认参数。

2. 操作完成后，脚本会提示「是否重启 PVE」，建议选择「是」，使内核参数、源配置等生效。

3. 若脚本运行中出现「权限不足」，确认当前用户为 root，或在命令前添加 sudo。

4. PVE 9 为最新版本，部分脚本功能可能存在小幅兼容差异，若遇问题，优先选择「更新脚本」选项（菜单末尾）获取最新兼容版本。

5. 避免与之前手动执行的优化脚本重复操作（如重复配置 GRUB 参数），若已手动优化，可跳过对应选项。

五、后续验证

1. 验证 IOMMU 启用：dmesg | grep -e DMAR -e IOMMU

2. 验证软件源生效：apt update（无企业源报错即为成功）

3. 验证 VFIO 模块加载：lsmod | grep vfio