UniFi - 更改 UniFi 设备的固件


 概览


本文介绍如何更改 UniFi 设备上的固件,包括通过 GUI 这种常见方式升级到最新版本的说明,以及手动更改固件版本,无论是未发布的版本还是恢复到较旧的固件版本。

注意事项和要求:
如果您计划使用与 UniFi 控制器提供的固件版本不同的固件版本,请确保先在 Controller 中  禁用自动升级 。预定升级还会将固件恢复为内容分发网络(CDN)提供的版本。值得注意的是,为了能够从 CDN 获取新信息,Controller 必须能够访问互联网。
 

目录


  1. 简单升级到最新固件版本
  2. 如何通过 Controller Web UI 更改固件
  3. 如何通过 SSH 本地升级更改固件
    1. UniFi AP 和 UniFi 交换机
    2. USG 和 USG Pro
  4. 如何禁用自动升级
  5. 相关文章

简单升级到最新固件版本


回到顶部

一个简单的设备升级到最新的版本可以在控制器内完成,在 设备 部分。当有可用的升级时,升级选项将显示在每个设备的“  操作” 列下。

还可以选择对 AP 进行滚动升级。为此,请转到 “ 设备”  选项卡,然后单击 “ AP”。  屏幕右上方会出现一个按钮,如果列表中有待挂起的升级 UAP ,则提供 “ 开始滚动升级 ” 选项  。

本文的其余部分将描述如何在用户不希望进行简单的设备升级时更改固件。您可能需要一个旧版本或非发布版本。这可以方便地帮助解决采用问题、进行故障排除,或者如果还没有新的控制器,可以简单地升级到最新可用的固件。可以在任何 UniFi 设备上运行不同版本的固件。通常,您会在 AP 或交换机上运行相同的版本,但在某些情况下,您可能只想在某个位置测试新固件,然后再将其部署到站点范围(或多个站点)。


如何通过 Controller Web UI 更改固件


回到顶部

适用于:   UniFi AP/UniFi 交换机/ UniFi 安全网关/UniFi 安全网关专业版

对于未采用的 AP 和交换机,您将在 Controller 的  Devices  选项卡中看到一个升级按钮。即使在采用设备之前,您也可以使用此选项,如果您在使用设备时遇到问题,这将特别有用。

对于任何采用的 UniFi 设备,您可以从设备属性窗口轻松升级或更改设备固件。在  Devices   选项卡中,单击 AP 的 Name/MAC 地址以展开 Properties 面板。选择  配置 选项卡 > 管理设备 > 自定义升级。

在本节中,您可以输入指向新固件版本的链接。固件可以在我们的官方下载页面上找到,或者在 发行说明或固件博客也可以找到

注意:从较旧的固件升级时,可能需要在URL中使用 http:// 而不是 https://。 
注意: 在我们的 CDN 上使用指向固件二进制文件的链接时,UniFi 设备需要能够通过 DNS 或访问互联网的方式,正确解析主机名。自定义升级也适用于本地托管的 FTP 或 HTTP 服务器。 

如何通过 SSH 本地升级更改固件


回到顶部

适用于:UniFi AP/UniFi 交换机


互联网升级

如果 UAP/USW 具有 Internet 连接,最简单的方法是让它下载更新文件,然后安装。通过 SSH 到设备,运行以下命令,将 URL 替换为实际的 USG 固件更新文件。

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

它将下载指定的文件并且升级,然后重新启动到新版本。

重要信息: 要执行本地固件更新,需要将 firmware.bin 文件的名称更改为 fwupdate.bin

Mac / Linux用户:

1.从我们的下载页面下载 firmware.bin 文件。

2.发出以下命令将文件名更改 firmware.bin fwupdate.bin ,并将其置于UniFi设备文件系统中。请记住在以下命令中进行适当的替换:

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

3.如果已从 下载页面 下载了固件文件  ,则路径必须更改为文件的已保存位置。上面的命令会将固件文件复制到所需的目录并重命名。

3.现在将提示您输入用于 SSH 登录的密码。在您输入密码时,出于安全目的,屏幕上不会出现任何字符。小心输入正确的密码,然后按 Enter 键。

4.然后通过 SSH 连接并输入以下命令以启动本地升级。

syswrapper.sh upgrade2 &

Windows 用户:

1.下载 WinSCP 程序。这将允许通过 SSH 的 SCP 会话与文件夹结构 GUI。使用 SSH 凭据登录 UniFi 设备。

2.从我们的 下载页面 下载 bin 文件。

3.通过拖放文件将 .bin 文件移动到设备的 /tmp/ 文件夹,将文件重命名为 fwupdate.bin。

4.通过SSH连接并输入以下命令以启动本地升级。

syswrapper.sh upgrade2 &

用户提示: 通过 SSH 升级时出现“无效固件”错误:可能是由于首先安装了错误的版本。通过转到 tmp 文件夹并首先删除 fwupdate.bin 然后再次尝试升级命令(确保它位于 Controller 中的正确文件夹中)来纠正此问题。

适用于:UniFi 安全网关/ UniFi 安全网关专业版


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

互联网升级

如果 USG 具有 Internet 连接,最简单的方法是让它下载更新文件,然后安装它。通过 SSH 到 USG,运行以下命令,将 URL 替换为实际的 USG 固件更新文件。

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

它将下载指定的文件并进行升级,然后重新启动到新版本。

离线升级

如果 USG 尚未连接到 Internet,您可以将 upgrade.tar 文件下载到本地系统,然后使用 scp 将其传送到 USG 中。

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

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

sudo syswrapper.sh upgrade upgrade.tar


如何禁用自动升级


回到顶部

当您启用“自动升级 AP 固件”选项时,所有接入点都会在您升级 Controller 软件版本时升级。如果要将其中一个设备的固件更改为已发布版本以外的设备,则需要禁用“自动升级”以避免其回滚到该公共版本。

1. 要执行此操作,请转到   “设置”>“站点”

2.   确保未选中 自动升级固件 的复选框 。因 Controller 版本不同,说法可能略有不同。 

Screen_Shot_2017-10-17_at_8.​​38.27_AM.png