概览


本文介绍了如何升级或降级 UniFi 设备(AP、交换机、网关)的固件版本,包括通过 GUI 升级到最新版本,以及手动改变固件版本,无论是未发布的版本还是恢复到旧的固件版本。这篇文章不适用于更新 UniFi 操作系统控制台或 UniFi 网络软件安装。

注意事项和要求:

如果您打算使用与UniFi网络应用程序所提供的不同固件版本,请确保首先在网络应用中禁用自动升级功能。只要 UniFi 操作系统控制台或应用程序主机能够访问互联网,预定的升级将使固件恢复到内容分发网络(CDN)提供的版本。

目录


  1. 升级到最新的固件版本
  2. 通过 UniFi 网络应用程序手动更改固件
  3. 通过 SSH 使用本地升级更改固件版本
  4. 禁用自动升级
  5. 相关文章

升级到最新的固件版本


可以在 UniFi 网络应用程序的设备(Devices)选项卡中将设备升级到最新版本。 当有可用更新时,将鼠标悬停在每个设备上时其尾部会出现升级选项以及定位和重启选项(如果在列表视图模式中)。 如果使用网格视图,则会在每个设备的右上角出现一个小的升级图标。

mceclip0.png

还可以选择对无线设备进行滚动升级。 要使用此功能,请转到 设备 (Devices)选项卡并单击 无线(Wireless)。 屏幕右上角会出现一个按钮,如果列表中有任何无线设备有待升级,则会显示 开始滚动升级(Start Rolling Upgrade)的选项。

mceclip2.png

本文的其余部分介绍了当您不希望进行简单的设备升级时应该如何更改固件,也许您可能需要旧版本或未发布的版本。 这可以方便地帮助您解决采用问题、故障排除或升级到正在开发的最新可用固件。 您也可以在 UniFi 设备上运行不同版本的固件。通常来说,每种类型的设备上会运行相同的版本,但在某些情况下,您可能想在特定站点上测试新固件,然后再将其推广到其他的站点(或多个站点)。


通过 UniFi 网络应用程序手动更改固件


可访问网络的设备

对于未采用的设备,将鼠标悬停在该设备上时,您将在应用程序的 设备(Devices)选项卡中看到升级选项,能够在采用设备之前执行升级操作。

对于任何已采用的 UniFi 设备,您都可以从设备属性窗口轻松升级或更改设备固件。 在 设备 (Devices)选项卡中单击设备以展开属性面板。 选择 配置(Config tab) > 管理设备(Manage Device) > 自定义升级(Custom Upgrade)

3.png

在此处,您可以输入新固件的下载链接。输入 Firmware.bin (或者 USG 的固件 .tar)可以在我们官方 下载页面 的固件部分或我们社区的发布部分中找到相应的版本。如果使用下载页面:

  1. 使用左边的菜单选择您的设备。
  2. 单击最新的可用固件。点击此固件可查看相关扩展信息。
  3. 点击 下载(Download)阅读并接受相关条款。
  4. 弹出的窗口将提供固件名称(如果升级 UAP 或 USW,请确认这是 firmware .bin文件,如果升级 USG,则应是 .tar文件)。可以点击下载按钮,或是直接复制 URL(下载链接)。
注意: 从固件版本 3.7.56 或更早版本升级时,在 URL 中使用 http:// 而不是 https://。 如果 https 升级失败,还建议使用 http:// 进行测试。
注意:在我们的 CDN 上使用指向固件二进制文件的链接时,UniFi 设备需要能够通过 DNS / 访问 WAN 网络来正确解析 IP 地址。 自定义升级也适用于本地托管的 FTP 或 HTTP 服务器。

无法访问网络的设备(缓存)


如果设备没有互联网接入,但 UniFi Network 应用程序有,那么一个很好的选择是缓存固件,通过 UniFi Network 应用程序直接提供固件以进行升级。当其他在线升级方法失败时,将缓存固件下载保存在应用程序中,从而对设备进行升级。

  1. 通过转至 设置(Settings) > 系统设置(System Settings) > 维护(Maintenance) > 更新(Update) > 设备固件缓存(Device Firmware Cache)并选择可用固件(Available Firmware) 选项卡来缓存固件。
  2. 将鼠标悬停在对应设备名称上查看可 缓存(Cache)固件。 点击缓存将固件下载到应用程序上。固件会添加到 已缓存固件(Cached Firmware)选项卡中。
  3. 确认固件现在位于已缓存固件选项卡中后,转到应用程序的 设备(Devices)页面。 点击需要升级固件的设备尾部的“升级”选项来进行升级。

通过 SSH 使用本地升级更改固件版本


UniFi AP 和 UniFi 交换机

可访问网络的设备

如果 UAP/USW 可连接网络,那么直接下载更新固件就可以(通过 URL 固件链接)安装升级。可以通过 SSH 连接 到设备,然后运行以下命令,将 URL 链接替换为在 下载页面 中找到的 URL 链接。找到固件文件后,单击下载,阅读并接受条款,复制此链接。 请确认您复制的是特定于您的设备(UAP、USW 等)的 firmware.bin 文件,而不是其他固件。

upgrade https://dl.ubnt.com/path/to/upgrade-vX.Y.Z.bin

执行此命令,设备会自动下载固件,升级并重启到新版本。


无法访问网络的设备

1.从我们的 下载页面 下载 firmware.bin 文件。 请确认您下载的是特定于您的设备(UAP、USW 等)的 firmware.bin 文件,而不是 UniFi 网络软件。

2.使用终端,例如 macOS/Linux 中的终端应用程序或 Windows 上的 PuTTY,发出以下命令将 .bin 文件传输到设备,并将其放在 UniFi 设备文件系统中。 请记住在运行命令之前进行适当的替换:

scp /foldername/firmwarefile.bin user@IP-of-UAP-or-Switch:/tmp/fwupdate.bin

下面是一个 UAP-FlexHD 的命令示例,固件版本为 4.0.80 文件已下载并保存在 Macbook Pro 的桌面上,其中 UAP 的 IP 地址为 192.168.1.219

scp /Users/alexpro/Desktop/BZ.mt7621.v4.0.80.10875.200111.1635.bin Alex@192.168.1.219:/tmp/fwupdate.bin

3.现在将提示您输入用于 SSH 访问的密码。 如果您不确定设备的 SSH 身份验证用户或密码,请查看本文

在您输入时,出于安全考虑,屏幕上不会出现任何字符。仔细输入正确的密码,然后单击 进入(Enter)。

4.然后通过 SSH 连接 到设备并发出以下命令以启动本地升级。

syswrapper.sh upgrade2 &
用户提示: 如果 SSH 升级时出现”无效固件”(Invalid Firmware) 错误,可能是安装版本不正确。 转到 tmp 文件夹并删除 fwupdate.bin ,然后再次尝试升级命令(请确保它位于应用程序中的正确文件夹中)。

适用于:UniFi Security Gateway / UniFi Security Gateway Pro


所有型号的 USG 都允许本地升级,不过它们使用的是 .tar 文件,而不是 AP和交换机使用的 .bin。本地升级有两种选择,一种是通过 HTTP 或 HTTPS(强烈推荐 HTTPS)下载,另一种是进行离线升级。


互联网升级

如果 USG 有互联网连接,最简单的方法是让它下载更新固件,然后再安装。通过 SSH 到 USG,运行以下命令,将 URL 链接替换为 下载页面 中对应链接。请确认您下载的是针对您设备的固件 .tar 文件,而不是 UniFi 网络软件。

upgrade https://dl.ui.com/path/to/upgrade-vX.Y.Z.tar

它将下载此固件,升级并重新启动为新版本。


离线更新

如果 USG 尚未连接到网络,您可以从 下载页面 将与您的 USG 型号对应的 tar 文件下载到您的本地系统,然后使用 SCP 将其复制到 USG。

scp /foldername/upgrade-vX.Y.Z.tar user@<IP-of-USG>:~/upgrade.tar

然后通过 SSH 连接到 USG,并运行以下命令以使用该文件执行升级。

sudo syswrapper.sh upgrade upgrade.tar

适用于:UniFi Dream Machine / UniFi Dream Machine Pro


互联网升级:通过 SSH 连接到 UDM 设备,然后运行以下命令,将 URL 链接替换为在 下载页面 中找到的 URL。请确认您下载的是特定于您的 UDM 型号的固件 .bin 文件,而不是 UniFi 网络软件。

此命令将直接下载固件,然后使用它来升级您的 UDM-Pro。 如果您有 firmware.bin 文件的下载链接,那么这个方法是快速简单的:

ubnt-upgrade https://fw-download.ubnt.com/data/udm/e649-udmpro-1.6.6-0761feeda3504456bdb80e09527ab56a.bin

离线升级:下载 firmware.bin 文件并使用 SCP 将其放置在设备(本示例中为 UDM-Pro)中。 然后执行 ubnt-upgrade 命令,命令后跟固件的存储路径。 建议存储在 /mnt/data/ 中,命令如下(用实际固件文件名替换“firmware-name.bin”):

ubnt-upgrade /mnt/data/firmware-name.bin

禁用自动升级


UniFi AP

当您启用“自动升级 AP 固件”选项时,所有 AP 都会在您升级 UniFi 网络软件版本时升级。 如果您要将其中一台设备的固件更改为非已发布版本,您将需要禁用自动升级以避免它升级到该版本。

  1. 为此,请转至 设置(Settings) > 站点(Site) > 服务(Services) 部分。
  2. 确保未选中 自动升级(Automatic Upgrades – Automatically upgrade AP firmware) 复选框。 根据 UniFi 网络版本的不同,选项描述可能略有不同。

UniFi Dream Machine 和 UniFi Dream Machine Pro

UniFi Dream Machine 还具有启用或禁用自动固件升级的选项,但这些是在设备管理平台本身中配置的,可通过在浏览器栏中键入设备的 IP 地址进行访问。

运行 v1.5.X

在 UDM 管理用户界面中,转到设置并将 更新频率(Update Frequency)更改为 禁用(Disabled)。

4.png

运行 UniFi 操作系统

  1. 进入 设置(Settings)>高级(Advanced)
  2. 自动固件更新(Automatic Firmware Updates)更改为 禁用(Disabled)。

5.png


相关文章