如何在VPS上安装Unifi控制器？
| 项目 |
详细信息 |
| 系统要求 |
Ubuntu 20.04/22.04, Debian 11⁄12, CentOS 7⁄8 |
| 内存要求 |
最小2GB，推荐4GB以上 |
| 存储空间 | 最少10GB可用空间 |
| 网络端口 | 8080(设备通信), 8443(管理界面), 8880(HTTP重定向) |
| Java版本 | OpenJDK 8或11 |
| MongoDB | 版本3.6或更高 |
如何在VPS上安装Unifi控制器？
安装前的准备工作
在开始安装Unifi控制器之前，需要确保您的VPS满足基本要求并完成必要的准备工作。
系统要求检查
首先确认您的VPS运行的是支持的操作系统，推荐使用Ubuntu 20.04/22.04 LTS或Debian 11/12。检查系统版本可以使用以下命令：
## cat /etc/os-release
更新系统包
确保系统包是最新版本：
sudo apt update && sudo apt upgrade -y
主要安装步骤
以下是安装Unifi控制器的主要步骤概览：
| 步骤 |
操作内容 |
预计时间 |
| 1 |
安装Java运行环境 |
5-10分钟 |
| 2 |
安装MongoDB数据库 |
10-15分钟 |
| 3 |
下载并安装Unifi控制器 |
15-20分钟 |
| 4 | 配置防火墙规则 | 5分钟 |
| 5 | 访问并完成初始设置 | 10分钟 |
详细安装流程
步骤1：安装Java运行环境
操作说明：
Unifi控制器需要Java运行环境支持，推荐安装OpenJDK 11。
使用工具提示：
使用apt包管理器安装Java。
sudo apt install openjdk-11-jdk -y
验证安装：
## java -version
步骤2：安装MongoDB数据库
操作说明：
Unifi控制器使用MongoDB存储配置数据，需要安装合适版本的MongoDB。
使用工具提示：
导入MongoDB官方GPG密钥和仓库。
wget -qO - https://www.mongodb.org/static/pgp/server-4.4.asc | sudo apt-key add -
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/4.4 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.4.list
sudo apt update
sudo apt install mongodb-org -y
启动MongoDB服务：
sudo systemctl start mongod
sudo systemctl enable mongod
### 步骤3：下载并安装Unifi控制器
操作说明：
从Ubiquiti官方仓库下载并安装Unifi控制器软件。
使用工具提示：
添加Ubiquiti官方GPG密钥和软件仓库。
echo 'deb https://www.ui.com/downloads/unifi/debian stable ubiquiti' | sudo tee /etc/apt/sources.list.d/100-ubnt-unifi.list
sudo wget -O /etc/apt/trusted.gpg.d/unifi-repo.gpg https://dl.ui.com/unifi/unifi-repo.gpg
sudo apt update
sudo apt install unifi -y
步骤4：配置防火墙规则
操作说明：
开放Unifi控制器所需的网络端口。
使用工具提示：
使用ufw防火墙工具配置端口规则。
sudo ufw allow 8080/tcp # 设备通信端口
sudo ufw allow 8443/tcp # 管理界面端口
sudo ufw allow 8880/tcp # HTTP重定向端口
sudo ufw allow 8843/tcp # HTTPS重定向端口
sudo ufw allow 3478/udp # STUN服务端口
### 步骤5：访问并完成初始设置
操作说明：
通过Web浏览器访问Unifi控制器完成初始配置。
使用工具提示：
使用VPS的IP地址或域名访问管理界面。
## https://您的VPS-IP地址:8443
常见问题及解决方案
| 问题 |
原因 |
解决方案 |
| 无法访问8443端口 |
防火墙未正确配置或服务未启动 |
检查防火墙设置，确认unifi服务运行状态：sudo systemctl status unifi |
| Java版本不兼容 |
安装了不支持的Java版本 |
卸载当前Java，安装OpenJDK 11：sudo apt install openjdk-11-jdk |
| MongoDB连接失败 |
MongoDB服务未运行或权限问题 |
启动MongoDB服务：sudo systemctl start mongod，检查日志文件 |
| 内存不足错误 |
VPS内存配置过低 |
增加swap空间或升级VPS配置，创建swap文件：sudo fallocate -l 2G /swapfile |
| 证书错误警告 |
使用自签名证书 |
安装有效的SSL证书或导入受信任的CA证书 |
后续维护建议
安装完成后，建议定期备份控制器配置，监控系统资源使用情况，并及时更新软件版本以获得最新的功能和安全修复。
通过以上步骤，您应该能够在VPS上成功安装并运行Unifi控制器，实现对网络设备的集中管理。
发表评论