我们推荐大部分用户启用自动更新。您可以自行设定 UniFi 部署中的设备何时自动检查并更新最新版本。

您可以在 UniFi OS 设置 中配置控制台和应用程序更新偏好。但请注意，自行架设的 UniFi Network 应用程序不提供自动更新。

UniFi Network 设备更新偏好在 Network 应用程序的 系统设置 中。由其他 UniFi 应用程序管理的设备会在各自的应用程序中设置自动更新。

通过 Web 应用程序手动更新 UniFi 设备

通过设备属性面板更新

用例：如果您想要为特定设备尝试抢先体验固件 Early Access 版本，或者想要在尝试后回到官方版本。

1.从 community.ui.com/releases 复制固件版本链接。

image1.png

2.将链接粘贴到 设备 属性面板的手动管理（Manages）地址栏中。

image2.png

通过 Network 应用缓存更新

用例：如果您偏好在 Network 应用程序中下载和存储更新固件，以便其他设备使用它们，这样就无需设备从网上下载重复的更新固件。这是在管理大量类似的 UniFi 设备的减少带宽占用的理想解决方案。也适用于在 UniFi 设备的管理网络被禁止互联网访问的情况。

Network 应用中的 系统设置 可以缓存设备更新文件。缓存更新后，您可以打开设备页面点击 更新。

注意：当您将光标悬停在可更新的固件上时，将出现 Cache 缓存选项。

image3.png

通过 SSH 更新

注意：通过 SSH 更新不是官方支持方式，可能会阻碍 UniFi OS 控制台的正常运行。只有在技术支持人员的建议下才执行该操作。 它适用于以下特定的情况，比如：

  • 此前尝试传统更新都失败了。如果使用 SSH 更新成功，那么可以验证之前的故障是由于不正确的网络配置引起。详情请参阅 设备更新故障排除。
  • 没有发现或者无法采用 UniFi Network 设备，因为设备预安装了旧版本的固件。
  • 无法设置 UniFI OS 控制台， 因为预安装的 UniFi OS 版本过旧。

UAP/USW（接入互联网）

  1. 从 community.ui.com/releases 复制更新链接。
  2. 通过 SSH 连接到您的设备。
  3. 运行以下命令：
    • upgrade paste_download_link_here
    • Ex
    • upgrade https://dl.ui.com/unifi/firmware/UAL6/5.60.1.12923/BZ.mt7621_5.60.1+12923.210416.1641.bin

UAP/USW（没有接入互联网）

  1. 从 community.ui.com/releases 下载所需的更新固件。
  2. 使用以下 SCP 命令将文件从工作站复制到设备的 /tmp 文件夹中。需要使用兼容 SCP 的应用程序（例如，macOS 和 Linux 上的终端，Windows 上的 PuTTY/PowerShell）。
    • scp /folder_path/firmwarefile.bin <user>@<IP of device>:/tmp/fwupdate.bin
    • Ex
    • scp /Users/alexpro/Desktop/BZ.mt7621_5.60.1+12923.210416.1641.bin Alex@192.168.1.219:/tmp/fwupdate.bin
  3. 出现提示时输入您的 SSH 密码。
  4. 通过 SSH 连接到您的设备。
  5. 运行以下命令：
    • syswrapper.sh upgrade2 &

UDM/UDM Pro/UXG Pro（接入互联网）

  1. 从 community.ui.com/releases 复制更新链接。
  2. 通过 SSH 连接到您的设备。
  3. 运行以下命令：
    • ubnt-upgrade paste_download_link_here
    • Ex
    • ubnt-upgrade https://fw-download.ubnt.com/data/udm/7675-udmpro-1.12.22-36b5213eaa2446aca8486f0b51e64cd3.bin

UDM/UDM Pro/UXG Pro（没有接入互联网）

  1. 从 community.ui.com/releases 下载所需的固件更新。
  2. 使用以下 SCP 命令将文件从工作站复制到设备的 /mnt/data 文件夹中。需要使用兼容 SCP 的应用程序（例如，macOS 和 Linux 上的终端，Windows 上的 PuTTY/PowerShell）。
    • scp /folder_path/firmwarefile.bin <user>@<IP of device>:/mnt/data/fwupdate.bin
    • Ex
    • scp /Users/alexpro/Desktop/7675-udmpro-1.12.22-36b5213eaa2446aca8486f0b51e64cd3.bin Alex@192.168.1.219:/mnt/data/fwupdate.bin
  3. 出现提示时输入您的 SSH 密码。
  4. 通过 SSH 连接到您的设备。
  5. 运行以下命令：
    • ubnt-upgrade /mnt/data/fwupdate.bin

UCK G2, UCK G2 Plus, UDM SE, UDR, UDW, UNVR, UNVR Pro（接入互联网）

  1. 从 community.ui.com/releases 复制更新链接。
  2. 通过 SSH 连接到您的设备。
  3. 运行以下命令：
    • ubnt-systool fwupdate paste_download_link_here
    • Ex
    • ubnt-systool fwupdate https://fw-download.ubnt.com/data/unifi-dream/dd49-UDR-2.4.10-cd3afa000ebf4a4fb15374481539961c.bin

UCK G2, UCK G2 Plus, UDM SE, UDR, UDW, UNVR, UNVR Pro（没有接入互联网）

  1. 从 community.ui.com/releases 下载所需的固件更新。
  2. 使用以下 SCP 命令将文件从工作站复制到设备的 /tmp 文件夹中。需要使用兼容 SCP 的应用程序（例如，macOS 和 Linux 上的终端，Windows 上的 PuTTY/PowerShell）。
    • scp /folder_path/firmwarefile.bin <user>@<IP of device>:/tmp/fwupdate.bin
    • Ex
    • scp /Users/alexpro/Desktop/dd49-UDR-2.4.10-cd3afa000ebf4a4fb15374481539961c.bin
  3. 出现提示时输入您的 SSH 密码。
  4. 通过 SSH 连接到您的设备。
  5. 运行以下命令：
    • ubnt-systool fwupdate /tmp/fwupdate.bin

USG(接入互联网)

  1. 从 community.ui.com/releases 复制更新链接。
  2. 通过 SSH 连接到您的设备。
  3. 运行以下命令：
    • upgrade paste_download_link_here
    • Ex
    • upgrade https://dl.ui.com/unifi/firmware/UGW3/4.4.56.5449062/UGW3.v4.4.56.5449062.tar

USG(没有接入互联网)

  1. 从 community.ui.com/releases 下载所需的固件更新。
  2. 重命名文件：upgrade.tar
  3. 使用以下 SCP 命令将文件从工作站复制到 USG 的 /home/<user> 文件夹中。需要使用兼容 SCP 的应用程序（例如，macOS 和 Linux 上的终端，Windows 上的 PuTTY/PowerShell）。
    • scp /folder_path/upgrade.tar <user>@<IP of device>:/home/<user>/upgrade.tar
    • Ex
    • scp /Users/alexpro/Desktop/upgrade.tar Alex@192.168.1.1:/home/Alex/upgrade.tar
  4. 出现提示时输入您的 SSH 密码。
  5. 通过 SSH 连接到您的设备。
  6. 运行以下命令：
    • sudo syswrapper.sh upgrade upgrade.tar

手动更新 Network 应用程序

  1. 从 community.ui.com/releases 下载所需的应用程序更新。
  2. 通过 SSH 连接到您的设备。
  3. 运行以下命令 （仅限 UDM/UDM Pro）：
    • unifi-os shell
  4. 移除原来的安装文件：
    • rm /tmp/unifi_sysvinit_all.deb &> /dev/null
  5. 使用下载链接，将新的应用程序版本存储在设备上：
    • curl -o "/tmp/unifi_sysvinit_all.deb" <network application link.deb>
    • Ex
    • curl -o "/tmp/unifi_sysvinit_all.deb" https://dl.ui.com/unifi/6.2.26-a79cb15f05/unifi_sysvinit_all.deb
  6. 下载完毕后，安装新版本：
    • apt-get install -y /tmp/unifi_sysvinit_all.deb
  7. 安装后，删除下载的文件：
    • rm /tmp/unifi_sysvinit_all.deb

更新处于损坏状态的设备

在极少数情况下，设备可能会停止运行。UniFi AP 可以使用 TFTP 恢复进行更新。这只应在 AP 完全停止运行时使用，作为提交 RMA 前的最后方法。UniFi OS 控制台和网关可以使用修复模式进行更新。只有在设备的 LCM 屏幕上出现提示时，才使用该选项。