Synology VMM Guest Agent 安装实操指南：解锁虚拟机全功能管理

• 状态数据同步：实时采集虚拟机的硬件资源使用情况（CPU 负载、内存占用、磁盘 IO、网络流量），并同步到 VMM 管理界面，让管理员直观监控虚拟机健康状态；

• 硬件资源优化：配合 VMM 实现 “动态资源分配”（如虚拟机 CPU 使用率过高时自动扩容 CPU 核心数）、“内存气球技术”（回收闲置内存分配给其他虚拟机），提升物理主机资源利用率；

• 快照与备份保障：在创建虚拟机快照或执行备份时，Agent 会通知虚拟机内的应用（如数据库、文件服务）暂停写入，确保快照数据一致性（避免 “快照包含半写入文件” 导致恢复失败）；

• 硬件驱动适配：提供 VMM 优化的硬件驱动（如虚拟网卡、虚拟磁盘控制器驱动），解决虚拟机启动蓝屏、硬件识别异常等兼容性问题。

官方提示：若虚拟机系统不在兼容列表（如 Windows XP、Linux Mint），可尝试安装通用版本 Agent，但可能仅支持基础监控功能，高级功能（如快照一致性）无法使用。

1. 检查 VMM 版本与权限：

• • 登录 Synology NAS 的 DSM→打开「Virtual Machine Manager」→点击右上角 “?”→“关于 VMM”，确认版本≥4.0；

• • 确保当前登录的 DSM 账户拥有 “VMM 管理员权限”（可在「控制面板→用户与群组→应用程序权限→VMM」中查看，需勾选 “管理员” 角色）；

2. 确认虚拟机状态：

• • 在 VMM “虚拟机” 列表中，找到目标虚拟机（如 “Win11-VM”“Ubuntu-Server”），确保状态为 “已停止” 或 “已运行”（安装 Agent 无需关机，但运行中安装需管理员权限）；

• • 若虚拟机处于 “已暂停” 状态，需先点击 “继续” 恢复运行，再进行后续操作。

1. 确保虚拟机联网：

• • 启动虚拟机，确认能正常访问互联网（Windows 可 ping 百度：ping baidu.com；Linux 可 ping 谷歌：ping 8.8.8.8），若无法联网，需在 VMM 中检查虚拟机的虚拟网卡配置（如是否绑定正确的虚拟交换机、IP 是否在正确网段）；

2. 获取虚拟机管理员权限：

• • Windows：登录 “管理员账户”（非标准用户，需在「控制面板→用户账户」中确认账户类型为 “管理员”）；

• • Linux：确保拥有 sudo 权限（如 Ubuntu 默认账户、CentOS 的 root 账户，或通过sudo -i测试能否切换到 root 权限）。

1. 在 VMM 中右键目标虚拟机→选择 “编辑设置”→切换到 “Guest Agent” 标签页；

2. 点击 “下载 Guest Agent 安装程序”，根据虚拟机系统选择对应版本：

• • Windows 系统：选择 “Windows Installer（.exe）”；

• • Linux 系统：选择 “Linux Package（.deb/.rpm，Debian 系选.deb，RPM 系选.rpm）”；

3. 下载完成后，通过 VMM 的 “虚拟机控制台” 或 “文件传输” 功能（如 Windows 的远程桌面文件复制、Linux 的 scp 命令）将安装包传入虚拟机内部（如 Windows 保存到 “D:Temp”，Linux 保存到 “/tmp”）。

1. 访问 Synology 官网下载页（https://www.synology.com/zh-cn/support/download）；

2. 在 “产品类型” 中选择 “软件”→“Virtual Machine Manager”→选择对应 VMM 版本（如 VMM 4.5）；

3. 在 “相关下载” 中找到 “Synology Guest Agent”，下载对应系统的安装包，注意区分 32 位 / 64 位（Windows 需选 64 位，Linux 根据系统架构选 x86_64）。

1. 运行安装程序：

• • 找到传入虚拟机的 “Synology-Guest-Agent-Windows-x64.exe”，右键点击→选择 “以管理员身份运行”（必须管理员权限，否则无法安装系统服务）；

• • 若弹出 “用户账户控制” 提示，点击 “是” 允许程序修改系统。

2. 跟随安装向导配置：

• • 欢迎界面：点击 “下一步”，阅读许可协议，勾选 “我接受许可协议中的条款”，点击 “下一步”；

• • 安装类型：选择 “完整安装”（默认，包含监控服务、硬件驱动、快照一致性组件），不建议选 “自定义安装”（易遗漏关键组件）；

• • 安装路径：默认安装到 “C:Program FilesSynologyGuest Agent”，无需修改（路径含空格可能导致服务启动失败），点击 “下一步”；

• • 准备安装：确认配置无误，点击 “安装”，开始安装（期间可能弹出 “硬件驱动安装” 提示，点击 “安装” 允许驱动签名，Windows 11 需在 “设置→隐私和安全性→开发者选项” 中临时关闭 “驱动签名强制”，安装后可重新开启）。

3. 完成安装并重启：

• • 安装完成后，勾选 “立即重启计算机”（必须重启，确保驱动和服务生效），点击 “完成”，虚拟机自动重启。

4. 验证服务状态（重启后）：

• • 虚拟机重启后，登录管理员账户→按Win+R输入services.msc→回车打开 “服务” 窗口；

• • 在服务列表中找到 “Synology Guest Agent Service”，确认 “状态” 为 “正在运行”、“启动类型” 为 “自动”，若状态为 “已停止”，右键点击 “启动”，并将启动类型改为 “自动”（避免重启后服务不自动运行）。

1. 进入安装包目录：

• • 打开终端（快捷键Ctrl+Alt+T），通过cd命令进入安装包所在目录（如cd /tmp，假设安装包保存在 /tmp）；

• • 执行ls命令，确认安装包存在（如 “synology-guest-agent_1.2.0-1001_amd64.deb”）。

2. 安装依赖与 Agent 包：

• • 先更新系统依赖（避免缺少 lib 库导致安装失败）：

• • 执行.deb 包安装命令（替换包名为实际下载的文件名）：

• • 若提示 “依赖关系问题”，执行sudo apt -f install自动修复依赖，修复后重新执行上述 dpkg 命令。

3. 启动服务并设置开机自启：

• • 启动 Guest Agent 服务：

• • 设置开机自启：

• • 验证服务状态：

1. 进入安装包目录：

• • 打开终端，执行cd /tmp进入安装包目录，ls确认安装包（如 “synology-guest-agent-1.2.0-1001.x86_64.rpm”）。

2. 安装依赖与 Agent 包：

• • 安装 EPEL 仓库（CentOS 默认仓库缺少部分依赖）：

• • 更新依赖并安装 lib 库：

• • 执行.rpm 包安装命令：

3. 启动服务并验证：

• • 启动服务：

• • 开机自启：

• • 验证状态：

1. 检查 Agent 连接状态：

• • 打开 VMM→进入 “虚拟机” 列表，找到目标虚拟机，在 “Guest Agent” 列查看状态：

• • • 正常：显示 “已连接”（绿色图标），说明通信正常；

• • • 异常：显示 “未连接”（红色图标），需排查网络或服务状态；

2. 查看虚拟机资源监控：

• • 右键虚拟机→选择 “监控”→“实时监控”，查看 CPU、内存、磁盘 IO、网络流量的实时数据，若能看到动态变化（如 CPU 使用率随操作波动），说明监控功能生效；

3. 测试快照一致性（高级功能验证）：

• • 在虚拟机中创建一个测试文件（如 Windows 新建 “test.txt” 并写入内容，Linux 执行echo "test" > /tmp/test.txt）；

• • 在 VMM 中右键虚拟机→“创建快照”，勾选 “启用 Guest Agent 一致性检查”，点击 “确定”；

• • 快照完成后，右键快照→“恢复”，恢复后检查测试文件是否完整（无内容丢失或损坏），若完整，说明快照一致性功能生效。

1. Windows 内部验证：

• • 再次打开 “服务” 窗口，确认 “Synology Guest Agent Service” 持续运行（无频繁重启）；

• • 按Win+R输入devmgmt.msc打开 “设备管理器”，展开 “磁盘驱动器”“网络适配器”，确认 “Synology Virtual Disk”“Synology Virtual Ethernet Adapter” 无黄色感叹号（驱动正常）；

2. Linux 内部验证：

• • 执行sudo cat /var/log/synology-guest-agent/agent.log，查看日志无 “error” 或 “fail” 关键字（日志正常）；

• • 执行lsmod | grep syno，查看是否加载 Synology 相关内核模块（如 “syno_guest_agent”“syno_virtio”），加载成功说明驱动正常。

• 原因：Windows 10/11 默认启用 “驱动签名强制”，Guest Agent 的虚拟硬件驱动未通过微软 WHQL 认证（Synology 官方驱动，安全但未提交认证）；

• 解决：

1. 1. 临时关闭驱动签名：Windows 11 按Win+I打开 “设置→系统→恢复”→点击 “高级启动” 下的 “立即重启”；

1. 2. 重启后进入 “疑难解答→高级选项→启动设置→重启”，重启后按数字键 “7” 选择 “禁用驱动程序强制签名”；

1. 3. 系统重启后，重新运行 Guest Agent 安装程序，驱动可正常安装；安装完成后重启，驱动签名会自动恢复，不影响后续使用。

• 原因：虚拟机防火墙拦截了 Agent 与 VMM 的通信端口（默认 5989/TCP，用于 WMI 或 SSH 通信）；

• 解决：

1. 1. Ubuntu：执行sudo ufw allow 5989/tcp开放端口，sudo ufw reload重启防火墙；

1. 2. CentOS：执行sudo firewall-cmd --add-port=5989/tcp --permanent，sudo firewall-cmd --reload；

1. 3. 重启 Guest Agent 服务：sudo systemctl restart synology-guest-agent，等待 1-2 分钟后查看 VMM 状态，通常会变为 “已连接”。

• 原因：虚拟机内存不足（＜2GB）或安装路径含中文 / 特殊字符（如 “C: 软件 Synology”）；

• 解决：

1. 1. 关闭虚拟机，在 VMM“编辑设置→硬件→内存” 中将内存调整为≥2GB，启动虚拟机；

1. 2. 若路径含特殊字符，卸载现有 Agent（控制面板→程序卸载→Synology Guest Agent），重新运行安装程序，选择默认路径（C:Program Files...），避免自定义路径。

• 原因：Ubuntu 22.04 默认移除了 libssl1.1（仅保留 libssl3），但 Guest Agent 依赖旧版本 libssl；

• 解决：手动添加 Ubuntu 20.04 的源并安装 libssl1.1：

sudo echo "deb http://security.ubuntu.com/ubuntu focal-security main" | sudo tee /etc/apt/sources.list.d/focal-security.listsudo apt updatesudo apt install -y libssl1.1

• 原因：虚拟机系统不支持快照一致性功能（如 Windows Home 版、Linux 轻量发行版），或 Agent 安装时未勾选 “快照一致性组件”；

• 解决：

1. 1. Windows：确认系统为专业版 / 企业版，若为 Home 版，需重装系统为专业版；

1. 2. 重新安装 Agent：Windows 选择 “完整安装”，Linux 确保安装包包含 “consistency” 组件（查看包名是否含 “consistent”）；

1. 3. 若仍失败，可在创建快照时取消 “启用 Guest Agent 一致性检查”（仅基础快照，数据一致性无法保障，适合非关键虚拟机）。

• 解决：

1. 1. Windows：通过 VMM 下载最新安装包，运行安装程序，选择 “升级”（自动覆盖旧版本，保留配置）；

1. 2. Linux（Ubuntu）：下载最新.deb 包，执行sudo dpkg -i 新包名.deb（自动升级）；

1. 3. Linux（CentOS）：下载最新.rpm 包，执行sudo rpm -Uvh 新包名.rpm（-Uvh参数表示 “升级 - 显示进度 - 详细信息”）；

1. 4. 升级后重启 Agent 服务，确保新版本生效。

1. 定期更新 Agent：跟随 VMM 版本更新同步升级 Guest Agent（VMM 会提示 “Agent 版本不兼容”），避免因版本差异导致功能失效；

2. 监控 Agent 服务状态：在 VMM 中设置 “Guest Agent 未连接” 告警（「VMM→设置→通知→添加规则」），及时发现通信中断问题；

3. 避免过度定制：Linux 系统尽量使用官方兼容发行版，不建议深度定制内核（如自行编译内核），避免驱动不兼容导致 Agent 失效。