Việc cập nhật UniFi Network Controller thường xuyên là yếu tố quan trọng để đảm bảo bảo mật, độ ổn định và khả năng tương thích—đặc biệt với các hệ thống đang vận hành trên Ubuntu Server. Một controller lỗi thời có thể gây ra các vấn đề như không adopt được thiết bị, thiếu tính năng mới hoặc tồn tại lỗ hổng bảo mật.

Trong bài viết này, TSF sẽ hướng dẫn bạn cách cập nhật UniFi Network Controller trên Ubuntu một cách an toàn và đúng chuẩn, dựa trên các best practice mà System Administrator thường áp dụng. Hướng dẫn phù hợp cho lab, văn phòng nhỏ và hệ thống doanh nghiệp.

🎯 Vì sao nên cập nhật UniFi Network Controller?

✅ Nhận các bản vá bảo mật và sửa lỗi quan trọng
✅ Cải thiện độ ổn định và hiệu suất hệ thống
✅ Đảm bảo tương thích với thiết bị UniFi và firmware mới
✅ Trải nghiệm giao diện và tính năng UniFi mới nhất

📌 Cập nhật định kỳ giúp hạn chế sự cố phát sinh trong quá trình vận hành và nâng cấp firmware thiết bị.

🧰 Yêu cầu trước khi thực hiện

Trước khi bắt đầu, hãy đảm bảo bạn có:

🔹 Ubuntu Server (khuyến nghị 18.04 / 20.04 / 22.04 LTS)
🔹 UniFi Network Controller đã được cài đặt sẵn
🔹 Quyền truy cập SSH hoặc console vào server
🔹 Tài khoản có quyền sudo
🔹 Kiến thức cơ bản về dòng lệnh Linux

⚠️ Lưu ý quan trọng trước khi cập nhật

⚠️ Luôn sao lưu cấu hình UniFi trước khi nâng cấp
⚠️ Tránh thực hiện cập nhật trong giờ làm việc
⚠️ Đảm bảo server có kết nối Internet ổn định
⚠️ Không ngắt quá trình cập nhật khi đang chạy

📌 Việc cập nhật bị gián đoạn có thể khiến dịch vụ UniFi Controller gặp lỗi.

🛠️ Các bước cập nhật UniFi Network Controller trên Ubuntu

🔹 Bước 1: Kết nối vào Ubuntu Server

➡️ Đăng nhập server qua SSH hoặc terminal cục bộ:

🔹 Bước 2: Sao lưu cấu hình UniFi (Khuyến nghị)

➡️ Thực hiện backup trực tiếp từ giao diện UniFi Web UI:

• Vào Settings → System → Backup

• Tải về file backup mới nhất

📌 File backup này giúp bạn khôi phục nhanh nếu quá trình cập nhật xảy ra sự cố.

🔹 Bước 3: Cập nhật các gói hệ thống Ubuntu

➡️ Làm mới danh sách package và nâng cấp hệ thống:

🔹 Bước 4: Kiểm tra và cập nhật UniFi Repository (nếu cần)

➡️ Đảm bảo repository chính thức của UniFi đã được cấu hình:

📌 Bước này giúp hệ thống luôn nhận được phiên bản UniFi Network Controller mới nhất.

🔹 Bước 5: Nâng cấp UniFi Network Controller

➡️ Chạy lệnh sau để tiến hành cập nhật:

⏳ Hệ thống sẽ tự động tải và cài đặt phiên bản UniFi Controller mới nhất hiện có.

🔹 Bước 6: Kiểm tra trạng thái dịch vụ UniFi

➡️ Kiểm tra service sau khi cập nhật:

✅ Đảm bảo trạng thái hiển thị active (running)

🔎 Kiểm tra sau khi cập nhật

Sau khi hoàn tất, hãy thực hiện các bước sau:

✔️ Truy cập UniFi Web UI qua trình duyệt
✔️ Xác nhận phiên bản UniFi Controller đã được cập nhật
✔️ Kiểm tra trạng thái thiết bị (Connected)
✔️ Test nhanh kết nối mạng cơ bản

📌 Các thiết bị UniFi sẽ tự động reconnect, không cần adopt lại.

🧠 Một số lỗi thường gặp & cách xử lý

🔧 UniFi Controller không chạy sau khi cập nhật:

• Kiểm tra log: /usr/lib/unifi/logs/server.log

• Kiểm tra phiên bản Java có tương thích hay không

🔧 Không truy cập được Web UI:

• Kiểm tra firewall (port mặc định: 8443)

• Restart service: sudo systemctl restart unifi

🧠 Kết luận

Việc cập nhật UniFi Network Controller trên Ubuntu là một tác vụ định kỳ nhưng cực kỳ quan trọng để duy trì tính ổn định, bảo mật và khả năng mở rộng của hệ thống UniFi. Chỉ cần thực hiện đúng các bước trong bài viết, bạn có thể nâng cấp controller an toàn, kiểm soát được rủi ro và hạn chế downtime.

Với bất kỳ hệ thống UniFi nào—từ lab cho tới production—update controller nên là một phần trong checklist bảo trì tiêu chuẩn.