TẠI SAO KHÔNG THỂ ADOPT THIẾT BỊ UNIFI VÀO CONTROLLER?

Lỗi không adopt được là một trong những vấn đề phổ biến nhất khi triển khai hệ thống UniFi. Thiết bị vẫn có nguồn, vẫn xuất hiện trong danh sách thiết bị tìm thấy, nhưng không thể “nhận” (adopt) vào UniFi Controller.

Nguyên nhân chính thường nằm ở kết nối mạng, cấu hình inform hoặc thiết bị chưa được reset sạch.

🔍 6 NGUYÊN NHÂN CHÍNH

1. Khác lớp mạng (Subnet / VLAN) Controller và Access Point (AP) không nằm cùng dải IP (subnet). Controller không “nhìn thấy” được thiết bị để adopt.

Minh họa:

Ví dụ: Controller: 192.168.1.x AP: 192.168.10.x ❌ → Không adopt được.

2. Firewall / Router chặn kết nối Các port cần thiết bị chặn bởi firewall. Các port quan trọng:

• 8080 (inform)
• 3478 (STUN)
• 10001 (discovery)

Minh họa: Gói tin từ AP bị firewall chặn → không đến được Controller.

3. Sai địa chỉ Inform AP đang trỏ inform về địa chỉ Controller cũ hoặc địa chỉ đã thay đổi. Đây là lỗi rất phổ biến khi sử dụng lại thiết bị cũ.

AP → inform: 192.168.0.5 (cũ) ❌ Controller hiện tại: 192.168.1.100

4. AP chưa được reset (vẫn ghi nhớ Controller cũ) Thiết bị vẫn “nhớ” Controller trước đó → không cho phép adopt vào Controller mới.

5. Firmware / Version không tương thích Phiên bản UniFi Controller quá mới hoặc quá cũ so với firmware của AP → gây lỗi “Adoption Failed” hoặc “Disconnected”.

6. DNS sai hoặc không resolve được Controller Khi dùng domain (ví dụ: unifi.domain.local), AP không resolve được tên miền → không kết nối.

✅ CÁCH KHẮC PHỤC THEO THỨ TỰ (Chuẩn kỹ thuật)

Bước 1: Đảm bảo cùng một mạng

• Controller và AP phải nằm cùng subnet (ví dụ: cùng dải 192.168.1.x).
• Nếu khác subnet:
• Sử dụng DHCP Option 43
• Hoặc áp dụng L3 Adoption

Bước 2: Set lại Inform (Bước quan trọng nhất) SSH vào AP và chạy lệnh sau:

Bash

set-inform http://<IP_Controller>:8080/inform

Ví dụ:

Bash

set-inform http://192.168.1.100:8080/inform

Sau khi chạy lệnh → quay lại UniFi Controller và nhấn Adopt.

Bước 3: Reset thiết bị về mặc định Nếu vẫn không được:

• Nhấn giữ nút Reset trên AP khoảng 10–15 giây cho đến khi đèn nháy.
• Đợi AP khởi động lại (Factory Default).

Bước 4: Kiểm tra Firewall và mở Port Mở các port sau trên Firewall/Router:

• 8080 (bắt buộc)
• 3478
• 10001 (discovery)

Bước 5: Kiểm tra trạng thái trong Controller Thiết bị phải hiển thị Pending Adoption. Nếu hiện Adoption Failed → kiểm tra lại lệnh set-inform và port.

Bước 6: Cập nhật Firmware và Controller

• Update firmware cho AP
• Update UniFi Network Application/Controller lên phiên bản mới nhất

🖼️ SƠ ĐỒ QUY TRÌNH ADOPT THÀNH CÔNG

AP → Cùng mạng + Inform đúng + Port mở → Trạng thái Pending Adoption → Nhấn Adopt → Thành công

🎯 KẾT LUẬN

Hơn 90% lỗi không adopt được UniFi xuất phát từ 3 nguyên nhân chính:

• Sai địa chỉ Inform
• Khác subnet / mạng
• Thiết bị chưa reset

Cách xử lý nhanh và hiệu quả nhất: Reset AP → Set-inform → Adopt lại

Áp dụng đúng thứ tự các bước trên sẽ giúp bạn khắc phục hầu hết các trường hợp lỗi adopt.