UCK G2 Plus 应用装不上？先升 UniFi OS 固件，再用隐身模式

Updated on

一、故障现象

在 UniFi Cloud Key Gen 2 Plus（UCK G2 Plus）上，UniFi OS 停留在 5.1.31。此时 Network 应用怎么都无法升级，Protect 应用也装不上去 —— 安装进度条走了一点点就消失，任务像被 "掐断" 了一样。重试多少次都一样。

二、常规排障为什么无效

遇到应用装不上，常规三板斧是：

  1. 重启设备（拔电重启）；
  2. 系统重置（在设置里执行重置）；
  3. 长按机身 reset 键恢复出厂。

这三招全部试过之后问题依旧，说明故障不在应用配置层—— 配置清空重来也不影响结果。真正的病灶在两个更底层的位置：一是负责承载应用安装的 UniFi OS 系统层，二是你操作管理页所用的浏览器会话层。

三、根因分析

  • 系统层：UniFi OS 5.1.31 这套固件本身存在应用安装 / 升级任务的执行缺陷。应用安装由系统后台服务完成，旧固件下任务管道异常，安装进程一启动就被中断或回滚，表象就是 "进度走一点就消失"。这种问题重置救不了，必须升级固件本身。
  • 前端层：浏览器缓存、旧 Cookie 和扩展插件（尤其是广告拦截类）会干扰管理页与后端之间的 API 会话轮询，前端拿不到真实任务状态，于是误判安装失败或中断。

四、解决步骤（按顺序做）

第 1 步：升级 UniFi OS 固件

  1. 用浏览器打开 UCK 管理页（https://UCK的内网IP地址，或通过 unifi.ui.com 登录）；
  2. 进入 System（系统）→ Updates（更新） 页面；
  3. 检查系统更新，发现新版本 5.1.33 后点击升级；
  4. 等待固件下载、升级并自动重启，全程不要断电；
  5. 升级完成后确认系统版本号已变为 5.1.33。

第 2 步：用浏览器隐身模式重装应用

  1. 打开 Chrome / Edge 的隐身窗口（快捷键 Ctrl+Shift+N / Ctrl+Shift+P）—— 隐身窗口不带旧缓存和 Cookie，且默认不加载大部分扩展；
  2. 重新登录 UCK 管理页；
  3. 进入 Applications（应用） 页面；
  4. 先安装 Protect，再对 Network 执行升级；
  5. 进度条开始后不要刷新页面、不要切换标签页，耐心等它走完；
  6. 确认两个应用状态均为 "已安装 / 已更新"。

五、经验总结

  • 遇到应用装不上，先查 UniFi OS 有没有新版本，有就先升固件，比反复重启重置高效得多；
  • 操作 UniFi 管理页全程用隐身模式，能一次性排除缓存和扩展造成的假性中断；
  • 别在装有广告拦截扩展的普通窗口里折腾 UCK——"进度走一点就消失" 很可能就是它造成的；
  • 常规重启 / 重置只针对配置层故障，系统层 bug 只能靠固件更新解决。

六、备注

  • 这次能修复这个bug 巧在ubnt的官方有了新的unifi os的更新 不然感觉就变成了死循环,我还以为设备出现了故障无法修复.也无法安装应用了.所以当你的设备无法安装app的时候 可以等下一次unifi os升级的时候 先升级一下系统固件,再去安装应用.