概述


本文介绍如何在各种平台上升级 UniFi Network Controller 软件。除了一些注意事项之外,安装和升级的过程几乎相同。请按照以下步骤进行安装和升级。

注意事项和要求:

本文介绍了在 macOS,Windows,Windows Server 以及基于 Debian 的 Linux(Ubuntu,Mint 等)上的安装和升级步骤。有关 UniFi Cloud Key Controller 的说明,请参阅 本文

目录


  1. 查看当前控制器版本
  2. 最低系统配置和推荐系统配置
  3. 在基于 Debian 的 Linux 系统上安装或升级 UniFi Network Controller
  4. 在 Windows 上安装或升级 UniFi Network Controller
  5. 在 macOS 上安装或升级 UniFi Network Controller
  6. 相关文章

查看当前控制器版本


回到顶部

要查看 UniFi Network Controller 软件的最新稳定版本,请在此处下载 。

警告: 请勿尝试在较新的软件版本上安装老版本软件。内部有数据库保护措施,会阻止控制器启动(如果安装完成)。

最低系统配置和推荐系统配置


回到顶部

这些是 UniFi Network Controller 软件最佳运行的 最低 系统要求。在安装之前请您先了解 UniFi Network Controller 软件的发行说明,它介绍了所有注意事项。可以在“ 下载”页面中找到发行说明的链接以及相应的软件版本,也可以在 UniFi 更新博客中找到过去的发行说明。

Operating System:

  • Linux
    • Ubuntu Desktop / Server 16.04
    • Debian 9 “Stretch”
  • Windows
    • Windows 10
    • Windows Server 2016
  • macOS
    • Mavericks 10.9, 10.10 Yosemite, 10.11 El Capitan, 10.12 Sierra, 10.13 High Sierra, 10.14 Mojave, 10.15 Catalina.

CPU: x86-64 Processor (Intel / AMD x64 Processors)*

内存: 2GB *

网络: 100Mbps 有线以太网*

硬盘: 至少 10GB 可用空间(推荐 20GB 或更多)

Java: Java 运行环境(JRE)8。5.11.47 之后版本的 UniFi Network Controller 软件未附带 Java 8,因此需要您自行安装。UniFi Network Controller 软件不支持 Java 9。

浏览器: Google Chrome

MongoDB: 3.2 或更高版本 (安装包提供 Mongo:默认安装为2.4.14(仅适用于 macOS 和 Windows))

*注意: 实际的存储,CPU,内存和网络速度要求将取决于许多因素,包括控制器管理的 UniFi 设备的数量,客户端的数量,已启用的功能以及数据保留设置。对于数据库修复,您需要准备当前数据库大小的可用空间再加上 2GB。

在基于 Debian 的 Linux 系统上安装或升级 UniFi Network Controller


回到顶部

注意: 在尝试升级之前,如果升级失败或需要降级,最好先进行当前备份。
CLI: 访问命令行界面(CLI)。您可以通过使用SSH客户端连接Linux主机或通过从Linux GUI打开控制台来实现。
  1. 打开下载页面。
  2. 选择 UniFi ,然后在“SOFTWARE**”** 部分,找到最新的适用于 **Debian / Ubuntu Linux** 的选项。

  1. 点击 Download,阅读完条款后,请单击 “I Accept”
  2. 复制 URL。
  3. SSH 或打开控制台到准备安装 UniFi Network Controller 软件的设备。
  4. 切换到 /tmp/目录。
cd /tmp/
  1. 使用 wget 下载复制的 URL,按 Enter 键。
wget PASTE_THE_URL_HERE
注意: 此时,.deb 文件将下载到 / tmp /目录。下载速度取决于当前网络。
  1. 下载完成后,使用 dpkg 来解压缩 .deb 文件并安装新的 Controller 版本。
 sudo dpkg -i unifi_sysvinit_all.deb
注意: 应该使用上面引用的文件名。如果不是,则可以从 wget 命令输出中引用文件名 。运行 dpkg 命令时,请记住位于 / tmp/目录中,否则它将在 / home /目录中查找文件。 在此期间,UniFi Network Controller 软件无法处理任何请求。客户端数据仍将通过设备。

9.升级时: 在安装过程中,请确保您有足够的内存,然后在出现提示,询问您是否有足够的备份时。选择YES

安装时: 可能会出现有关依赖性问题的消息。输入以下命令,然后按 Enter 键:

 sudo apt-get install -f
  1. 该过程完成后,命令提示符将返回到输入。此时 UniFi Network Controller 软件应已成功升级或安装。
  2. 要访问 UniFi Network Controller 软件,请打开浏览器并访问以下网址:
  https://<IP_of_Controller_host>:8443

如果 UniFi Network Controller 服务正在运行,则软件应显示一个网页。

用户提示: 其他可能有用的命令是:

如果没有出现网页提示,通过以下命令启动 UniFi: sudo service unifi start

要停止 UniFi 服务: sudo service unifi stop

重新启动 UniFi 服务: sudo service unifi restart

要查看 UniFi 服务的状态,请输入以下命令: sudo service unifi status


在 Windows 上安装或升级 UniFi Network Controller


回到顶部

注意: 在尝试升级之前,如果升级失败或需要降级,最好先进行当前备份。
  1. 打开下载页面。
  2. 选择 UniFi ,然后在“SOFTWARE**”** 部分,找到最新的适用于 Windows的选项。如果需要指导,请参见上面 Debian 部分中的截图。
  3. 点击 Download,阅读完条款后,请单击 “I Accept”
  4. 选择 Download File.
注意: 此时,.exe 文件将下载到指定的文件夹位置。下载速度取决于当前网络。
  1. 如果您有启用 UniFi Network Controller 软件,您可以在系统任务栏.找到它并关闭。
注意: 在此期间, UniFi Network Controller 软件无法处理任何请求。客户端数据仍将通过设备。

6.打开 .exe 文件并安装。 7.安装完成后,您可以打开 UniFi Network Controller 软件。 8.要访问控制器,请打开浏览器窗口并访问:

  https://<IP_of_Controller_host>:8443

如果 UniFi Network Controller 服务正在运行,则软件应显示一个网页。

9.控制器应处于运行状态。

对于如何升级以 Windows 服务运行的 UniFi Network Controller,您可以参考以下文章


在 macOS 上安装或升级 UniFi Network Controller


回到顶部

注意: 在尝试升级之前,如果升级失败或需要降级,最好先进行当前备份。

1.打开下载页面。 2. 选择 UniFi ,然后在“SOFTWARE**”** 部分,找到最新的适用于 macOS 的选项。如果需要指导,请参见上面 Debian 部分中的截图。 3. 点击 **Download**,阅读完条款后,请单击 **“I Accept”** 。 4. 选择 **Download File。**

注意: 此时,.pkg 文件将下载到指定的文件夹位置。下载速度取决于当网络。
  1. 关闭 UniFi Network Controller 软件.
  2. 打开 UniFi.pkg 安装。
  3. 如果安装成功,您将看到 The installation was successful.
  4. 要访问控制器,请打开浏览器窗口并访问:
  https://<IP_of_Controller_host>:8443

如果 UniFi Network Controller 服务正在运行,则软件应显示一个网页。


相关文章


回到顶部

UniFi - 修复 UniFi Controller 数据库

UniFi - 如何导出和删除设备数据

UniFi - 如何通过 SSH 手动更改 Cloud Key 的控制器版本

UniFi - 控制器、 Cloud Key 和其他设备的账户和密码