是什么
vmware-toolbox-cmd 是客户机内部读取 VMware 侧信息的轻量工具，属于 open-vm-tools 的一部分。它能查宿主机时间、当前 CPU 主频、内存气球状态与时间同步开关，常用于判断工具链是否正常工作：虚机时钟漂移、性能统计缺数据、宿主机与客户机时间不一致这类问题，先用它做一次快速体检。
基本信息
| 运行位置 | 客户机内部执行，需要 open-vm-tools 已安装且服务在运行 |
|---|---|
| 宿主时间 | vmware-toolbox-cmd stat hosttime |
| CPU 主频 | vmware-toolbox-cmd stat speed |
| 会话标识 | vmware-toolbox-cmd stat sessionid，用于与 vSphere 侧会话对应 |
| 内存状态 | vmware-toolbox-cmd stat balloon 查看气球驱动回收情况 |
| 时间同步 | vmware-toolbox-cmd timesync status，可 enable 或 disable |
典型使用场景
- 虚机时钟漂移排查：对比宿主时间与客户机时间，判断偏差来源
- 确认 open-vm-tools 是否真正生效，而不是只装了包没启动服务
- 性能统计异常时检查工具链，部分指标依赖工具上报
- 模板制作完成后做一次体检，保证克隆出来的虚机工具可用
- 时间同步策略调整后验证开关状态，避免与客户机内 NTP 打架
常用查询
常用查询
vmware-toolbox-cmd stat hosttime # 宿主机当前时间
vmware-toolbox-cmd stat speed # 客户机可见的 CPU 主频
vmware-toolbox-cmd stat sessionid # 与 vSphere 会话对应的标识
vmware-toolbox-cmd stat balloon # 内存气球回收状态
vmware-toolbox-cmd timesync status # 时间同步是否开启
vmware-toolbox-cmd timesync disable # 交由客户机内 NTP 统一管理时关闭子命令读法
| 子命令 | 输出内容 | 判读要点 |
|---|---|---|
| stat hosttime | 宿主机当前时间 | 与客户机时间偏差大说明时钟同步有问题 |
| stat speed | 当前 CPU 主频 | 明显低于标称值要查宿主的电源与降频策略 |
| stat balloon | 气球驱动回收的内存 | 持续回收说明宿主内存压力大 |
| stat sessionid | vSphere 会话标识 | 为空或报错通常意味着工具服务没运行 |
| timesync | 时间同步开关状态 | 与客户机内 NTP 同时开启会互相拉扯 |
只在客户机内装了 open-vm-tools 包、没有启动服务时，这些子命令会报错或输出为空；先确认服务状态，再判断是不是版本问题。
时间同步建议只保留一条链路：要么交给 VMware 的时间同步，要么交给客户机内的 NTP 或 chrony，两者同时开启时可能出现来回跳变。