本文提供了在 Debian 或 Ubuntu 系统上，通过 APT（高级包工具）将 UniFi Network 应用程序更新到当前稳定版本的步骤。如果在本文描述的更新过程中遇到问题，请查看这篇社区文章提供的脚本，其中包括在 Ubuntu 18.04 和 16.04 以及 Debian 8/9 上的 UniFi Network 软件安装。

要求

如果通过 APT 更新 UniFi Network 应用程序，您需要创建源文件，或是用 Linux 文本编辑器 vi 或 nano 编辑现有 sources.list 文件。Repo结构应该是永久性的，但如果有任何变化，我们会在社区发布页面的 UniFi Network 软件版本信息中提示。

在更新 UniFi Network 应用程序之前，请确保您已经备份了 UniFi Network 数据库。您需确保用户拥有 sudo 权限。有关将用户添加到 sudo 列表 的详情，请参阅这篇 Debian 文章。

通过 APT 更新 UniFi Network 的步骤

1.首先使用以下命令，安装所需软件包

sudo apt-get update && sudo apt-get install ca-certificates apt-transport-https

2.使用以下命令，添加新的源列表

echo 'deb https://www.ui.com/downloads/unifi/debian stable ubiquiti' | sudo tee /etc/apt/sources.list.d/100-ubnt-unifi.list

3.添加 GPG 密钥。要添加 GPG 密钥，请使用下述两种方法之一（推荐方法 A）。使用以下命令时，假设您已安装 sudo 和 wget，有关 sudo 的更多信息可在此处找到，wget 可在此处找到。

用户提示：如果是 Ubuntu 18.04，在第 4 步安装 UniFi 之前，请运行以下命令。

wget -qO - https://www.mongodb.org/static/pgp/server-3.4.asc | sudo apt-key add -
echo "deb https://repo.mongodb.org/apt/ubuntu xenial/mongodb-org/3.4 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.4.list
sudo apt-get update

在这篇社区帖子中可以查看在 Ubuntu 16.04 和 18.04 上安装 UniFi Network 应用程序的示例。

（方法 A）将以下可信密钥安装到 /etc/apt/trusted.gpg.d

sudo wget -O /etc/apt/trusted.gpg.d/unifi-repo.gpg https://dl.ui.com/unifi/unifi-repo.gpg

（方法B）使用 apt-key。

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv 06E85760C0A52C50

4.安装升级 UniFi Network 应用。

注意：在某些发布版本中，在此步骤中可能会安装不兼容的 Java 版本。我们建议在继续此步骤之前运行以下命令，以限制 Ubuntu 自动安装 Java 11。如果您希望稍后撤消此操作，请将“hold”替换为“unhold”。

sudo apt-mark hold openjdk-11-*

使用以下命令安装和升级 UniFi Netwok 应用程序：

sudo apt-get update && sudo apt-get install unifi -y

5.此步骤非必须，主要取决于您的 Linux 版本，如果版本没有附带MongoDB，并且在他们的 repo 中不可用，那么请参阅 MongoDB 安装指南。您可以在此处找到 Ubuntu 的最新安装指南，或者在此处找到 Debian 的安装指南。我们推荐至少使用 MongoDB 2.6.10 版本。一些用户在更改后端后使用 MongoDB 3 也成功了。

6.UniFi Network 应用程序可以在计算机配置的本地或公共 IP 地址上访问，方法是在浏览器的导航栏中输入该 IP 地址（推荐使用 Chrome）。如果没有启动，请使用以下命令：sudo service unifi start。

其他命令：

停止 UniFi 服务：sudo service unifi stop
重启 UniFi 服务：sudo service unifi restart
查看 UniFi 服务状态：sudo service unifi status

我们强烈建议使用稳定版本。如果想要使用其他版本，请单击此处展开并查看状态及版本编号。

“测试版本”是指下一代版本，还没有公开发布。“稳定版本”是指当前发布版本，即 Ubiquiti 支持并在本文中描述的版本。“旧稳定版 “是指以前的稳定版，已经被新的、当前的稳定版取代。

版本状态	编号	存档编号
旧稳定版本	unifi-5.10	这些编号版本已存档，不再受支持
稳定版本	unifi-5.11	这些编号版本已存档，不再受支持
测试版本	*	unifi3, unifi4, unifi-5.3, unifi-5.4, unifi-5.5, unifi-5.6, unifi-5.7, unifi-5.8, unifi-5.9

*测试版本当前为空

日志文件位置

在进行故障排除时，日志文件必不可少，您可以在以下位置找到它们：

/usr/lib/unifi/logs/server.log
/usr/lib/unifi/logs/mongod.log

如果应用程序基于 Unix/Linux 运行，那么您将需要超级用户 (sudo) 权限才能访问这些日志文件。

用户须知&提示

由于用户协作，添加了这些注释。单击展开。
- 这篇社区帖子分享了一些在 Ubuntu 18.04 和 16.04 以及 Debian 8/9 上安装 UniFi Network 软件的脚本。
- 如果您在 VM 或无外设服务器中安装软件，可能会遇到熵问题。这可能导致服务启动缓慢/重新启动，也可能导致服务故障。解决方法是安装 haveged。这是相关教程的外部链接。
- 自 UniFi Network 版本 5.6.x 起，UniFi 服务不再以 root 身份运行。这意味着您不能绑定到特权端口 (<1024)。如果您尝试使用这些端口，应用程序将无法启动。
- 以下内容影响到 APT 1.5 以上的版本（Ubuntu 17.10 和 Debian Sid 或更新版本）。最近 apt-secure 手册页指出。"自 1.5 版以来，在 APT 继续应用该软件库的更新之前，需要确认发布文件中包含的关于该软件库的信息变化"，这意味着当执行从一个主要版本到下一个版本的更新时（例如5.5.x到5.6.x），apt-get 更新将导致错误。
  - 要解决此问题，请按以下方式运行命令：apt-get update --allow-releaseinfo-change
  - 如果您收到错误提示，指出该命令无法与其他选项结合使用，根据用户报告，您可以使用以下两个命令修复：键入 apt clean 并按回车键，然后键入 apt-get update 并回车。
- UniFi Network 应用程序安装在 Debian 和 Ubuntu 上时不会有 GUI，因为它是作为服务运行的。请使用服务命令来启动、停用和重新启动 UniFi Network 应用程序。
- 如果您在 DNS 服务器上看到以下错误，根据用户报告，可以通过强制系统使用 8.8.8.8 作为 DNS 服务器地址，而不是使用原有的 ISP。
- 目前 Ubiquiti 不支持 arm64，因此无法通过 repo 获得。为此需要下载和手动安装。
- 添加 GPG 密钥，方法 B：来源：外部链接。对于受限防火墙后面的用户，输入以下命令导入 GPG 密钥：
  
  apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 06E85760C0A52C50
- 由于依赖 Java 8，使用 UniFi Network 5.7.X 时可能需要一些额外的步骤。有关详细信息，请参阅此处。
- 命令 apt-get 适用于 16.04 之前的 Ubuntu 版本。

要求

通过 APT 更新 UniFi Network 的步骤

日志文件位置

用户须知&提示