Veeam备份失败并提示data-agent未在16443端口就绪

问题说明

来源与分类

• 来源渠道：veeam &Commvault使用说明群现场案例。
• 分类结论：Veeam备份前置组件安装或连通性问题。
• 确认依据：现场执行Kaspersky Server备份时，Veeam提示目标主机上的data-agent安装后未能在16443端口通过健康检查；群内另一个多管理节点案例确认，本地安装方式可能只在当前管理节点完成部署，其他管理节点不会自动接收部署参数，需要使用deploy方式安装。
• 内部追踪：暂无明确Jira。

问题元数据

• 问题编号：暂无。
• 组件/产品：ZSphere、Veeam Data Agent及API Proxy部署组件。
• 状态：已有排查方法和多管理节点场景下的规避方案，具体根因需根据端口监听、服务日志和网络连通性确认。
• 优先级/严重程度：一般；会阻断受影响主机或虚拟机的备份任务。
• 已确认版本：当前群内确认适配的Veeam版本为13.1.1.18。
• 首个修复版本：暂无。
• 问题确认日期：2026-08-13。
• 最后更新时间：2026-09-04。

问题描述

Veeam执行备份任务前，会在相关主机上安装或检查data-agent，并访问该主机的16443端口确认组件是否已经就绪。如果安装完成后服务没有启动、端口没有监听、网络或防火墙阻断连接，或者多管理节点环境中组件实际安装在另一个节点，健康检查会失败，备份任务随之终止。

现场案例中的完整报错为：

2026/8/13 13:55:40 :: Kaspersky Server : Failed to perform backup: host data-agent did not become healthy on 172.27.220.211:16443 after installation

该报错只能说明Veeam无法确认指定IP上的data-agent已经就绪，不能仅凭这一行日志判断是服务启动失败、安装位置错误还是网络不通。应先确认报错IP对应的节点，再分别检查安装结果、端口和访问链路。

现象

• 备份任务在安装或检查data-agent阶段失败。
• 任务日志出现：

  Failed to perform backup: host data-agent did not become healthy on <IP>:16443 after installation

• 在报错IP对应节点执行端口检查时，可能看不到16443处于监听状态。
• 多管理节点环境中，可能只有执行本地安装的管理节点监听16443，另一个管理节点没有监听。
• 服务和端口正常时，也可能因为节点间路由、防火墙或地址选择错误导致Veeam无法访问该端口。

现场截图

影响

• 使用受影响节点执行的备份任务失败。
• 其他已经正常部署data-agent且16443端口可达的节点不一定受影响。
• 当前没有证据表明该问题会破坏已有备份数据或虚拟机磁盘数据。
• 在未确认原因前反复安装或卸载组件，可能覆盖现场日志并增加排查难度。

适用环境

• 产品：ZSphere与Veeam集成。
• 产品线：ZVF。
• 组件：Veeam Data Agent及相关部署组件。
• 已确认版本：Veeam13.1.1.18适配环境；其他版本是否受影响需单独验证。
• 触发条件：安装后指定节点的data-agent未能通过16443端口健康检查，或Veeam无法访问该端口。

可能原因

该现象可能由以下一种或多种情况导致：