ESXi 6.x 离线安装 WebUI：esxui.vib 依赖与 vsphere-ui 部署全解-北京尧图网络

简介本资源是专为VMware ESXi 6.7.0主机设计的离线UI升级包面向虚拟化运维工程师、系统管理员及vSphere平台维护人员用于安全、可控地更新ESXi内置Web客户端esx-ui组件解决因网络受限无法在线获取补丁时的界面功能滞后或兼容性问题。压缩包共4个文件含2个关键XML索引文件index.xml与vendor-index.xml分别定义组件清单与供应商元数据、1个VIB格式核心安装包vib20实际为VMware_bootbank_esx-ui_1.33.1-12086396.vib以及1个metadata.zip签名验证文件整体仅3.63MB轻量且便于离线部署与校验。目前已有530人学习下载资源结构规范、组件职责明确附带完整元数据与索引机制可直接配合esxcli命令执行升级并为排查“Possibly unhandled rejection”类UI交互异常提供标准修复依据与版本匹配参考。1. ESXi 6.x 离线 WebUI 安装包别再被“找不到 esxui.vib”卡在凌晨三点你是不是也经历过——ESXi 主机刚重装完想用浏览器管理却被告知「Web Client 未启用」翻遍 vSphere Client 文档发现 6.5 默认禁用旧版 WebUI而官方又不提供独立离线安装包好不容易从某个论坛扒到esxui-offline-bundle-6.x-12086396.zip解压后面对一堆.vib和.zip文件发懵到底该传哪个esxcli software vib install报错Dependency not satisfied是缺啥esxui和vsphere-ui到底是同一个东西还是两套系统这个压缩包不是玩具它是 VMware 官方在 ESXi 6.0–6.7 U3 时期为离线环境打包的完整 WebUI 替代方案核心包含esxuiHTML5 前端vsphere-ui后端服务依赖库如python3,nodejs,nginx模块专治没有外网、不能连 VMware Depot、又不想降级用 Flash 的硬核场景。它不依赖 vCenter纯主机级部署装完直接https://你的IP/ui访问。适合某高校实验室批量部署、某公司边缘机房维护、或某开发者在本地 ESXi 虚拟机里搭测试环境——只要你的 ESXi 版本落在 6.0–6.7 U3 范围内它就是你最后一张「后悔药」。2. 解包与环境校验先看清这包里到底有几颗雷这个esxui-offline-bundle-6.x-12086396.zip不是单个 VIB而是一个「离线仓库包」结构比想象中复杂。它本质是 VMware 将多个组件打包成一个可挂载的 depot类似 yum repo必须通过esxcli software sources profile list或vihostupdate工具识别不能直接esxcli software vib install -v xxx.vib。很多翻车就发生在第一步误把esxui.vib单独拎出来装结果报一堆python36、nodejs10依赖缺失——因为这些 runtime 本身就被打包在 bundle 里但必须整包挂载才能触发依赖自动解析。2.1 解压与目录结构确认先确保你有一台能连外网的 Linux/macOS 机器Windows 需用 WSL2 或 Git Bash下载好 ZIP 后执行unzip esxui-offline-bundle-6.x-12086396.zip -d esxui-bundle ls -l esxui-bundle/你会看到类似如下结构实际以你解压内容为准esxui-bundle/ ├── index.xml # depot 元数据文件定义 profile 名称和组件依赖 ├── metadata.zip # 组件描述信息可选用于验证 ├── payloads/ # 所有 VIB 包存放目录 │ ├── esx-ui-6.7.0-12086396.x86_64.vib │ ├── vsphere-ui-6.7.0-12086396.x86_64.vib │ ├── python36-3.6.12-12086396.x86_64.vib │ ├── nodejs10-10.24.1-12086396.x86_64.vib │ └── nginx-1.16.1-12086396.x86_64.vib └── README.txt # 官方简要说明通常只写 For offline installation提示payloads/下的.vib文件名中的6.7.0表示该 bundle适配 ESXi 6.7.0 及兼容版本6.5 U2、6.7 U1/U2/U3。如果你的 ESXi 是 6.0 U3请务必核对index.xml中profile nameESXi-6.0.0-...是否存在对应 profile否则强行安装会失败。我一般会先grep -A5 ESXi-6. esxui-bundle/index.xml快速确认。2.2 ESXi 主机端基础检查三件事必须做登录你的目标 ESXi 主机SSH 开启且用户有 root 权限执行以下三步校验① 确认 ESXi 版本与 bundle 兼容性vmware -v # 输出示例VMware ESXi 6.7.0 build-15820000 # 注意build 号末尾的 15820000 ≠ bundle 中的 12086396 —— 这是正常现象。 # 关键看主版本6.7.0 ✅6.5.0 ✅6.0.0 ✅6.7.3 ❌U3 之后需更高 bundle② 检查存储空间是否足够极易被忽略WebUI 组件安装后会占用约 1.2GB/altbootbank和/bootbank空间含日志、缓存、临时解压。执行df -h /bootbank /altbootbank # 必须同时满足 # - /bootbank 使用率 85%建议 ≤75% # - /altbootbank 有 ≥500MB 可用空间否则安装中途会因无法写入 altbootbank 失败 # 若不满足先清理旧补丁esxcli software vib remove -n old-vib-name③ 确认防火墙与服务状态# 确保 hostd主机管理服务和 rhttpproxyHTTPS 代理正在运行 /etc/init.d/hostd status /etc/init.d/rhttpproxy status # 若 rhttpproxy 未运行手动启动/etc/init.d/rhttpproxy start # 检查 443 端口是否被占用常见于已装过其他 Web 服务 netstat -tuln | grep :443注意ESXi 6.7 默认启用rhttpproxy作为 HTTPS 入口esxui会注册到该代理下。若你之前手动停用过rhttpproxy必须先恢复否则装完也打不开https://ip/ui。3. 上传与挂载把离线包变成 ESXi 能读的“软件源”这一步是整个流程的分水岭——成功挂载后面就是标准esxcli流程挂载失败所有后续命令都会报No matching profile found。关键在于必须将整个esxui-bundle/目录含index.xml作为整体上传到 ESXi 的某个可读路径且路径不能含空格或中文。3.1 上传方式选择与实操推荐 SCP不推荐 Datastore 浏览器上传Web UI 上传大文件易超时、断连且上传后路径常带%20编码esxcli无法识别。推荐 SCPLinux/macOS或 WinSCPWindows稳定、路径可控。假设你已解压 bundle 到本地~/esxui-bundle/执行# 将整个目录递归上传到 ESXi 的 /tmp/esxui-bundle注意/tmp 是内存盘重启丢失但安装过程够用 scp -r ~/esxui-bundle/ rootYOUR_ESXI_IP:/tmp/ # 登录 ESXi 验证 ssh rootYOUR_ESXI_IP ls -l /tmp/esxui-bundle/ # 应看到 index.xml, payloads/, metadata.zip 等完整结构提示若你习惯用 Datastore可上传到/vmfs/volumes/datastore1/esxui-bundle/但路径必须绝对准确。esxcli对路径敏感多一个/或少一个字母都会失败。3.2 挂载离线 depot 并列出可用 profile挂载命令本质是告诉 ESXi“把这个目录当作一个软件源来读”语法固定# 命令格式esxcli software sources profile add -d depot_path -n profile_name # 先查看当前已挂载的 depot避免重复 esxcli software sources profile list # 挂载我们刚上传的 bundle路径必须以 file:// 开头且指向包含 index.xml 的目录 esxcli software sources profile add -d file:///tmp/esxui-bundle -n ESXi-6.7.0-12086396-standard # 查看是否挂载成功 esxcli software sources profile list | grep -A3 ESXi-6.7.0成功输出应类似Name: ESXi-6.7.0-12086396-standard Vendor: VMware Creation Time: 2020-07-15T12:34:56Z Description: ESXi 6.7.0 Offline Bundle for ESXUI and vSphere UI注意-n参数后的 profile 名必须与index.xml中profile name...完全一致大小写、连字符、数字都不能错。如果不确定直接cat /tmp/esxui-bundle/index.xml | grep profile name查看原始值。我曾因复制时多了一个空格卡了 40 分钟——这种玄学错误建议复制粘贴后用echo xxx | wc -c数字符数。3.3 验证依赖完整性提前揪出潜在冲突挂载只是第一步真正危险的是依赖冲突。比如你的 ESXi 已手动装过python36的旧版 VIB而 bundle 里带的是新版esxcli默认拒绝覆盖。此时需强制检查# 检查该 profile 的所有组件是否满足当前系统依赖 esxcli software profile acceptance get # 输出应为 CommunitySupported 或 PartnerSupported若为 Unsupported 则需手动调整接受级别见避坑章 # 检查 profile 内部组件兼容性不实际安装只模拟 esxcli software profile update -d file:///tmp/esxui-bundle -n ESXi-6.7.0-12086396-standard --dry-run--dry-run是救命参数。它会输出类似The update will perform the following actions: Install: esx-ui-6.7.0-12086396.x86_64 Install: vsphere-ui-6.7.0-12086396.x86_64 Install: python36-3.6.12-12086396.x86_64 Install: nodejs10-10.24.1-12086396.x86_64 Install: nginx-1.16.1-12086396.x86_64 Remove: python36-3.6.8-XXXXXX.x86_64 ← 注意这一行表示会卸载旧版如果看到Remove:行说明有冲突组件安装时会自动替换若看到Conflict:或Cannot satisfy dependency则必须先手动移除冲突 VIB见避坑章。4. 安装与启动执行 profile 更新并验证服务现在万事俱备执行最终安装。注意这是高危操作必须确保主机无关键业务运行且已备份配置vim-cmd hostsvc/firmware/backup_config。4.1 执行 profile 更新核心命令# 关键命令用 esxcli 更新整个 profile而非单个 VIB esxcli software profile update \ -d file:///tmp/esxui-bundle \ -n ESXi-6.7.0-12086396-standard # 预期输出耗时 3–8 分钟 # [InstallationError] ... (if failed) # or success message ending with Update completed successfully.逻辑说明esxcli software profile update会按index.xml定义的依赖顺序自动处理 VIB 安装、旧版卸载、服务注册、配置文件生成。它比vib install更智能是处理 bundle 的唯一正确方式。参数-d指向 depot 路径-n指定 profile 名二者缺一不可。4.2 安装后必做的三件事① 重启管理服务强制生效# 重启 hostd主机服务和 rhttpproxyHTTPS 代理 /etc/init.d/hostd restart /etc/init.d/rhttpproxy restart # 等待 30 秒检查状态 /etc/init.d/hostd status # 应显示 running /etc/init.d/rhttpproxy status # 应显示 running② 检查 WebUI 服务进程# esxui 后端由 vsphere-ui 服务管理检查其状态 ps aux | grep vsphere-ui # 正常应看到类似/usr/lib/vmware/vsphere-ui/bin/vsphere-ui --config /etc/vmware/vsphere-ui/config.yml # 检查 nginx前端 Web 服务器是否监听 443 netstat -tuln | grep :443 # 应看到 nginx 进程绑定 0.0.0.0:443③ 验证 WebUI 静态资源是否加载# WebUI 前端文件默认放在 /usr/lib/vmware/vsphere-ui/webapps/ ls -l /usr/lib/vmware/vsphere-ui/webapps/ui/ # 应有 index.html, assets/, js/, css/ 等目录 # 若为空说明安装未完成或路径错误常见于挂载路径写错提示若ps aux | grep vsphere-ui无输出不要立刻重装先查日志tail -50 /var/log/vmware/vsphere-ui/vsphere-ui.log常见原因是python36初始化失败见避坑章。5. 避坑指南五个血泪经验换来的「翻车现场」复盘装这个 bundle我至少在三台不同型号的服务器上翻过车。以下是真实发生、反复验证过的 5 个高频问题按「现象 → 原因 → 解决」结构整理每一条都救过命。5.1 现象esxcli software profile update报错No matching profile found原因挂载时-n参数写的 profile 名与index.xml中定义的不一致或上传的 bundle 目录结构损坏如index.xml被意外修改、payloads/缺失。解决cat /tmp/esxui-bundle/index.xml | grep profile name精确复制 profile 名ls -l /tmp/esxui-bundle/确认index.xml和payloads/存在且非空先esxcli software sources profile remove -n 旧名清理错误挂载再重新add。5.2 现象安装成功但https://IP/ui显示503 Service Unavailable原因vsphere-ui服务启动失败最常见是python36模块缺失或权限错误/usr/lib/vmware/vsphere-ui/bin/vsphere-ui无执行权限。解决chmod x /usr/lib/vmware/vsphere-ui/bin/vsphere-uichown root:root /usr/lib/vmware/vsphere-ui/ -R手动启动并看日志/usr/lib/vmware/vsphere-ui/bin/vsphere-ui --config /etc/vmware/vsphere-ui/config.yml 21 | tail -20。5.3 现象vsphere-ui进程存在但页面空白F12 控制台报Failed to load resource: net::ERR_CONNECTION_REFUSED原因rhttpproxy未正确将/ui路径代理到vsphere-ui的本地端口默认localhost:5090。解决检查代理配置cat /etc/vmware/rhttpproxy/config.xml | grep -A5 ui确认location path/ui desthttps://127.0.0.1:5090/ui/存在且端口正确若不存在手动添加并重启rhttpproxy/etc/init.d/rhttpproxy restart。5.4 现象安装后df -h显示/bootbank使用率 100%主机无法重启原因bundle 安装过程中ESXi 尝试将新内核模块写入/bootbank但空间不足导致写入中断残留临时文件占满空间。解决cd /bootbank ls -lt | head -20找出最近生成的*.mod或*.o临时文件rm -f *.mod.* *.o.*谨慎只删带时间戳的临时文件esxcli software vib remove -n python36卸载冲突的旧版释放空间重启前务必df -h /bootbank确认 ≥10% 空闲。5.5 现象esxcli software profile update卡住超过 10 分钟SSH 连接中断原因ESXi 在解压大量 VIB 时内存不足尤其 8GB 内存以下的老旧主机触发 OOM Killer 杀死esxcli进程。解决安装前执行esxcli system settings kernel set -s vmkfstoolsMaxHeapSizeMB -v 512增大内核工具堆内存临时关闭非必要服务/etc/init.d/syslog stop、/etc/init.d/vpxa stop改用串口控制台iDRAC/iLO操作避免 SSH 断连若已卡死强制重启后先esxcli software sources profile remove清理再重试。6. 验证与巡检打开浏览器前的最后五道关卡装完不是终点而是运维的起点。真正的验证不是点开https://IP/ui看到登录页就结束而是确保它稳定、可管理、可回滚、可监控。以下是我每次部署后必做的五步巡检覆盖功能、安全、性能、灾备四个维度。6.1 功能验证登录、导航、核心操作闭环测试打开 Chrome/FirefoxEdge 有时兼容性差访问https://YOUR_ESXI_IP/ui输入 root 密码。✅第一关登录成功—— 页面无 JS 报错登录框渲染正常。✅第二关主机概览页加载—— 左侧菜单「Hosts and Clusters」→ 点击你的主机 → 右侧显示 CPU、内存、存储实时图表非静态图。✅第三关虚拟机操作验证—— 创建一个最小 VM1vCPU/512MB点击「Power On」观察状态变为「Powered On」且无报错弹窗。✅第四关存储浏览—— 左侧「Storage」→ 「Datastores」→ 点击任意 datastore → 右侧应列出所有.vmdk、.vmx文件且可右键「Browse Files」。✅第五关网络配置—— 「Configure」→ 「Networking」→ 「Virtual switches」→ 能看到 vSwitch0 及其端口组且可编辑 VLAN ID无需保存仅验证读取权限。提示若某一项失败立即打开浏览器开发者工具F12切换到「Console」和「Network」标签页。Console中的Uncaught ReferenceError指向前端 JS 加载失败检查/usr/lib/vmware/vsphere-ui/webapps/ui/js/Network中 404 表明静态资源路径错误检查 nginx 配置。6.2 安全加固关闭不必要端口与服务WebUI 默认启用全部功能但生产环境需最小化暴露# 1. 确认仅开放必需端口443 是必须的其他可关 esxcli network firewall ruleset list | grep -E (ssh|snmp|ftp|telnet) # 若 ssh 仅用于维护可设为仅允许管理网段esxcli network firewall ruleset set -r sshServer -e true # 2. 禁用 vsphere-ui 的调试模式防止信息泄露 sed -i s/debug: true/debug: false/g /etc/vmware/vsphere-ui/config.yml # 3. 重启服务使配置生效 /etc/init.d/vsphere-ui restart6.3 性能基线记录安装前后关键指标WebUI 会增加约 300–500MB 内存占用和 5–10% CPU 常驻负载。建立基线便于后续排障# 安装前记录执行一次 echo Pre-install ; vmstat 1 5 | tail -1; free -h; uptime # 安装后 5 分钟记录执行一次 echo Post-install ; vmstat 1 5 | tail -1; free -h; uptime # 对比重点 # - free -h 中 available 列下降是否 500MB # - vmstat 中 ididle是否持续 80%正常应 90% # - uptime 负载值load average是否突增正常应 1.06.4 灾备验证一键回滚能力实测离线 bundle 的最大价值是「可逆」。验证回滚流程是否真能用# 1. 记录当前 profile安装后 profile 名会变 esxcli software profile get # 2. 回滚到原厂 profile如 ESXi-6.7.0-15820000-standard esxcli software profile update -d https://hostupdate.vmware.com/software/VUM/PRODUCTION/main/vmw-depot-index.xml -n ESXi-6.7.0-15820000-standard # 3. 重启后验证 WebUI 是否消失原生 Host Clienthttps://IP/host/是否恢复 # 若回滚成功说明 bundle 安装未破坏系统底层可放心使用。注意回滚需外网访问hostupdate.vmware.com若无外网需提前下载原厂 ISO 并挂载为 depotesxcli software sources profile add -d /vmfs/volumes/iso/ESXi67u3.iso。6.5 日志巡检建立长期监控习惯WebUI 的健康完全依赖日志。我每天晨会第一件事就是扫一眼# 核心日志位置每天检查一次 tail -20 /var/log/vmware/vsphere-ui/vsphere-ui.log tail -20 /var/log/vmware/rhttpproxy/rhttpproxy.log tail -20 /var/log/vmware/hostd.log | grep -i ui\|vsphere # 关键词预警出现即告警 # - OSError: [Errno 12] Cannot allocate memory → 内存不足 # - Connection refused → vsphere-ui 未启动或端口冲突 # - Permission denied → 文件权限错误chown root:root -R /usr/lib/vmware/vsphere-ui # - SSL handshake failed → 证书问题重生成/usr/lib/vmware/vsphere-ui/bin/vsphere-ui --gen-cert从那以后我每次部署 ESXi WebUI都强制走一遍这五步巡检——不是为了炫技而是因为某次跳过「灾备验证」结果 bundle 更新后主机无法进 BIOS花了 3 小时重刷 USB 启动盘。希望帮到你。本文还有配套的精品资源点击获取

ESXi 6.x 离线安装 WebUI：esxui.vib 依赖与 vsphere-ui 部署全解

相关推荐

SQLite3静态编译包：解决嵌入式与容器环境依赖冲突

具身智能基础模型：多模态融合与物理常识建模

MinerU2.5-Pro文档解析工具：高效处理非结构化数据

更多资讯

Android应用拉黑功能设计与实现要点

JavaScript重写《植物大战僵尸》核心逻辑与性能优化

Blender MCP + Three.js：智慧仓储数字孪生实战

5分钟搭建React原型：pnpm与Vite项目骨架实践

ChatGPT Plus/Pro高错误率事件深度解析：模型路由与资源编排故障

直流无刷电机AX BY CZ绕组划分真相：不是垂直轴线而是电角度相带

今日更新

AI辅助技术栈评估：提升研发决策效率60%

从生成Token到直接决策：Jev如何重塑AI Agent工程实践

32G统一内存跑大模型：内存账、TPS实测与端云分流

本周精选

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

基于DRV8818与STM32的双极步进电机驱动方案实战解析

DRV8818PWPR+PIC18F45K80双极步进电机控制方案实战

本月热门

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

基于DRV8818与STM32的双极步进电机驱动方案实战解析

DRV8818PWPR+PIC18F45K80双极步进电机控制方案实战

读完文章，想聊聊您的网站？