Việc cài đặt UniFi Network Controller trên Ubuntu Server là một trong những cách ổn định và tối ưu nhất để quản lý, giám sát các thiết bị mạng Ubiquiti UniFi như Access Point, Switch và Gateway. UniFi Controller cung cấp giao diện web mạnh mẽ, cho phép cấu hình tập trung, theo dõi trạng thái thiết bị và quản lý toàn bộ hệ thống mạng chỉ trong một nơi duy nhất.

Trong bài viết này, bạn sẽ được hướng dẫn từng bước chi tiết cách cài đặt UniFi Network Controller trên Ubuntu Server 20.04 (áp dụng tương tự cho 22.04 với lưu ý MongoDB). Toàn bộ quy trình được xây dựng theo chuẩn IT tutorial, đảm bảo:

• ✅ Câu chữ rõ ràng, dễ đọc, đúng kỹ thuật

• ✅ Bố cục mạch lạc, dễ theo dõi

• ✅ Chuẩn SEO, phù hợp đăng website & chia sẻ

• ✅ Giữ nguyên 100% technical flow và code

Sau khi hoàn tất, bạn sẽ có một UniFi Controller hoạt động đầy đủ, sẵn sàng để adopt và quản lý hệ thống mạng cho home lab, doanh nghiệp nhỏ hoặc môi trường enterprise.

📌 Môi trường & yêu cầu

• Ubuntu Server 20.04 LTS (khuyến nghị)

• Quyền sudo / root

• Kết nối Internet

• Thiết bị UniFi (AP, Switch, Gateway)

🔧 Step 1: Cài đặt Java (UniFi hỗ trợ Java 8 hoặc 11)

UniFi Controller yêu cầu Java để hoạt động. Trong hướng dẫn này, chúng ta sử dụng OpenJDK 11 – phiên bản ổn định và được khuyến nghị.

sudo apt update && sudo apt upgrade -y
sudo apt install openjdk-11-jre-headless -y

👉 Sau khi cài đặt xong, hệ thống đã sẵn sàng để chạy UniFi Controller.

🗄️ Step 2: Thêm MongoDB Repository

UniFi Network Controller yêu cầu MongoDB phiên bản 3.6 – 4.4 (tùy theo phiên bản UniFi).

Nếu Ubuntu của bạn chưa có MongoDB phù hợp, hãy thêm repository chính thức của MongoDB 4.4:

wget -qO - https://www.mongodb.org/static/pgp/server-4.4.asc | sudo apt-key add -

echo "deb [ arch=amd64 ] 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

📦 Step 3: Cài đặt MongoDB 4.4

Tiến hành cài đặt MongoDB:

sudo apt install mongodb-org -y

⚠️ Lưu ý quan trọng với Ubuntu 22.04:

• MongoDB 4.4 không được hỗ trợ chính thức

• Cần patch thủ công hoặc cài MongoDB thông qua Docker

Sau khi cài đặt MongoDB, hãy khởi động và kiểm tra trạng thái dịch vụ:

sudo systemctl enable mongod
sudo systemctl start mongod
sudo systemctl status mongod

👉 Đảm bảo MongoDB đang ở trạng thái active (running) trước khi sang bước tiếp theo.

🌐 Step 4: Cài đặt UniFi Network Controller

Tải file cài đặt UniFi Controller (.deb) mới nhất từ trang chính thức:
👉 https://ui.com/download/unifi (chọn Debian/Ubuntu)

Ví dụ với phiên bản cụ thể:

wget https://dl.ui.com/unifi/9.3.43/unifi_sysvinit_all.deb
sudo dpkg -i unifi_sysvinit_all.deb
sudo apt -f install -y

👉 Lệnh apt -f install sẽ tự động xử lý các dependency còn thiếu.

✅ Step 5: Kiểm tra dịch vụ & truy cập UniFi Controller

Kiểm tra trạng thái UniFi service:

sudo systemctl status unifi

Nếu service đang chạy, bạn có thể truy cập giao diện web UniFi Controller thông qua trình duyệt:

https://<Ubuntu_machine_IP>:8443

Ví dụ:

https://192.168.16.177:8443

👉 Tại đây, bạn chỉ cần làm theo Initial Setup Wizard để:

• Tạo tài khoản quản trị

• Cấu hình site

• Adopt thiết bị UniFi

🎯 Kết luận

Với các bước trên, bạn đã cài đặt thành công UniFi Network Controller trên Ubuntu Server một cách ổn định và bảo mật. Giải pháp này đặc biệt phù hợp cho:

• 👨‍💻 IT Administrator

• 🌐 Network Engineer

• 🧪 Home Lab

• 🏢 Doanh nghiệp cần UniFi Controller self-hosted

UniFi Controller trên Ubuntu mang lại hiệu suất cao, khả năng kiểm soát tốt và hoàn toàn chủ động trong việc quản lý hệ thống mạng Ubiquiti.

👉 Chúc bạn triển khai thành công và quản lý hệ thống UniFi hiệu quả 🚀