UniFi - 如何安装和升级 UniFi Network Controller 软件


概述


本文介绍如何在各种平台上升级 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 的选项。

3. 点击 Download,阅读完条款后,请单击  “I Accept” 

4. 复制 URL。

5. SSH 或打开控制台到准备安装  UniFi Network Controller 软件的设备。

6.切换到/ tmp /目录。

cd /tmp/

7. 使用wget下载复制的 URL,按 Enter 键。

wget PASTE_THE_URL_HERE
注意:此时,.deb 文件将下载到 / tmp /目录。下载速度取决于当前网络。 

8. 下载完成后,使用  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

10. 该过程完成后,命令提示符将返回到输入。此时 UniFi Network Controller 软件应已成功升级或安装。

11. 要访问 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 文件将下载到指定的文件夹位置。下载速度取决于当前网络。

5. 如果您有启用 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 文件将下载到选定的文件夹位置。下载速度取决于当前网络。

5. 关闭 UniFi Network Controller 软件.

6. 打开 UniFi.pkg 安装。

7. 如果安装成功,您将看到 The installation was successful

8. 要访问控制器,请打开浏览器窗口并访问:

 https://<IP_of_Controller_host>:8443

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


相关文章


回到顶部

UniFi - 修复 UniFi Controller 数据库

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

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

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