WiFi RADIUS Full Windows
WiFi 802.1X cho khách hàng: Windows AD, DNS, NPS RADIUS, AD CS, UniFi Controller trên Ubuntu và cách test client.
Bối cảnh & Lý do triển khai
Một mật khẩu WPA2-Personal dùng chung cho cả công ty có ba điểm yếu: nhân viên nghỉ việc vẫn còn mật khẩu, không biết ai đang dùng mạng, và không thể thu hồi riêng từng người. WPA2/WPA3-Enterprise (802.1X) giải quyết bằng cách mỗi người đăng nhập bằng chính tài khoản Active Directory của họ: AP chỉ chuyển yêu cầu cho máy chủ RADIUS, máy chủ kiểm tra tài khoản và nhóm rồi mới cho vào mạng. Khóa tài khoản AD hoặc rút khỏi nhóm là mất WiFi ngay.
Bài này dựng kịch bản "Full Windows" mà nhiều doanh nghiệp Việt Nam đang chạy: Windows Server 2022 đảm nhiệm AD DS + DNS + AD CS + NPS (RADIUS), UniFi OS Server (chạy UniFi Network Application bên trong, đóng vai Controller) cài trên Ubuntu Server 24.04 LTS để quản lý AP, và test client Windows 11, Android, iOS. Kịch bản chạy trong domain độc lập wifilab.local (không đụng domain chính hoatranlabs.local của bài 25) với hai VM riêng VM281 và VM282, nằm ngoài 30 VM lõi của lab. Bài 40 sẽ lấy chính hạ tầng này để chuyển sang Full Linux (Samba AD DC + FreeRADIUS). Vì Samba 4.19.5 của Ubuntu 24.04 ở bài 40 chưa join được domain ở mức chức năng 2016, forest và domain wifilab.local ở bài này được khởi tạo ở mức Windows Server 2012 R2 (mục 1.4), không phải mức 2016 cao nhất của Windows Server 2022.
| Mục | Nội dung |
|---|---|
| Ứng dụng trong DN | WiFi nhân viên đăng nhập bằng tài khoản AD (802.1X), tự vào VLAN người dùng, thu hồi quyền bằng cách khóa tài khoản hoặc rút khỏi nhóm |
| Tác dụng chính | AD DS + DNS (danh tính), AD CS (chứng chỉ máy chủ RADIUS), NPS (RADIUS PEAP-MSCHAPv2 theo nhóm WiFi-Users), UniFi OS Server / Network Application (SSID, RADIUS profile) |
| Nếu không triển khai | Dùng một mật khẩu WPA2-Personal chung: không phân biệt người dùng, khó thu hồi, không có nhật ký đăng nhập theo tài khoản |
| Các service phụ thuộc vào đây | Bài 40 (chuyển kịch bản sang Full Linux), các AP UniFi và máy trạm WiFi của khách hàng |
Ngày cập nhật: 2026-10-15 (phiên bản phần mềm đã xác minh ngày 2026-10-15, xem bảng "Phiên bản phần mềm sử dụng" ở mục Tổng quan)
Người thực hiện: hoatv
Môi trường: HOATRANLABS – PVE 9.2.20 (domain WiFi riêng wifilab.local)
Danh sách máy chủ & IP liên quan
Bảng dưới liệt kê các máy chủ mà bài này tạo hoặc kết nối tới. Địa chỉ, VMID, VLAN và node lấy từ bảng quy hoạch chung của lab, dùng thống nhất cho cả bộ bài lab.
| Máy chủ | IP | VLAN · Node | Vai trò trong bài này |
|---|---|---|---|
| wifi-dc01 (Windows Server 2022: AD DS, DNS, NPS, AD CS) · VM281 | 10.11.65.52 | 65 (SRV) · node2 | Máy chủ của bài — Windows Server 2022 chạy AD DS, DNS, AD CS (Enterprise Root CA) và NPS (RADIUS 1812/1813) cho domain wifilab.local (mức chức năng forest/domain Windows Server 2012 R2). |
| unifi (UniFi OS Server) · VM282 | 10.11.65.53 | 65 (SRV) · node3 | Máy chủ của bài — UniFi OS Server 5.x (Network Application 10.x bên trong, chạy Podman 4.9.3) trên Ubuntu Server 24.04 LTS: UI 11443, inform 8080; khai báo RADIUS profile và SSID. |
| node2 (Proxmox VE) | 10.11.45.211 | 45 (MGMT) · cluster HOATRANHUB | Node Proxmox chứa VM281; tạo VM Windows (OVMF, q35, VirtIO) và đặt job backup VM tại đây. |
| node3 (Proxmox VE) | 10.11.45.212 | 45 (MGMT) · cluster HOATRANHUB | Node Proxmox chứa VM282; tạo VM Ubuntu Server 24.04 với CPU host (MongoDB trong UniFi cần AVX) tại đây. |
| pihole (Pi-hole DNS) · VM247 | 10.11.45.53 | 45 (MGMT) · node3 | Conditional forward wifilab.local về 10.11.65.52, bản ghi unifi.hoatranlabs.local, và là forwarder của DNS trên DC (bài 12). |
| FortiGate (firewall) | 10.100.100.1 | Quản trị 10.100.100.0/24 · thiết bị mạng | Gateway các VLAN 45/65/75; cho UDP 1812/1813 từ AP tới NPS, TCP 8080 và UDP 3478 tới unifi; cấp DHCP VLAN 75. |
| pbs01 (PBS Primary) · VM101 | 10.11.45.17 | 45 (MGMT) · node4 | Nhận backup VM281/VM282 (job PVE 01:30) và file-level của unifi bằng token vm-backup@pbs!unifi, namespace vm-unifi (bài 04). |
| prometheus (Prometheus + Alertmanager) · VM235 | 10.11.45.35 | 45 (MGMT) · node2 | Scrape node_exporter cổng 9100 của unifi (bài 15); wifi-dc01 là Windows nên không có node_exporter Linux. |
Gateway của mỗi VLAN là địa chỉ .1. Tên DNS nội bộ do Pi-hole phân giải (bài 12). Tên in đậm là hostname; FQDN = hostname + .hoatranlabs.local. Các AP UniFi nằm trong dải minh họa 10.11.45.128/28 (VLAN 45) và máy client WiFi là thiết bị tùy ý nên không liệt kê; wifi-dc01 thuộc domain wifilab.local, unifi thuộc hoatranlabs.local và không join domain.
Tổng quan kiến trúc
Theo chuẩn 802.1X có ba vai trò. Supplicant là thiết bị của người dùng (laptop, điện thoại). Authenticator là AP UniFi, chỉ làm "người gác cổng": chưa xác thực xong thì chỉ cho đi qua gói EAPOL. Authentication Server là NPS trên wifi-dc01, hỏi Active Directory để biết tài khoản có hợp lệ và thuộc nhóm WiFi-Users không. UniFi Controller không tham gia luồng xác thực: nó chỉ đẩy cấu hình (SSID, RADIUS profile) xuống AP.
+-----------------------------------------------------------------+
| Client WiFi: Windows 11 / Android / iOS |
| (supplicant) - vao VLAN 75 sau khi xac thuc |
+-----------------------------------------------------------------+
| 802.11 + EAPOL (EAP-PEAP)
v
+-----------------------------------------------------------------+
| UniFi AP = authenticator = RADIUS client |
| SSID HOATRAN-WIFI (WPA2/WPA3-Enterprise) |
| IP quan tri nam trong VLAN 45 (MGMT) |
+-----------------------------------------------------------------+
| |
| RADIUS UDP | inform TCP 8080
| 1812 auth / 1813 acct | STUN UDP 3478
v v
+-------------------------------+ +-------------------------------+
| wifi-dc01 (VM281) 10.11.65.52 | | unifi (VM282) 10.11.65.53 |
| NPS (RADIUS) <-> AD DS + DNS | | UniFi OS Server 5.x (Podman) |
| AD CS (cert), wifilab.local | | UI :11443, inform :8080 |
+-------------------------------+ +-------------------------------+
Luồng xác thực PEAP-MSCHAPv2 (một lần kết nối):
- Client chọn SSID
HOATRAN-WIFI, AP gửiEAP-Request/Identityqua EAPOL và client trả lời bằng tên người dùng (hoặc tên ẩn danh). - AP đóng gói thành RADIUS
Access-Request(cóEAP-Message,NAS-IP-Address,Called-Station-Id,NAS-Port-Type) và gửi thẳng tới NPS cổng UDP 1812. RADIUS client là từng AP, không phải Controller. - NPS so khớp Connection Request Policy rồi Network Policy (nhóm
WiFi-Users, NAS Port Type Wireless IEEE 802.11), sau đó dựng đường hầm TLS: NPS xuất trình chứng chỉ máy chủ do AD CS cấp, client kiểm tra chuỗi tin cậy và tên máy chủ. - Trong đường hầm, client chứng minh mật khẩu bằng MSCHAPv2; NPS xác minh với AD DS (cùng máy chủ) và trả
Access-Acceptkèm khóa phiên (MPPE) và tùy chọn thuộc tính VLAN. - AP và client bắt tay 4 bước (4-way handshake) để sinh khóa mã hóa, mở cổng và client xin DHCP ở VLAN 75. AP gửi RADIUS Accounting Start/Interim/Stop tới UDP 1813.
Cổng và luồng dữ liệu cần thông:
| Luồng | Từ → Đến | Cổng | Mục đích |
|---|---|---|---|
| RADIUS auth / accounting | AP (VLAN 45) → wifi-dc01 | UDP 1812 / 1813 | Access-Request, Accounting |
| Adopt / inform | AP (VLAN 45) → unifi | TCP 8080 | Controller và AP trao đổi cấu hình |
| STUN | AP → unifi | UDP 3478 | Thông tin trạng thái AP |
| Discovery | AP ↔ unifi | UDP 10001 | Chỉ tìm thấy AP khi cùng L2; khác VLAN thì dùng set-inform nên có thể không mở |
| Giao diện quản trị UniFi OS Server | Máy admin → unifi | TCP 11443 | Web UI và API (HTTPS) |
| DNS, Kerberos, LDAP, SMB, RPC | Máy domain → wifi-dc01 | 53, 88, 389, 445, 135, 49152–65535 | Chỉ cần khi client join domain wifilab.local |
| DNS chuyển tiếp | wifi-dc01 ↔ Pi-hole | TCP/UDP 53 | Forwarder và conditional forward |
Phiên bản phần mềm sử dụng (đã xác minh ngày 2026-10-15; số bản sẽ tăng theo thời gian, bài ghim bản này để các bước khớp nhau):
| Thành phần | Phiên bản dùng trong bài | Ghi chú |
|---|---|---|
| Windows Server (wifi-dc01) | Windows Server 2022 Datacenter Evaluation (180 ngày), cập nhật qua Windows Update | Giữ 2022 vì bài 40, xem ghi chú bên dưới |
| Mức chức năng forest / domain | Win2012R2 (Windows Server 2012 R2) | Cố ý đặt thấp hơn mức cao nhất của Windows Server 2022 (WinThreshold = 2016) vì bài 40 join Samba 4.19.5 của Ubuntu 24.04, xem hộp lưu ý bên dưới |
| Windows 11 (máy test) | 25H2 hoặc 26H2 | 26H2 phát hành 2026-09-29 theo đợt, gói kích hoạt nhỏ trên nền 25H2; cả hai đều chạy phần test của bài |
| Android / iOS | Bản hiện hành của máy | Tên menu khác nhau theo hãng và phiên bản |
| Ubuntu (unifi, VM282) | Ubuntu Server 24.04.5 LTS "Noble Numbat" | ISO ubuntu-24.04.5-live-server-amd64.iso (bản point mới nhất của dòng 24.04 trên releases.ubuntu.com ngày 2026-10-15); hỗ trợ chuẩn tới 04/2029; kernel 6.8, systemd 255, netplan 1.0, chrony 4.5, sudo cổ điển |
| UniFi OS Server | 5.1.42 (Linux x64, 2026-09-10) | Bản .deb cũ (repo apt + MongoDB) đã không còn được Ubiquiti khuyến nghị; Ubiquiti yêu cầu Ubuntu 24.04 trở lên |
| UniFi Network Application | 10.x bên trong UniFi OS Server | 10.6.106 (2026-09-15) là bản mới nhất trên trang tải xuống; cập nhật qua Control Plane |
| Podman | 4.9.3 (gói noble 4.9.3+ds1-1ubuntu0.1) | Đúng bằng mức tối thiểu 4.9.3 của Ubiquiti; kèm slirp4netns 1.2.1, passt, uidmap (kho universe) |
| AppArmor | Gói apparmor của noble (AppArmor 4) | Giới hạn user namespace không đặc quyền bật mặc định trên 24.04; gói đã có sẵn profile cho podman, crun, slirp4netns, rootlesskit (xem mục 3.4) |
| node_exporter (unifi) | 1.12.1 (2026-07-14) | Cài bằng script bài 15 (Bước 5), script đã ghim 1.12.1 |
| proxmox-backup-client-static (unifi) | Gói từ repo pbs-client, suite trixie (PBS 4.x) | Bản static dành cho Linux x86-64 hiện đại; tài liệu PBS chỉ nêu Debian là hệ đã thử, Ubuntu 24.04 cần kiểm lại trên máy thật |
| Pi-hole | v6 (misc.dnsmasq_lines) | Như bài 12 |
| FortiGate (FortiOS) | CLI mức chung | Cần kiểm lại tên service, interface và cú pháp trên bản FortiOS đang chạy |
wifi-dc02) vào chính domain này, và chưa có tài liệu Samba nào xác nhận hỗ trợ schema hoặc mức chức năng của Windows Server 2025 (tài liệu về Samba chỉ nêu việc nâng mức chức năng lên 2016 và schema lên 88, tương ứng Windows Server 2019/2022). Nếu khách hàng KHÔNG có kế hoạch chuyển sang Samba thì Windows Server 2025 thay thế được: các cmdlet AD DS, AD CS và NPS của bài dùng giống nhau, ISO Evaluation ở trang Evaluation Center của Microsoft. Cần lưu ý hai điểm khác theo tài liệu Microsoft: DC mới dựng trên Windows Server 2025 bắt buộc LDAP signing theo mặc định (ứng dụng bind LDAP không ký trên cổng 389 sẽ bị từ chối), và có thêm mức chức năng Windows Server 2025 với schema cao hơn (91 so với 88 của Windows Server 2022, theo ghi nhận trên Microsoft Q&A, cần kiểm lại trên máy thật).ad dc functional level từ 4.19.0, mặc định 2008_R2, nhận các giá trị 2008_R2, 2012, 2012_R2, 2016, và man page 4.19 ghi các tính năng ở mức 2016 (Claims, Dynamic Access Control) còn chưa hoàn chỉnh. Tài liệu Tranquil-IT chỉ nêu "Samba 4.20 trở lên hỗ trợ schema MSAD 2016 với forest level 2016", còn Andrew Bartlett (Samba Team, 05/2024) mô tả Samba 4.20 là bản triển khai FL 2016 "đáng tin cậy". Vì gói Ubuntu 24.04 dừng ở 4.19.5 nên bài chọn mức 2012 R2: mức này vẫn đủ cho mọi thứ bài làm (AD DS, DNS, AD CS, NPS, GPO; 2016 chỉ thêm PAM của MIM và vài cải tiến Kerberos/NTLM cho tài khoản smart card), và là mức Samba 4.19 có thể khai báo qua ad dc functional level = 2012_R2 khi join. Chưa có tài liệu chính thức của Samba xác nhận riêng cặp "Samba 4.19.5 join domain Windows Server 2022 mức 2012 R2", nên bước join ở bài 40 cần kiểm lại trên máy thật. Muốn lên mức 2016 sau này thì phải dùng Samba từ 4.20 trở lên (cách làm ở bài 40, mục "Nâng mức chức năng lên 2016 sau này"); đừng chạy Set-ADForestMode/Set-ADDomainMode lên 2016 khi vẫn còn DC Samba 4.19.Thông tin VM
| Thông số | wifi-dc01 | unifi |
|---|---|---|
| VMID | 281 | 282 |
| Hostname | wifi-dc01 | unifi |
| IP | 10.11.65.52/24 | 10.11.65.53/24 |
| Gateway | 10.11.65.1 | 10.11.65.1 |
| VLAN | 65 (VLAN_SRV) | 65 (VLAN_SRV) |
| OS | Windows Server 2022 Datacenter Evaluation (Desktop Experience) | Ubuntu Server 24.04.5 LTS |
| vCPU | 2 | 2 |
| RAM | 4 GB | 4 GB |
| Disk | 80 GB + 30 GB (vm-ceph) | 40 GB (vm-ceph) |
| Phân bổ node | node2 | node3 |
| Ports | 53, 88, 389, 445, 1812/1813 | 22, 8080, 11443, 3478 |
| DNS | 127.0.0.1 (sau khi promote), trước đó 10.11.45.53 | 10.11.45.53 |
| FQDN | wifi-dc01.wifilab.local | unifi.hoatranlabs.local (không join domain) |
| Vai trò | AD DS, DNS, AD CS (Enterprise Root CA), NPS | UniFi OS Server (Network Application, Controller) |
| URL | RDP wifi-dc01.wifilab.local | https://unifi.hoatranlabs.local:11443 |
Thông số chung của kịch bản:
| Thông số | Giá trị |
|---|---|
| Domain / NetBIOS | wifilab.local / WIFILAB |
| SSID | HOATRAN-WIFI (WPA2/WPA3-Enterprise), VLAN client 75 (10.11.75.0/24, gateway FortiGate 10.11.75.1) |
| RADIUS profile (UniFi) | wifilab-radius → server 10.11.65.52, auth 1812, acct 1813 |
| Nhóm AD | WiFi-Users, WiFi-Admins |
| User mẫu | wifi.user1, wifi.user2 (WiFi-Users); wifi.admin (WiFi-Admins + WiFi-Users) |
| Máy test | WIN11-CLIENT01 (laptop thật), điện thoại Android / iOS |
| Shared secret mẫu | RadiusSecret@2024! (đổi khi triển khai thật) |
| AD CS | Enterprise Root CA WIFILAB-ROOT-CA, template WiFi-NPS-Server |
Điều kiện tiên quyết
Tệp cài đặt cần chuẩn bị (upload vào storage local của đúng node sẽ tạo VM, vì ISO nằm cục bộ theo node):
| Tệp | Tải từ | Dùng cho |
|---|---|---|
| ISO Windows Server 2022 Evaluation (chọn bản 64-bit ISO, 180 ngày) | https://www.microsoft.com/en-us/evalcenter/evaluate-windows-server-2022 | VM281 trên node2 |
ISO VirtIO (virtio-win.iso) | https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.iso | Driver đĩa và card mạng cho VM281 |
ISO Ubuntu Server 24.04.5 LTS (ubuntu-24.04.5-live-server-amd64.iso) | https://releases.ubuntu.com/24.04/ | VM282 trên node3 |
| Installer UniFi OS Server for Linux (x64), bản 5.1.42 | https://ui.com/download/software/unifi-os-server (link tải đổi theo bản, tải trực tiếp trên VM282 ở mục 3.4) | VM282: UniFi OS Server |
Hạ tầng đã có: Pi-hole VM247 (bài 12, container pihole), PBS pbs01 (bài 04), Prometheus VM235 (bài 15), FortiGate 10.100.100.1 là gateway của các VLAN 45, 65, 75. Một AP UniFi (U6/U7 hoặc tương đương) cấp nguồn PoE, cổng switch của AP là trunk: VLAN 45 untagged (native, cho IP quản trị của AP) và VLAN 75 tagged (cho SSID). Nếu thiếu tag VLAN 75 trên cổng này, client kết nối WiFi được nhưng không nhận DHCP.
Chính sách FortiGate cần có (mọi policy tắt NAT vì chỉ định tuyến giữa các VLAN nội bộ; tên interface thay theo thiết bị của bạn):
| # | Nguồn | Đích | Dịch vụ | Mục đích |
|---|---|---|---|---|
| 1 | VLAN 45 (dải IP của các AP) | wifi-dc01 10.11.65.52 | UDP 1812, 1813 | AP gửi Access-Request và Accounting |
| 2 | VLAN 45 (AP) | unifi 10.11.65.53 | TCP 8080, UDP 3478 | Adopt và inform; thêm UDP 10001 chỉ khi AP và unifi cùng L2 |
| 3 | Máy quản trị | unifi 10.11.65.53 | TCP 11443, TCP 22 | Web UI UniFi OS Server và SSH |
| 4 | Máy quản trị | wifi-dc01 | TCP 3389 (RDP), TCP 5985 (WinRM) | Quản trị Windows |
| 5 | wifi-dc01 | Pi-hole 10.11.45.53 | TCP/UDP 53 | Forwarder của DNS trên DC |
| 6 | Pi-hole 10.11.45.53 | wifi-dc01 | TCP/UDP 53 | Conditional forward wifilab.local |
| 7 | wifi-dc01, unifi | Internet | UDP 123, TCP 80/443 | NTP, cập nhật Windows và Ubuntu, tải installer và cập nhật UniFi, kho pbs-client |
| 8 | Prometheus 10.11.45.35 | unifi | TCP 9100 | node_exporter |
| 9 | unifi | pbs01 10.11.45.17 | TCP 8007 | Backup file-level lên PBS |
| 10 | VLAN 75 (chỉ khi client join domain) | wifi-dc01 | DNS 53, Kerberos 88, LDAP 389, SMB 445, RPC 135 và 49152–65535 | Join domain, đăng nhập domain, nhận GPO |
Ví dụ tạo policy 1 bằng FortiOS CLI (dịch vụ RADIUS là service định nghĩa sẵn UDP 1812–1813 trong FortiOS; bài chỉ dùng CLI mức chung và chưa kiểm trên một bản FortiOS cụ thể, nên cần kiểm lại tên service, tên interface, địa chỉ đối tượng và cú pháp trên bản FortiOS đang chạy):
config firewall address
edit "wifi-dc01"
set subnet 10.11.65.52 255.255.255.255
next
edit "UniFi-AP-Range"
set subnet 10.11.45.128 255.255.255.240
next
end
config firewall policy
edit 0
set name "AP-to-NPS-RADIUS"
set srcintf "VLAN45"
set dstintf "VLAN65"
set srcaddr "UniFi-AP-Range"
set dstaddr "wifi-dc01"
set action accept
set schedule "always"
set service "RADIUS"
set logtraffic all
next
end
10.11.45.128/28 (từ .128 đến .143) cho AP, ví dụ AP đầu tiên là 10.11.45.131. Hãy đặt IP tĩnh hoặc DHCP reservation trên FortiGate cho mỗi AP: NPS nhận diện RADIUS client theo IP nguồn của gói tin, đổi IP AP là NPS bỏ gói.
Cài đặt Windows Server 2022 — Active Directory và DNS
Tạo VM281 trên node2 · Cài Windows Server 2022 · Driver VirtIO, địa chỉ IP và tên máy
Mục tiêu của phần này: có một Domain Controller wifi-dc01 cho domain wifilab.local với DNS chạy tốt, các nhóm và user mẫu, giờ chuẩn, và Pi-hole biết chuyển truy vấn wifilab.local về DC.
1.1 Tạo VM281 trên node2
Upload ISO Windows Server 2022 lên node2 (Datacenter → node2 → local → ISO Images → Upload, đặt tên Windows_Server_2022_Eval.iso) và tải ISO VirtIO bằng SSH:
# Chạy trên node2 (ssh [email protected])
wget -O /var/lib/vz/template/iso/virtio-win.iso \
https://fedorapeople.org/groups/virt/virtio-win/direct-downloads/stable-virtio/virtio-win.iso
ls -lh /var/lib/vz/template/iso/
Cách 1: Web UI Proxmox (GUI)
- Đăng nhập Proxmox Web UI → chọn Node: node2 → nhấn Create VM.
- Điền lần lượt từng tab:
| Tab | Thiết lập |
|---|---|
| General | VM ID 281, Name wifi-dc01, bỏ tick Start after created |
| OS | ISO Image Windows_Server_2022_Eval.iso; Guest OS Type Microsoft Windows, Version 11/2022/2025 |
| System | Machine q35, BIOS OVMF (UEFI), tick Add EFI Disk (Storage vm-ceph, Pre-Enroll keys ☑), SCSI Controller VirtIO SCSI single, Qemu Agent ☑, không cần TPM |
| Disks | SCSI 0: Storage vm-ceph, 80 GiB, Cache Write back, Discard ☑, IO thread ☑ (ổ C:); Add thêm SCSI 1: vm-ceph, 30 GiB (ổ sao lưu System State) |
| CPU | Sockets 1, Cores 2, Type host |
| Memory | 4096 MiB |
| Network | Bridge vmbr0, VLAN Tag 65, Model VirtIO (paravirtualized), Firewall ☐ |
IDE, Device 0, ISO virtio-win.iso.
Cách 2: CLI (qm create)
# Chạy trên node2
qm create 281 --name wifi-dc01 --memory 4096 --cores 2 --sockets 1 --cpu host \
--machine q35 --bios ovmf \
--efidisk0 vm-ceph:1,efitype=4m,pre-enrolled-keys=1 \
--scsihw virtio-scsi-single \
--scsi0 vm-ceph:80,cache=writeback,discard=on,iothread=1 \
--scsi1 vm-ceph:30,cache=writeback,discard=on,iothread=1 \
--ide2 local:iso/Windows_Server_2022_Eval.iso,media=cdrom \
--ide0 local:iso/virtio-win.iso,media=cdrom \
--boot "order=ide2;scsi0" \
--ostype win11 --net0 virtio,bridge=vmbr0,tag=65 \
--agent 1 --vmgenid 1 --onboot 1
qm start 281
--vmgenid 1 tạo VM Generation ID để AD DS nhận biết khi VM bị khôi phục từ snapshot hoặc backup, tránh lỗi USN rollback. Kiểm tra sau khi tạo: qm config 281 | grep vmgenid.
1.2 Cài Windows Server 2022
Mở Console của VM281 (noVNC) và thực hiện:
Press any key to boot from CD or DVD, bấm vào khung console rồi nhấn một phím ngay (bỏ lỡ thì VM rơi vào UEFI shell: dùng nút Reset rồi thử lại).vioscsi\2k22\amd64 → chọn Red Hat VirtIO SCSI pass-through controller → Next. Hai ổ 80 GB và 30 GB sẽ hiện ra.
Admin@WifiLab2024!. Đăng nhập bằng nút Ctrl+Alt+Del của noVNC.1.3 Driver VirtIO, địa chỉ IP và tên máy
Mở PowerShell Run as Administrator. Cài driver card mạng và Qemu Guest Agent từ ISO VirtIO (đường dẫn theo ISO virtio-win hiện hành, cần kiểm lại nếu ISO của bạn khác):
# Tìm ký tự ổ của ISO VirtIO
$v = (Get-Volume | Where-Object { $_.FileSystemLabel -like 'virtio-win*' }).DriveLetter
pnputil /add-driver "${v}:\NetKVM\2k22\amd64\netkvm.inf" /install
pnputil /add-driver "${v}:\Balloon\2k22\amd64\balloon.inf" /install
Start-Process msiexec.exe -ArgumentList "/i ${v}:\guest-agent\qemu-ga-x86_64.msi /qn" -Wait
Get-NetAdapter
Đặt IP tĩnh, DNS tạm trỏ Pi-hole (để tải được cập nhật trước khi promote), múi giờ, bật RDP và đổi tên máy:
$nic = (Get-NetAdapter | Where-Object Status -eq 'Up' | Select-Object -First 1).Name
Set-NetIPInterface -InterfaceAlias $nic -Dhcp Disabled
New-NetIPAddress -InterfaceAlias $nic -IPAddress 10.11.65.52 -PrefixLength 24 -DefaultGateway 10.11.65.1
Set-DnsClientServerAddress -InterfaceAlias $nic -ServerAddresses 10.11.45.53
Set-TimeZone -Id "SE Asia Standard Time"
Set-ItemProperty -Path 'HKLM:\System\CurrentControlSet\Control\Terminal Server' -Name fDenyTSConnections -Value 0
Enable-NetFirewallRule -DisplayGroup "Remote Desktop"
Rename-Computer -NewName "wifi-dc01" -Restart
Sau khi máy khởi động lại, khởi tạo ổ 30 GB thành F: (CD-ROM đang chiếm D: và E:), rồi gỡ hai ISO khỏi VM:
$disk = Get-Disk | Where-Object PartitionStyle -eq 'RAW' | Select-Object -First 1
if ($disk.IsOffline) { Set-Disk -Number $disk.Number -IsOffline $false }
Initialize-Disk -Number $disk.Number -PartitionStyle GPT
New-Partition -DiskNumber $disk.Number -UseMaximumSize -DriveLetter F |
Format-Volume -FileSystem NTFS -NewFileSystemLabel "SysBackup" -Confirm:$false
Get-Volume -DriveLetter F
# Chạy trên node2: gỡ hai ISO và chỉ boot từ đĩa hệ thống
qm set 281 --ide2 none,media=cdrom --ide0 none,media=cdrom --boot "order=scsi0"
1.4 Cài AD DS và promote forest wifilab.local
Install-WindowsFeature -Name AD-Domain-Services, DNS -IncludeManagementTools
# (Tùy chọn) kiểm tra điều kiện trước khi promote; sẽ hỏi mật khẩu DSRM
Test-ADDSForestInstallation -DomainName "wifilab.local" -DomainNetbiosName "WIFILAB" `
-ForestMode Win2012R2 -DomainMode Win2012R2 -InstallDns
Import-Module ADDSDeployment
Install-ADDSForest `
-DomainName "wifilab.local" `
-DomainNetbiosName "WIFILAB" `
-ForestMode "Win2012R2" `
-DomainMode "Win2012R2" `
-InstallDns:$true `
-CreateDnsDelegation:$false `
-DatabasePath "C:\Windows\NTDS" `
-LogPath "C:\Windows\NTDS" `
-SysvolPath "C:\Windows\SYSVOL" `
-NoRebootOnCompletion:$false `
-Force:$true
# Khi được hỏi SafeModeAdministratorPassword (mật khẩu DSRM) nhập: Dsrm@WifiLab2024!
# Máy tự khởi động lại. Cảnh báo "DNS delegation could not be created" là bình thường vì chưa có zone cha.
Win2012R2 (giá trị số 6) là mức chức năng Windows Server 2012 R2; theo tài liệu Install-ADDSForest, tham số -ForestMode và -DomainMode nhận Win2008, Win2008R2, Win2012, Win2012R2, WinThreshold..., và theo bảng tương thích của Microsoft Learn, DC Windows Server 2022 chạy được ở mức 2012 R2. Đây là lựa chọn có chủ ý (xem hộp lưu ý ở mục "Tổng quan kiến trúc"): bài 40 join Samba 4.19.5 của Ubuntu 24.04, chưa join được domain ở mức 2016 (WinThreshold, mức cao nhất của Windows Server 2022). Mức domain không được thấp hơn mức forest nên cả hai đặt cùng Win2012R2. Đừng đổi lại thành WinThreshold nếu định làm bài 40. Không đặt mật khẩu DSRM trực tiếp trong lệnh bằng -SafeModeAdministratorPassword ngoài môi trường lab, vì mật khẩu sẽ nằm trong lịch sử PowerShell.
Sau khi khởi động lại, đăng nhập bằng WIFILAB\Administrator (mật khẩu Admin@WifiLab2024!) và đặt DNS client của chính DC về loopback:
$nic = (Get-NetAdapter | Where-Object Status -eq 'Up' | Select-Object -First 1).Name
Set-DnsClientServerAddress -InterfaceAlias $nic -ServerAddresses 127.0.0.1
Get-ADDomain | Format-List DNSRoot, NetBIOSName, DomainMode, PDCEmulator
Get-ADForest | Format-List Name, ForestMode
Kết quả mong đợi: DomainMode : Windows2012R2Domain và ForestMode : Windows2012R2Forest. Nếu thấy Windows2016Domain/Windows2016Forest (ví dụ đã promote bằng WinThreshold theo bản cũ của bài) thì Samba 4.19.5 ở bài 40 không join được; dựng lại forest ở mức đúng (lab mới chưa có dữ liệu thì promote lại từ đầu), vì bài không xác minh được cách hạ mức 2016 xuống 2012 R2 theo tài liệu Microsoft.
1.5 Cấu hình DNS
DNS đã được cài cùng AD DS và zone wifilab.local tích hợp AD tự tạo. Cần thêm forwarder tới Pi-hole (để DC phân giải được Internet và các tên *.hoatranlabs.local do Pi-hole giữ) và reverse zone:
Add-DnsServerForwarder -IPAddress 10.11.45.53 -PassThru
Add-DnsServerPrimaryZone -NetworkId "10.11.65.0/24" -ReplicationScope "Domain"
ipconfig /registerdns
# Kiểm tra
Get-DnsServerForwarder
Get-DnsServerZone | Format-Table ZoneName, ZoneType, IsDsIntegrated
Resolve-DnsName wifi-dc01.wifilab.local
Resolve-DnsName 10.11.65.52
Resolve-DnsName -Type SRV _ldap._tcp.dc._msdcs.wifilab.local
Resolve-DnsName pihole.hoatranlabs.local -Server 127.0.0.1
Lệnh cuối chứng minh forwarder hoạt động: tên pihole.hoatranlabs.local không thuộc zone của DC nên được chuyển cho Pi-hole và trả về 10.11.45.53.
1.6 Tạo OU, nhóm và user mẫu
$base = "DC=wifilab,DC=local"
New-ADOrganizationalUnit -Name "WIFILAB" -Path $base
foreach ($ou in "Users","Groups","Computers") {
New-ADOrganizationalUnit -Name $ou -Path "OU=WIFILAB,$base"
}
$grp = "OU=Groups,OU=WIFILAB,$base"
New-ADGroup -Name "WiFi-Users" -GroupScope Global -GroupCategory Security -Path $grp -Description "Được phép đăng nhập WiFi HOATRAN-WIFI"
New-ADGroup -Name "WiFi-Admins" -GroupScope Global -GroupCategory Security -Path $grp -Description "Quản trị WiFi / thử nghiệm"
$usr = "OU=Users,OU=WIFILAB,$base"
function New-WifiUser($sam, $given, $pw) {
New-ADUser -Name $sam -GivenName $given -Surname "WiFi" -SamAccountName $sam `
-UserPrincipalName "[email protected]" -Path $usr `
-AccountPassword (ConvertTo-SecureString $pw -AsPlainText -Force) `
-Enabled $true -PasswordNeverExpires $true
}
New-WifiUser "wifi.user1" "User1" "User1@Wifi2024!"
New-WifiUser "wifi.user2" "User2" "User2@Wifi2024!"
New-WifiUser "wifi.admin" "Admin" "Admin@Wifi2024!"
Add-ADGroupMember -Identity "WiFi-Users" -Members "wifi.user1","wifi.user2","wifi.admin"
Add-ADGroupMember -Identity "WiFi-Admins" -Members "wifi.admin"
Get-ADGroupMember "WiFi-Users" | Select-Object Name, SamAccountName
Để thử kịch bản "user ngoài nhóm" ở Phần 4, tạo thêm một tài khoản không thuộc WiFi-Users:
New-WifiUser "wifi.guest" "Guest" "Guest@Wifi2024!"
WiFi-Users), không cần đổi từng user.
1.7 Đồng bộ giờ
Giờ lệch làm hỏng Kerberos (quá 5 phút) và làm client từ chối chứng chỉ máy chủ ("chưa có hiệu lực" hoặc "đã hết hạn"). DC giữ vai trò PDC Emulator nên đồng bộ giờ với nguồn bên ngoài; mọi máy trong domain sẽ lấy giờ từ DC. Pi-hole không phục vụ NTP, nên dùng pool công cộng (FortiGate phải cho UDP 123 đi ra):
w32tm /config /manualpeerlist:"0.vn.pool.ntp.org 1.vn.pool.ntp.org time.cloudflare.com" /syncfromflags:manual /reliable:yes /update
Restart-Service w32time
w32tm /resync /rediscover
w32tm /query /status
w32tm /query /peers
1.8 Pi-hole: conditional forward wifilab.local và bản ghi unifi
Pi-hole phải biết hỏi DC khi gặp tên *.wifilab.local, nếu không máy trong lab không phân giải được domain WiFi. Pi-hole v6 chèn dòng dnsmasq qua setting misc.dnsmasq_lines (đã đối chiếu tài liệu Pi-hole, mô tả "Additional lines to inject into the generated dnsmasq configuration"; giá trị là mảng JSON). Dùng dnsmasq_lines vì dns.revServers của bài 12 đã đặt bằng biến môi trường trong compose nên chỉ đọc. SSH vào VM247 và chạy:
# ssh [email protected] — Pi-hole chạy trong container "pihole" (bài 12)
docker exec pihole pihole-FTL --config misc.dnsmasq_lines '["server=/wifilab.local/10.11.65.52"]'
docker exec pihole pihole reloaddns
# Kiểm tra
docker exec pihole pihole-FTL --config misc.dnsmasq_lines
dig +short wifi-dc01.wifilab.local @10.11.45.53
Lệnh --config misc.dnsmasq_lines ghi đè cả mảng. Khi bài 40 thêm DC thứ hai, đặt lại mảng gồm cả hai dòng server=/wifilab.local/....
Thêm bản ghi unifi.hoatranlabs.local → 10.11.65.53 (UniFi nằm trong domain lab chính, không join wifilab.local). Cách GUI: Pi-hole Admin (http://10.11.45.53/admin) → Settings → Local DNS Records → Domain unifi.hoatranlabs.local, IP 10.11.65.53 → nhấn +. Script add_dns_records.sh của bài 12 ghi đè toàn bộ dns.hosts mỗi lần chạy, nên để bản ghi không bị mất, thêm luôn vào script rồi chạy lại:
grep -q 'unifi.hoatranlabs.local' /opt/pihole/scripts/add_dns_records.sh || \
sed -i '/add_dns "samba01.hoatranlabs.local"/a add_dns "unifi.hoatranlabs.local" "10.11.65.53"' /opt/pihole/scripts/add_dns_records.sh
/opt/pihole/scripts/add_dns_records.sh
dig +short unifi.hoatranlabs.local @10.11.45.53
1.9 Kiểm tra cuối Phần 1
Get-Service ADWS, NTDS, Netlogon, Kdc, DNS, W32Time | Format-Table Name, Status
dcdiag /q
nltest /dsgetdc:wifilab.local
net share | findstr /i "SYSVOL NETLOGON"
dcdiag /q chỉ in lỗi, im lặng là tốt. Nếu có lỗi DNS ngay sau promote, chờ 5 phút cho Netlogon đăng ký xong SRV record rồi chạy lại.
NPS, RADIUS và chứng chỉ (AD CS)
Cài AD CS (Enterprise Root CA) · Cài NPS và đăng ký vào Active Directory · Template chứng chỉ cho NPS và autoenrollment
Mục tiêu của phần này: NPS nhận Access-Request từ AP, kiểm tra nhóm WiFi-Users, dựng PEAP bằng chứng chỉ do AD CS cấp, ghi nhật ký, và máy domain tự tin cậy CA. Tất cả chạy trên wifi-dc01 bằng tài khoản WIFILAB\Administrator.
2.1 Cài AD CS (Enterprise Root CA)
Theo tài liệu Microsoft, sau khi cài AD CS không đổi được tên máy và tư cách thành viên domain, nên chỉ cài khi wifi-dc01 đã là DC ổn định (Phần 1).
Install-WindowsFeature ADCS-Cert-Authority -IncludeManagementTools
Install-AdcsCertificationAuthority `
-CAType EnterpriseRootCa `
-CACommonName "WIFILAB-ROOT-CA" `
-CADistinguishedNameSuffix "DC=wifilab,DC=local" `
-CryptoProviderName "RSA#Microsoft Software Key Storage Provider" `
-KeyLength 4096 `
-HashAlgorithmName SHA256 `
-ValidityPeriod Years -ValidityPeriodUnits 10 `
-Force
# Kiểm tra CA
Get-Service CertSvc
certutil -ping
certutil -cainfo name
Enterprise Root CA tự công bố chứng chỉ gốc vào AD, nên mọi máy join domain sẽ tự tin cậy CA này khi áp dụng autoenrollment (mục 2.3). Xuất sẵn chứng chỉ gốc để đưa cho thiết bị không join domain (điện thoại, laptop ngoài) ở Phần 4:
New-Item -ItemType Directory -Path C:\PKI -Force | Out-Null
certutil -ca.cert C:\PKI\WIFILAB-ROOT-CA.cer
certutil -encode C:\PKI\WIFILAB-ROOT-CA.cer C:\PKI\WIFILAB-ROOT-CA.pem
File .cer (DER) dùng cho Windows, Android, iOS; file .pem (Base64) dùng cho eapol_test ở Phần 4.
2.2 Cài NPS và đăng ký vào Active Directory
Install-WindowsFeature NPAS -IncludeManagementTools
# Đăng ký NPS vào AD: thêm wifi-dc01 vào nhóm "RAS and IAS Servers"
netsh nps add registeredserver wifilab.local wifi-dc01.wifilab.local
Get-ADGroupMember "RAS and IAS Servers" | Select-Object Name
Cách GUI: Server Manager → Tools → Network Policy Server → chuột phải NPS (Local) → Register Server in Active Directory → OK → OK. Việc đăng ký cho NPS quyền đọc thuộc tính dial-in của user AD và cũng cấp quyền Enroll cho chứng chỉ ở mục sau (vì template cấp cho nhóm RAS and IAS Servers).
Máy vừa vào nhóm cần khởi động lại để token Kerberos của computer account có nhóm mới:
Restart-Computer
2.3 Template chứng chỉ cho NPS và autoenrollment
Tạo template WiFi-NPS-Server (nhân bản từ "RAS and IAS Server", theo hướng dẫn Microsoft):
WIFILAB-ROOT-CA → chuột phải Certificate Templates → Manage.Windows Server 2016, Certificate recipient Windows Server 2016 (hoặc Windows 10 / Windows Server 2016).WiFi-NPS-Server, Validity period 2 years. Không tick Publish certificate in Active Directory.None sang Common name, và tick DNS name trong phần alternate subject name. Subject name để trống thì NPS không hiển thị chứng chỉ để chọn.Key Storage Provider, Algorithm RSA, Minimum key size 2048, Request hash SHA256.Server Authentication (OID 1.3.6.1.5.5.7.3.1).
WiFi-NPS-Server → OK.Tạo GPO WiFi-PKI-Autoenroll để máy domain tự xin chứng chỉ và nhận CA gốc:
- Server Manager → Tools → Group Policy Management → mở Forest → Domains →
wifilab.local→ chuột phải domain → Create a GPO in this domain, and Link it here → NameWiFi-PKI-Autoenroll→ OK. - Chuột phải GPO → Edit → Computer Configuration → Policies → Windows Settings → Security Settings → Public Key Policies → nhấp đôi Certificate Services Client - Auto-Enrollment: Configuration Model
Enabled, tick Renew expired certificates, update pending certificates, and remove revoked certificates và Update certificates that use certificate templates → OK. - Làm lại tương tự ở User Configuration → Policies → Windows Settings → Security Settings → Public Key Policies (cần khi dùng EAP-TLS với chứng chỉ người dùng ở bước nâng cao).
- (Tùy chọn, bài 40 dùng lại) Cũng trong Computer Configuration → Public Key Policies, chuột phải Trusted Root Certification Authorities → Import để nhập
C:\PKI\WIFILAB-ROOT-CA.cermột cách tường minh.
gpupdate /force
certutil -pulse
2.4 Kiểm tra chứng chỉ máy chủ của NPS
Get-ChildItem Cert:\LocalMachine\My |
Where-Object { $_.EnhancedKeyUsageList.FriendlyName -contains 'Server Authentication' } |
Select-Object Subject, Issuer, NotAfter, Thumbprint,
@{n='Template';e={ ($_.Extensions | Where-Object { $_.Oid.Value -eq '1.3.6.1.4.1.311.21.7' }).Format($false) }} |
Format-List
Kết quả mong đợi: có một chứng chỉ Subject: CN=wifi-dc01.wifilab.local, Issuer: CN=WIFILAB-ROOT-CA, DC=wifilab, DC=local, Template chứa WiFi-NPS-Server. Vì DC còn tự nhận các chứng chỉ "Domain Controller" cũng có Server Authentication, đặt tên gợi nhớ để chọn đúng trong NPS:
(Get-Item Cert:\LocalMachine\My\<THUMBPRINT_CUA_WiFi-NPS-Server>).FriendlyName = "WiFi-NPS-Server"
Nếu không thấy chứng chỉ: kiểm tra wifi-dc01 đã nằm trong RAS and IAS Servers và đã khởi động lại, template đã Issue, rồi gpupdate /force; certutil -pulse và xem Event Viewer → Application (nguồn CertificateServicesClient-AutoEnrollment).
2.5 Khai báo RADIUS Clients (từng AP hoặc dải IP AP)
Chính AP gửi Access-Request tới NPS (UniFi gọi AP là authenticator), nên RADIUS client là AP, không phải UniFi Controller unifi. Quy ước trong bài: AP dùng dải minh họa 10.11.45.128/28.
Cách GUI: Network Policy Server → RADIUS Clients and Servers → RADIUS Clients → chuột phải → New:
| Trường | Giá trị |
|---|---|
| Enable this RADIUS client | ☑ |
| Friendly name | UniFi-AP-Range (dải) hoặc UniFi-AP-01 (từng AP) |
| Address (IP or DNS) | 10.11.45.128/28 (dải, CIDR; chỉ Datacenter) hoặc 10.11.45.131 (một AP) |
| Vendor name | RADIUS Standard |
| Shared secret | Manual: RadiusSecret@2024! (nhập lại ở Confirm) |
| Access-Request messages must contain the Message-Authenticator attribute | Để trống (chỉ cần khi dùng phương thức không phải EAP) |
Theo tài liệu Microsoft, khai báo theo dải IP chỉ có trên Windows Server Datacenter, và mọi thiết bị trong dải phải dùng chung cấu hình và shared secret. Trên bản Standard (tối đa 50 client, mỗi client một IP), thêm từng AP bằng PowerShell:
New-NpsRadiusClient -Name "UniFi-AP-01" -Address "10.11.45.131" -SharedSecret "RadiusSecret@2024!"
Restart-Service IAS
Get-NpsRadiusClient | Format-Table Name, Address, Enabled
10.11.45.0/24, vì mọi thiết bị trong dải biết secret đều gửi được Access-Request.
2.6 Connection Request Policy WiFi-HOATRAN-CRP
Connection Request Policy quyết định NPS xử lý yêu cầu tại chỗ hay chuyển tiếp sang RADIUS server khác. Ở đây xử lý tại chỗ:
- Network Policy Server → Policies → Connection Request Policies → chuột phải → New.
- Policy name
WiFi-HOATRAN-CRP, Type of network access serverUnspecified→ Next. - Specify Conditions → Add → NAS Port Type → tick Wireless - IEEE 802.11 (có thể tick thêm Wireless - Other) → OK → Next.
- Specify Connection Request Forwarding: chọn Authenticate requests on this server → Next.
- Specify Authentication Methods: để nguyên (không tick Override network policy authentication settings) → Next → Next → Finish.
- Chuột phải policy mới → Move Up để nằm trên chính sách mặc định
Use Windows authentication for all users.
2.7 Network Policy WiFi-HOATRAN-Users
WiFi-HOATRAN-Users, Type of network access server Unspecified → Next.- User Groups → Add Groups →
WIFILAB\WiFi-Users. - NAS Port Type → Wireless - IEEE 802.11.
- Certificate issued to: chọn
wifi-dc01.wifilab.localđúng chứng chỉWiFi-NPS-Server(xem Issuer làWIFILAB-ROOT-CA, Friendly name, ngày hết hạn). - Tick Enable Fast Reconnect.
- Trong EAP Types thêm Secured password (EAP-MSCHAP v2).
480 phút (tùy chọn, buộc xác thực lại sau 8 giờ); NAS Port Type đã là Wireless - IEEE 802.11.WiFi-HOATRAN-Users lên vị trí 1 (chuột phải → Move Up), phía trên hai policy mặc định "Connections to Microsoft Routing and Remote Access server" và "Connections to other access servers" (cả hai mặc định là Deny Access, đứng trên sẽ chặn mọi yêu cầu).
Tùy chọn: trả VLAN 75 từ NPS (RFC 3580/2868, dùng khi cần phân VLAN theo nhóm). Ở bước Settings (hoặc sửa policy: tab Settings → RADIUS Attributes → Standard → Add), thêm ba thuộc tính:
| Thuộc tính | Giá trị |
|---|---|
| Tunnel-Medium-Type | 802 (includes all 802 media plus Ethernet canonical format) |
| Tunnel-Pvt-Group-ID | 75 (chuỗi) |
| Tunnel-Type | Virtual LANs (VLAN) |
UniFi hiểu cặp Tunnel-Type 13 và Tunnel-Medium-Type 6 (theo tài liệu "Configuring a RADIUS Server in UniFi"). Khi dùng, bật RADIUS assigned VLAN trong RADIUS profile ở Phần 3 và đảm bảo VLAN 75 đã tạo trong UniFi. Nếu SSID đã gán sẵn Network VLAN 75 thì bước này không bắt buộc, chỉ cần khi muốn nhóm khác (ví dụ WiFi-Admins) vào VLAN khác.
Có thể thay mục 2.6 và 2.7 bằng wizard Getting Started → Standard Configuration → RADIUS server for 802.1X Wireless or Wired Connections → Configure 802.1X → Secure Wireless Connections: wizard tạo sẵn một Connection Request Policy và một Network Policy cùng tên. Cách thủ công ở trên cho tên policy chuẩn của bài.
2.8 Nhật ký NPS (accounting) và firewall
# Đảm bảo ghi Security log cho NPS (Event 6272, 6273)
auditpol /get /subcategory:"Network Policy Server"
auditpol /set /subcategory:"Network Policy Server" /success:enable /failure:enable
# Firewall: NPS tự tạo rule cho UDP 1812/1813 khi cài; kiểm tra
Get-NetFirewallRule -DisplayName "*Network Policy Server*" | Format-Table DisplayName, Enabled, Direction
Get-NetUDPEndpoint -LocalPort 1812, 1813 | Format-Table LocalAddress, LocalPort, OwningProcess
Nếu không có rule nào, tạo thủ công:
New-NetFirewallRule -DisplayName "NPS RADIUS 1812-1813 UDP" -Direction Inbound -Protocol UDP -LocalPort 1812,1813 -Action Allow
Cấu hình accounting ghi tệp: NPS (Local) → Accounting → Configure Accounting → wizard → Log to a text file on the local computer → thư mục mặc định C:\Windows\System32\LogFiles → Finish. Cổng mặc định của NPS là 1812 và 1645 cho xác thực, 1813 và 1646 cho accounting; AP UniFi dùng 1812/1813 nên giữ nguyên.
2.9 GPO profile WiFi và CA gốc cho máy domain
Máy domain nhận CA gốc qua WiFi-PKI-Autoenroll (mục 2.3). Thêm GPO thứ hai để máy domain tự có profile HOATRAN-WIFI, validate đúng chứng chỉ máy chủ và không hỏi người dùng:
WiFi-Client-Wireless → Edit.WiFi-HOATRAN-Wireless → OK, nhấp đôi policy.HOATRAN-WIFI, Network Name(s) (SSID) HOATRAN-WIFI → Add (xóa dòng NEWSSID nếu có).WPA2-Enterprise, Encryption AES-CCMP, Network authentication method Microsoft: Protected EAP (PEAP) → Properties:- Tick Verify the server's identity by validating the certificate.
- Connect to these servers:
wifi-dc01.wifilab.local. - Trusted Root Certification Authorities: tick
WIFILAB-ROOT-CA. - Authentication method Secured password (EAP-MSCHAP v2) → Configure: tick Automatically use my Windows logon name and password (and domain if any).
- Tick Enable Fast Reconnect → OK.
gpupdate /force.2.10 Export cấu hình NPS và bảng tên chuẩn cho bài 40
Sao lưu cấu hình NPS ra XML (bài 40 dùng tệp này để đối chiếu khi chuyển sang FreeRADIUS). Tệp chứa shared secret ở dạng chưa mã hóa, phải lưu nơi an toàn:
New-Item -ItemType Directory -Path C:\NPS-Backup -Force | Out-Null
netsh nps export filename="C:\NPS-Backup\nps-wifi.xml" exportPSK=YES
# Cách khác trên Windows Server 2012 trở lên:
Export-NpsConfiguration -Path C:\NPS-Backup\nps-wifi-ps.xml
Bảng tên chuẩn của Phần 1 và Phần 2 (bài 40 bám theo):
| Đối tượng | Tên / giá trị |
|---|---|
| Domain / NetBIOS | wifilab.local / WIFILAB |
| Nhóm AD | WiFi-Users, WiFi-Admins (OU WIFILAB) |
| User mẫu | wifi.user1, wifi.user2, wifi.admin, wifi.guest (không thuộc nhóm) |
| Enterprise Root CA | WIFILAB-ROOT-CA |
| Template chứng chỉ | WiFi-NPS-Server (nhân bản từ RAS and IAS Server) |
| GPO | WiFi-PKI-Autoenroll (autoenrollment + CA gốc), WiFi-Client-Wireless (policy WiFi-HOATRAN-Wireless, profile HOATRAN-WIFI) |
| RADIUS Client (NPS) | UniFi-AP-Range (10.11.45.128/28) hoặc UniFi-AP-01 (10.11.45.131) |
| Connection Request Policy | WiFi-HOATRAN-CRP |
| Network Policy | WiFi-HOATRAN-Users (User Groups WIFILAB\WiFi-Users, NAS Port Type Wireless - IEEE 802.11, PEAP + EAP-MSCHAPv2) |
| RADIUS profile (UniFi) | wifilab-radius (xác thực 1812, accounting 1813) |
| SSID | HOATRAN-WIFI, Network UniFi VLAN75-USR |
| Tệp export NPS | C:\NPS-Backup\nps-wifi.xml |
UniFi OS Server trên Ubuntu và cấu hình WiFi RADIUS
Tạo VM282 trên node3 · Cài đặt Ubuntu Server 24.04 · Cấu hình sau cài đặt
Mục tiêu của phần này: dựng UniFi OS Server (chạy UniFi Network Application bên trong) trên VM282, adopt AP, tạo RADIUS profile wifilab-radius trỏ tới NPS và SSID HOATRAN-WIFI dùng WPA2/WPA3-Enterprise.
.deb Legacy (repo apt, MongoDB, Java) đã không còn được khuyến nghị cho dự án mới nên bài này không dùng. Bản dùng trong bài: UniFi OS Server 5.1.42 (Linux x64, phát hành 2026-09-10) với UniFi Network Application 10.x bên trong; trang tải xuống ngày 2026-10-15 ghi 10.6.106 là bản mới nhất của Network Application. Số bản sẽ tăng theo thời gian, luôn lấy bản mới nhất ở trang Download.
Yêu cầu hệ thống (trang "Self-Hosting UniFi" của Ubiquiti, đối chiếu với cấu hình VM282):
| Hạng mục | Yêu cầu chính thức của Ubiquiti | VM282 trong bài |
|---|---|---|
| Hệ điều hành | Ubuntu 24.04 trở lên hoặc Debian 13 trở lên (hoặc bản phân phối hiện đại có systemd, libc 2.31+) | Ubuntu Server 24.04.5 LTS (glibc 2.39) |
| Podman | 4.9.3 trở lên (dùng pasta) | 4.9.3 (gói podman 4.9.3+ds1-1ubuntu0.1 của noble, gói khuyến nghị kèm passt, slirp4netns, uidmap) |
| slirp4netns | 1.2 trở lên | 1.2.1 (gói slirp4netns 1.2.1-1build2 của noble) |
| CPU | x86-64 | 2 vCPU, loại host |
| RAM | Tối thiểu 2 GB | 4 GB (hướng dẫn cộng đồng khuyến nghị tối thiểu 4 GB, nên 8 GB khi quản lý nhiều thiết bị) |
| Đĩa | Từ 10 GB trống | 40 GB (vm-ceph) |
| Mạng | Ethernet có dây 100 Mbps | VirtIO, VLAN 65 |
| Lưu ý | Không hỗ trợ Docker; không clone VM (token Site Manager bị trùng) | Cài mới từ ISO, không clone từ template |
Ubuntu Server 24.04 LTS là đúng mức tối thiểu "Ubuntu 24.04 trở lên" của Ubiquiti, và Podman 4.9.3 của noble cũng đúng bằng mức tối thiểu 4.9.3, nên không còn dư địa: đừng dùng Ubuntu 22.04 (Podman 3.4). Các hướng dẫn cộng đồng đã cài UniFi OS Server 5.0.6 trên Ubuntu 24.04.4 với podman uidmap slirp4netns iptables; bước cài ở mục 3.4 với UniFi OS Server 5.1.42 vẫn cần kiểm lại trên máy thật. Ubuntu 24.04 bật giới hạn user namespace không đặc quyền của AppArmor, ảnh hưởng tới Podman rootless: xem ghi chú ở mục 3.4.
3.1 Tạo VM282 trên node3
Upload ISO Ubuntu Server 24.04.5 lên storage local của node3 (hoặc tải bằng wget trên node3). Tên ISO có số point release; nếu releases.ubuntu.com/24.04/ đã có 24.04.6 thì dùng tên mới và sửa các dòng bên dưới cho khớp:
# Chạy trên node3 (ssh [email protected])
wget -O /var/lib/vz/template/iso/ubuntu-24.04.5-live-server-amd64.iso \
https://releases.ubuntu.com/24.04/ubuntu-24.04.5-live-server-amd64.iso
# Đối chiếu SHA-256 với https://releases.ubuntu.com/24.04/SHA256SUMS
sha256sum /var/lib/vz/template/iso/ubuntu-24.04.5-live-server-amd64.iso
Cách 1: Web UI Proxmox (GUI)
- Đăng nhập Proxmox Web UI → chọn Node: node3 → nhấn Create VM.
- Điền lần lượt từng tab:
| Tab | Thiết lập |
|---|---|
| General | VM ID 282, Name unifi, bỏ tick Start after created |
| OS | ISO Image ubuntu-24.04.5-live-server-amd64.iso; Guest OS Type Linux, Version 6.x - 2.6 Kernel |
| System | Machine q35, BIOS SeaBIOS, SCSI Controller VirtIO SCSI single, Qemu Agent ☑ |
| Disks | SCSI 0: Storage vm-ceph, 40 GiB, Cache Write back, Discard ☑ |
| CPU | Sockets 1, Cores 2, Type host |
| Memory | 4096 MiB |
| Network | Bridge vmbr0, VLAN Tag 65, Model VirtIO (paravirtualized), Firewall ☐ |
- Tab Confirm → Finish → Start → Console để cài Ubuntu.
Cách 2: CLI (qm create)
# Chạy trên node3
qm create 282 --name unifi --memory 4096 --cores 2 --sockets 1 --cpu host \
--net0 virtio,bridge=vmbr0,tag=65 \
--scsihw virtio-scsi-single \
--scsi0 vm-ceph:40,cache=writeback,discard=on \
--ide2 local:iso/ubuntu-24.04.5-live-server-amd64.iso,media=cdrom \
--boot "order=ide2;scsi0" \
--ostype l26 --machine q35 --bios seabios \
--agent 1 --onboot 1 --serial0 socket --vga serial0
qm start 282
host và RAM: UniFi Network Application bên trong dùng MongoDB, và MongoDB từ bản 5.0 trở lên yêu cầu tập lệnh AVX (theo Production Notes của MongoDB), nên giữ loại CPU host (hoặc x86-64-v3) thay cho loại mặc định x86-64-v2-AES. RAM 4 GB là mức thực tế tối thiểu cho UniFi OS Server; nâng lên 8 GB nếu quản lý nhiều AP và client.
3.2 Cài đặt Ubuntu Server 24.04
Kết nối Console của VM282 và làm theo:
- Language: English; Keyboard: English (US).
- Install type: Ubuntu Server (minimized).
- Network: DHCP tạm thời (đặt IP tĩnh ở mục 3.3).
- Storage: entire disk → LVM, không mã hóa.
- Profile: name
sysadmin, server nameunifi, usernamesysadmin, passwordHoatran@2024!. - SSH: tick Install OpenSSH server.
- Snaps: không chọn gói nào → Reboot, gỡ ISO:
qm set 282 --ide2 none,media=cdrom --boot "order=scsi0".
Các màn hình phụ của trình cài 24.04 (Ubuntu Pro, third-party drivers nếu có) chọn bỏ qua; tên và thứ tự màn hình có thể khác nhẹ giữa các bản point, cần kiểm lại trên máy thật.
3.3 Cấu hình sau cài đặt
Ubuntu Server 24.04 dùng sudo cổ điển và systemd-timesyncd làm dịch vụ giờ mặc định. Cài thêm chrony ở lệnh bên dưới, khi đó timedatectl nhường việc đồng bộ giờ cho chrony và systemd-timesyncd chuyển sang inactive (theo tài liệu Ubuntu Server về timedatectl/timesyncd). Khi apt chạy, needrestart (có sẵn trên bản Server) có thể hiện hộp thoại hỏi dịch vụ cần khởi động lại: chọn mặc định hoặc đặt NEEDRESTART_MODE=a cho lệnh đó.
# ssh sysadmin@<ip-dhcp> rồi: sudo -i
apt update && apt -y upgrade
apt install -y qemu-guest-agent curl wget ca-certificates chrony ufw net-tools
systemctl enable --now qemu-guest-agent chrony
hostnamectl set-hostname unifi
echo "127.0.1.1 unifi unifi.hoatranlabs.local" >> /etc/hosts
timedatectl set-timezone Asia/Ho_Chi_Minh
Đặt IP tĩnh bằng netplan (netplan 1.0 của 24.04). Tên NIC của VM q35 thường là ens18 hoặc enp6s18 tùy cấu hình, nên lấy tên NIC thật bằng ip -br link thay vì gõ cứng; Ubuntu 24.04 cài từ ISO ghi mạng vào 50-cloud-init.yaml, nếu để nguyên tệp DHCP đó thì sẽ cộng dồn với IP tĩnh nên cần tắt cloud-init quản lý mạng và xóa tệp cũ:
ip -br link # xem tên NIC thật
NIC=$(ip -br link | awk '$1!="lo"{print $1; exit}')
echo "NIC = $NIC"
echo 'network: {config: disabled}' > /etc/cloud/cloud.cfg.d/99-disable-network-config.cfg
rm -f /etc/netplan/*.yaml
cat > /etc/netplan/50-unifi.yaml << EOF
network:
version: 2
ethernets:
${NIC}:
addresses: [10.11.65.53/24]
routes:
- to: default
via: 10.11.65.1
nameservers:
addresses: [10.11.45.53]
search: [hoatranlabs.local]
EOF
chmod 600 /etc/netplan/50-unifi.yaml
netplan apply
Phiên SSH sẽ đứt vì IP đổi từ DHCP sang 10.11.65.53; đăng nhập lại bằng IP mới rồi kiểm tra:
ip -4 a show | grep 10.11.65.53
chronyc tracking
chronyc sources
resolvectl query wifi-dc01.wifilab.local
Dòng cuối kiểm tra chuỗi DNS: unifi hỏi Pi-hole, Pi-hole chuyển tiếp wifilab.local cho DC (mục 1.8). Pi-hole không phục vụ NTP nên chrony đồng bộ với nguồn giờ công cộng mặc định của Ubuntu (UDP 123, policy 7 ở mục "Điều kiện tiên quyết"); kiểm tra bằng chronyc sources.
Tường lửa UFW (mở SSH trước khi bật để không tự khóa mình). Cổng 11443 là giao diện web của UniFi OS Server, 8080 và 3478/udp là cổng AP cần tới (mục 3.4 có bảng đầy đủ):
ufw default deny incoming
ufw default allow outgoing
ufw allow from 10.11.45.0/24 to any port 22 proto tcp comment 'SSH tu MGMT'
ufw allow from 10.11.45.0/24 to any port 11443 proto tcp comment 'UniFi OS Server Web UI'
ufw allow from 10.11.45.0/24 to any port 8080 proto tcp comment 'UniFi inform'
ufw allow from 10.11.45.0/24 to any port 3478 proto udp comment 'UniFi STUN'
ufw allow from 10.11.45.35 to any port 9100 proto tcp comment 'node_exporter tu Prometheus'
# UDP 10001 (discovery) chỉ có tác dụng khi AP cùng L2 với unifi, nên không mở khi AP nằm VLAN 45:
# ufw allow 10001/udp
ufw --force enable
ufw status verbose
3.4 Cài UniFi OS Server
Các bước dưới đây theo mục "Installing UniFi OS Server → Linux" của bài "Self-Hosting UniFi" (help.ui.com): cài Podman và slirp4netns, tải installer, cấp quyền thực thi rồi chạy bằng quyền root. Thêm passt (cung cấp pasta, kiểu mạng mà Ubiquiti yêu cầu cho Podman 4.9.3 trở lên; gói podman của noble khuyến nghị kèm passt), uidmap (Podman rootless) và iptables theo các hướng dẫn cộng đồng đã thử trên Ubuntu 24.04.
sudo -i
# 1) Gói phụ thuộc
apt update
apt install -y podman slirp4netns passt uidmap iptables
podman --version # yêu cầu >= 4.9.3 (Ubuntu 24.04: 4.9.3)
slirp4netns --version # yêu cầu >= 1.2 (Ubuntu 24.04: 1.2.1)
sysctl kernel.apparmor_restrict_unprivileged_userns # 24.04 mặc định = 1, xem ghi chú AppArmor bên dưới
aa-status 2>/dev/null | grep -E 'podman|crun|slirp4netns' # profile có sẵn trong gói apparmor
# 2) Tải installer Linux x64. Link đổi theo từng bản: lấy link mới nhất tại
# https://ui.com/download/software/unifi-os-server (Linux x64 -> chuột phải Download -> Copy link address)
mkdir -p /opt/uosserver-installer && cd /opt/uosserver-installer
UOS_URL="https://fw-download.ubnt.com/data/unifi-os-server/5172-linux-x64-5.1.42-12e9e3cf-8f8b-4e54-928c-76b80a10c8a4.42-x64"
wget -O uosserver-installer-5.1.42 "$UOS_URL"
sha256sum uosserver-installer-5.1.42 # ghi lại để đối chiếu khi cài lại
chmod +x uosserver-installer-5.1.42
# 3) Cài đặt (khoảng vài phút; nếu installer hỏi xác nhận thì trả lời y)
./uosserver-installer-5.1.42
Installer tạo tài khoản hệ thống uosserver, dịch vụ systemd uosserver và container UniFi OS (chạy rootless Podman). Chờ vài phút cho container khởi động và khởi tạo cơ sở dữ liệu rồi kiểm tra:
systemctl status uosserver --no-pager
uosserver status
ss -tulnp | grep -E ':(11443|8080|3478)\b'
curl -k -s -o /dev/null -w '%{http_code}\n' https://localhost:11443/
Lệnh uosserver là công cụ dòng lệnh do installer đặt vào hệ thống (theo hướng dẫn cộng đồng; kiểm lại bằng uosserver help). Cổng 11443 trả HTTP 200 (hoặc 3xx chuyển hướng) là giao diện đã sẵn sàng.
apparmor hạn chế user namespace không đặc quyền cho mọi chương trình không đặc quyền và không bị AppArmor giam (sysctl kernel.apparmor_restrict_unprivileged_userns, bật mặc định). Podman rootless cần user namespace, nhưng danh sách tệp của gói apparmor trên noble có sẵn profile podman, crun, runc, slirp4netns, rootlesskit, buildah (profile podman ở nhánh apparmor-4.0 là profile unconfined có dòng userns,), nên Podman cài từ apt thường chạy được mà không phải chỉnh gì; hướng dẫn cộng đồng cài UniFi OS Server 5.0.6 trên 24.04.4 cũng không ghi cần xử lý AppArmor. Chỉ khi installer hoặc container báo cannot clone: Permission denied / cannot re-exec process và journalctl -k | grep -i userns_create có dòng apparmor="DENIED" thì mới xử lý, theo hai cách trong ghi chú phát hành: (1) thử tạm echo 0 | sudo tee /proc/sys/kernel/apparmor_restrict_unprivileged_userns (mất khi khởi động lại) để xác nhận nguyên nhân; (2) giữ lâu dài bằng tệp /etc/sysctl.d/60-apparmor-namespace.conf chứa kernel.apparmor_restrict_unprivileged_userns=0 rồi khởi động lại. Ubuntu ghi rõ cả hai cách không chống được exploit kernel lạm dụng user namespace nên chỉ dùng cho VM chuyên dụng như unifi; cách hẹp hơn là thêm profile cho đúng tệp thực thi bị chặn với dòng userns,. Chưa có nguồn xác nhận UniFi OS Server 5.1.42 gặp lỗi này trên 24.04, cần kiểm lại trên máy thật.
Quản lý dịch vụ:
| Việc cần làm | Lệnh | Nguồn |
|---|---|---|
| Dừng / chạy UniFi OS Server | sudo systemctl stop uosserver / sudo systemctl start uosserver | help.ui.com |
| Tắt / bật tự chạy khi khởi động | sudo systemctl disable uosserver / sudo systemctl enable uosserver | help.ui.com |
| Xem trạng thái, mở shell trong container, tạo tệp hỗ trợ | sudo uosserver status, sudo uosserver shell, sudo uosserver support | Hướng dẫn cộng đồng, cần kiểm lại bằng uosserver help |
| Xem log container | sudo -u uosserver podman logs unifi-os | Hướng dẫn cộng đồng (tên container unifi-os), cần kiểm lại bằng sudo -u uosserver podman ps |
| Cập nhật | Settings → Control Plane (mục cập nhật) hoặc Update Manager trên Site Manager | help.ui.com |
Hướng dẫn cộng đồng còn nêu lệnh uosserver-purge để gỡ hoàn toàn (xóa container, image và bridge mạng); lệnh này xóa cả dữ liệu, chỉ dùng sau khi đã backup và đã kiểm lại cú pháp bằng uosserver help.
Cổng của UniFi OS Server (đối chiếu "Required Ports Reference" của Ubiquiti và hướng dẫn cộng đồng; trang của Ubiquiti chưa liệt kê riêng cổng 11443):
| Cổng | Giao thức | Dùng cho | Mở trong bài |
|---|---|---|---|
| 11443 | TCP | Giao diện web và API của UniFi OS Server (HTTPS) | Có, từ VLAN 45 |
| 8080 | TCP | Inform: AP và Network Application trao đổi cấu hình | Có, từ VLAN 45 |
| 3478 | UDP | STUN cho adopt và liên lạc với thiết bị | Có, từ VLAN 45 |
| 10001 | UDP | Discovery khi adopt, chỉ hiệu lực cùng L2 | Không (AP khác VLAN) |
| 8444 | TCP | Captive portal (UniFi OS Server dùng 8444 thay 8843 của bản cũ) | Không dùng |
| 8880–8882, 8843 | TCP | Hotspot portal redirection (Required Ports Reference) | Không dùng |
| 8443 | TCP | Giao diện của UniFi Network Server cũ; UniFi OS Server dùng 11443 | Không |
Danh sách đầy đủ (5514/udp syslog, 6789 speed test, 1900/udp, 27117 cơ sở dữ liệu cục bộ ...) nằm ở bảng chính thức; kịch bản của bài chỉ cần ba cổng đầu. Nếu từ máy MGMT không vào được 11443 dù UFW đã mở, kiểm tra ss -tulnp, journalctl -u uosserver -n 50 và bộ đếm gói của UFW; Podman rootless chuyển cổng bằng pasta (Ubiquiti yêu cầu pasta cho Podman 4.9.3 trở lên) hoặc slirp4netns nên về nguyên tắc chịu quy tắc INPUT của UFW (cần kiểm lại trên máy thật).
uosserver (không nằm ở /var/lib/unifi như gói .deb cũ). Cách backup được hỗ trợ là Settings → Control Plane → Backups (mục 3.5); backup file-level của VM ở mục 5.3 chỉ là lớp bổ sung.
3.5 Thiết lập ban đầu (wizard)
Mở https://10.11.65.53:11443 (hoặc https://unifi.hoatranlabs.local:11443), bỏ qua cảnh báo chứng chỉ tự ký (Ubiquiti ghi cảnh báo "Your connection is not private" có thể bỏ qua; muốn dùng chứng chỉ riêng thì tải lên ở Settings → Control Plane → Console → Certificates).
- Đặt tên console
HOATRAN-UNIFI, chọn quốc gia và múi giờAsia/Ho_Chi_Minh(quốc gia quyết định kênh và công suất phát hợp lệ). - Chọn kiểu định danh: tài khoản cục bộ (Super Admin lưu trên chính server, không cần tài khoản Ubiquiti): username
admin, passwordAdmin@Unifi2024!. Chọn đăng nhập bằng tài khoản Ubiquiti (UI account/SSO) chỉ khi muốn quản lý từ xa qua Site Manager và sao lưu đám mây. Tên các lựa chọn trong wizard thay đổi theo phiên bản, cần kiểm lại trên máy thật. - Tắt Remote Access / Cloud nếu lab không cần.
- Hoàn tất wizard, mở ứng dụng Network từ trang chủ console. Site mặc định tên
Default. - Cập nhật Network Application lên bản GA mới nhất trước khi adopt AP: vào mục cập nhật trong Settings → Control Plane (tên mục theo phiên bản, Ubiquiti dẫn tới bài "UniFi Updates"). Bản Network Application kèm trong installer có thể thấp hơn bản mới nhất trên trang tải xuống.
Bật backup ngay: vào Settings → Control Plane → Backups. System Backups tạo bản đám mây hằng tuần và trước mỗi lần cập nhật lớn nhưng chỉ dùng được khi đăng nhập tài khoản Ubiquiti; lab dùng tài khoản cục bộ nên sau mỗi thay đổi lớn hãy tải bản backup offline từ cùng màn hình và lưu ở nơi khác VM282. Khôi phục: Settings → Control Plane → Backups → Restore, chọn tệp backup (mặc định khôi phục toàn bộ ứng dụng và cài đặt). Sau khi khôi phục sang máy mới, thiết bị nào hiện offline hoặc "Managed by Another Console" thì factory reset rồi adopt lại.
3.6 Adopt AP
AP nằm VLAN 45, unifi nằm VLAN 65, khác subnet nên AP không tự tìm thấy Controller qua UDP 10001. Tài liệu Ubiquiti "Remote Adoption (Layer 3)" yêu cầu AP và Network Application thông nhau qua TCP 8080 và cho phép trỏ AP bằng lệnh set-inform.
- Cắm AP (PoE) vào cổng trunk, chờ AP nhận IP từ DHCP của FortiGate VLAN 45 (đặt DHCP reservation, ví dụ
10.11.45.131). Đèn trắng đặc nghĩa là AP ở trạng thái mặc định. - SSH vào AP. Tài khoản mặc định của thiết bị chưa adopt là
ui / ui(thiết bị đời cũ:ubnt / ubnt) theo help.ui.com:
ssh [email protected]
# AP đời cũ: ssh [email protected]
set-inform http://10.11.65.53:8080/inform
set-inform một lần nữa (Ubiquiti lưu ý có thể phải chạy lại sau khi thiết bị đã hiện trong UniFi).10.11.65.53. Tài liệu "Backups and Migration in UniFi" của Ubiquiti nhắc tới đúng toggle này; vị trí menu chính xác theo phiên bản, cần kiểm lại trên máy thật.Tùy chọn tự động hóa cho nhiều AP: DHCP Option 43 trên FortiGate trỏ về Controller. Theo help.ui.com, option 43 mã hóa hex 0104 + IP: 10.11.65.53 là 01040a0b4135. Cú pháp cấu hình trên FortiGate cần kiểm lại trên máy thật.
Sau khi adopt, đặt IP AP thành tĩnh: UniFi Devices → chọn AP → Settings → IP Settings → Static IP (hoặc giữ DHCP reservation). Đây là IP mà NPS dùng để nhận diện RADIUS client.
3.7 Tạo Network VLAN 75 cho SSID
Gateway là FortiGate nên UniFi chỉ cần biết VLAN để gán SSID. Theo bài "Creating Virtual Networks (VLANs)" của Ubiquiti, với gateway bên thứ ba thì tạo VLAN (subnet, VLAN ID, DHCP) trên gateway trước, rồi trong UniFi vào Settings → Networks → New Virtual Network: Name VLAN75-USR, Router chọn Third-Party Gateway, VLAN ID 75. Không bật DHCP trên UniFi vì DHCP do FortiGate (10.11.75.0/24, gateway 10.11.75.1) cấp. Nhãn các lựa chọn theo phiên bản, cần kiểm lại trên máy thật.
Ubiquiti nhắc: mọi cổng giữa AP và gateway phải cho phép VLAN ID này, switch bên thứ ba phải cấu hình tay, nếu sai client sẽ không vào được WiFi (không nhận DHCP).
3.8 Tạo RADIUS Profile wifilab-radius
Vào Settings → Networks, cuộn xuống mục RADIUS Servers và tạo profile mới (theo bài "Configuring a RADIUS Server in UniFi"; ở các bản cũ hơn mục này nằm ở Settings → Profiles → RADIUS, các trường giống nhau). Profile mặc định Default RADIUS Server là RADIUS tích hợp của gateway UniFi, không dùng trong bài. Điền:
| Trường | Giá trị |
|---|---|
| Profile Name | wifilab-radius |
| Authentication Servers → IP Address | 10.11.65.52 |
| Authentication Servers → Port | 1812 |
| Authentication Servers → Password (shared secret) | RadiusSecret@2024! |
| Enable accounting | Bật; Accounting Server 10.11.65.52, Port 1813, Password RadiusSecret@2024! |
| Interim update | Bật, chu kỳ 300 giây (tùy chọn, cần cho CoA) |
| RADIUS assigned VLAN | Tắt (bật chỉ khi dùng Tunnel attributes ở mục 2.7) |
Shared secret phải khớp từng ký tự với secret của RADIUS client trên NPS (mục 2.5); sai secret thì NPS loại gói tin và mọi client đều thất bại. Nhấn Apply. Profile này được AP dùng trực tiếp để nói chuyện với NPS, Controller không chuyển tiếp RADIUS.
3.9 Tạo SSID HOATRAN-WIFI
Vào Settings → WiFi → Create New (theo help.ui.com "Creating UniFi WiFi SSIDs" và "WiFi SSID and AP Settings Overview"). Mặc định UniFi dùng WPA2/WPA3 Personal; để chọn Enterprise, trong phần Advanced chuyển từ Auto sang Manual rồi chọn Security Protocol:
| Trường | Giá trị |
|---|---|
| Name (SSID) | HOATRAN-WIFI |
| Network | VLAN75-USR (VLAN 75) |
| Broadcasting APs | All (hoặc chọn AP / nhóm cụ thể) |
| WiFi Band | 2.4 GHz và 5 GHz (6 GHz yêu cầu WPA3) |
| Security Protocol (trong Advanced → Manual) | WPA2 Enterprise để test đầu tiên; WPA3 Enterprise khi mọi client đã hỗ trợ (PMF Required) |
| RADIUS Profile | wifilab-radius |
| Fast Roaming (802.11r) | Tắt khi test lần đầu, bật lại sau khi PEAP chạy ổn |
| Client Device Isolation | Tắt |
| DAS/DAC (CoA) | Tắt (cần accounting và cổng 3799 nếu bật) |
Nhấn Add WiFi Network, chờ trạng thái provisioning của AP xong (vài chục giây). Tài liệu Ubiquiti: chọn "Enterprise" cho xác thực bằng RADIUS, WPA2/WPA3 Personal cho mạng thường; mọi mạng 6 GHz bắt buộc dùng WPA3 hoặc OWE.
Tùy chọn: SSID khách HOATRAN-GUEST (không 802.1X, dùng Guest Network hoặc OWE trên VLAN riêng) chỉ nêu để biết, không triển khai trong bài.
3.10 Lưu ý thực tế
- RADIUS client là AP, không phải Controller. Gói Access-Request đi từ IP của AP tới
10.11.65.52; Controller10.11.65.53không cần khai báo trên NPS. Tài liệu Ubiquiti về CoA cũng nói rõ cổng giữa AP và RADIUS server. - IP AP không đổi: dùng DHCP reservation hoặc IP tĩnh; đổi IP thì NPS bỏ gói và client báo lỗi chung chung.
- Đồng hồ: DC, Controller và client lệch giờ quá lớn làm client từ chối chứng chỉ máy chủ NPS (chưa có hiệu lực hoặc đã hết hạn); kiểm tra
w32tm /query /statustrên DC vàchronyc trackingtrên unifi. - Tin cậy chứng chỉ máy chủ: client phải tin
WIFILAB-ROOT-CAvà thấy tênwifi-dc01.wifilab.local. Máy domain nhận qua GPO, máy ngoài domain xem Phần 4. Dấu vân tay (thumbprint SHA-1) của chứng chỉ hiển thị ở hộp thoại "Continue connecting" của Windows và iOS; so khớp vớiGet-ChildItem Cert:\LocalMachine\Mytrên DC trước khi bấm tin cậy. - Chứng chỉ giao diện UniFi (11443) là tự ký, trình duyệt cảnh báo là bình thường và không liên quan chứng chỉ RADIUS.
- Nâng cấp UniFi: luôn tạo backup (mục 3.5) và snapshot VM trước khi cập nhật từ Control Plane; Ubiquiti cảnh báo nâng cấp có thể re-provision AP. Không chạy UniFi OS Server trong container LXC của Proxmox (installer cần tạo bridge mạng và đổi sysctl, một báo cáo cộng đồng ở bản 4.2.23 ghi lỗi); bài dùng VM.
- Đang dùng gói
.debcũ: nếu đã có UniFi Network Server cài bằng gói.deb, đóng nó trước khi cài UniFi OS Server (không chạy song song trên cùng máy) rồi di chuyển bằng backup.unfhoặc Site Export theo bài "Backups and Migration in UniFi".
Test client vào WiFi RADIUS và kiểm tra
Chuẩn bị trước khi test · Windows 11 không join domain · Windows 11 join domain (nhận profile từ GPO)
Mục tiêu của phần này: chứng minh cả chuỗi hoạt động (client → AP → NPS → AD), đọc được log ở cả ba phía, và biết cách xử lý các lỗi thường gặp.
4.1 Chuẩn bị trước khi test
Kiểm tra nhanh từng mắt xích trước khi cầm điện thoại:
| Kiểm tra | Lệnh / nơi xem | Kết quả mong đợi |
|---|---|---|
| NPS đang nghe | Get-NetUDPEndpoint -LocalPort 1812,1813 (trên DC) | Có dòng cổng 1812 và 1813 |
| RADIUS client có AP | Get-NpsRadiusClient hoặc NPS console | Có UniFi-AP-Range hoặc UniFi-AP-01 |
| Network Policy đứng đầu | NPS → Network Policies | WiFi-HOATRAN-Users ở vị trí 1, Enabled |
| Chứng chỉ NPS | NPS → Network Policy → PEAP → Edit | wifi-dc01.wifilab.local, Issuer WIFILAB-ROOT-CA |
| AP Connected, SSID đã provision | UniFi → UniFi Devices | AP trạng thái Connected |
| FortiGate cho UDP 1812/1813 | Policy 1 ở mục "Điều kiện tiên quyết" | Có hit count tăng khi test |
Tài khoản test: wifi.user1 / User1@Wifi2024! (thuộc WiFi-Users), wifi.guest / Guest@Wifi2024! (không thuộc nhóm, dùng để thử từ chối).
4.2 Windows 11 không join domain
Bản dùng để test: Windows 11 25H2 hoặc 26H2 (bản hiện hành, đã cập nhật cumulative mới nhất); các bước giống nhau trên cả hai bản.
Chuẩn bị chứng chỉ gốc để Windows không phải hỏi tin cậy từng lần: copy C:\PKI\WIFILAB-ROOT-CA.cer từ DC sang laptop (USB, chia sẻ tệp hoặc Mattermost bài 37), rồi chạy PowerShell Run as Administrator trên laptop:
certutil -addstore -f Root C:\Users\Public\WIFILAB-ROOT-CA.cer
Kết nối:
wifi.user1 (hoặc [email protected], hoặc WIFILAB\wifi.user1), Password User1@Wifi2024! → OK.wifi-dc01.wifilab.local; nhấn Show certificate details để xem thumbprint, so khớp với DC rồi bấm Connect. Đây là chuỗi cảnh báo chứng chỉ của client; với CA gốc đã cài thì hộp thoại này không xuất hiện.
netsh wlan show interfaces
ipconfig
Kết quả mong đợi: Authentication: WPA2-Enterprise, State: connected, IP dạng 10.11.75.x, gateway 10.11.75.1. Để nhập lại thông tin đăng nhập sau khi đã lưu: netsh wlan delete profile name="HOATRAN-WIFI" rồi kết nối lại.
4.3 Windows 11 join domain (nhận profile từ GPO)
Dùng khi muốn trải nghiệm cấu hình doanh nghiệp đầy đủ. Join domain bằng đường có dây hoặc mạng khác trước (như khuyến nghị của Microsoft trong hướng dẫn Wireless Access Deployment), đặt DNS của máy là 10.11.65.52:
Add-Computer -DomainName wifilab.local -Credential WIFILAB\Administrator `
-OUPath "OU=Computers,OU=WIFILAB,DC=wifilab,DC=local" -Restart
Sau khi đăng nhập bằng WIFILAB\wifi.user1, chạy gpupdate /force. Máy nhận hai GPO: CA gốc vào kho Trusted Root Certification Authorities (kiểm tra bằng certutil -store Root | findstr WIFILAB) và profile WiFi HOATRAN-WIFI (netsh wlan show profiles). Từ đó máy tự kết nối bằng tài khoản domain đang đăng nhập, không cần nhập thêm hoặc xác nhận chứng chỉ. Nếu máy là Windows 11 Enterprise/Education có Credential Guard hoạt động thì vẫn bị hỏi mật khẩu (xem lưu ý ở mục 2.9).
4.4 Android và iOS
Android (tên menu khác nhau theo hãng và phiên bản):
- Chép
WIFILAB-ROOT-CA.cervào máy, vào Cài đặt → Bảo mật → Mã hóa & thông tin xác thực → Cài đặt chứng chỉ → Chứng chỉ CA. - Cài đặt → WiFi → HOATRAN-WIFI: EAP method
PEAP, Phase 2 authenticationMSCHAPV2, CA certificate chọn chứng chỉ vừa cài, Domainwifilab.local, Identitywifi.user1, Anonymous identity để trống, PasswordUser1@Wifi2024!→ Connect. - Android 11 trở lên không cho kết nối nếu để "không xác thực" chứng chỉ mà không có Domain; điền
wifilab.localđể Android kiểm tra tên trong chứng chỉ máy chủ.
iOS:
- Mở tệp
.cer(AirDrop, email) → Cài đặt → Đã tải hồ sơ → Cài đặt; sau đó Cài đặt → Cài đặt chung → Giới thiệu → Cài đặt tin cậy chứng nhận → bật tin cậy hoàn toàn choWIFILAB-ROOT-CA. - Cài đặt → Wi-Fi → HOATRAN-WIFI → nhập Username
wifi.user1, PasswordUser1@Wifi2024!→ Join. Nếu chưa cài CA, iPhone hiện hộp thoại Certificate vớiwifi-dc01.wifilab.local: nhấn Trust sau khi xem chi tiết.
4.5 Kiểm tra phía NPS
Mở Event Viewer → Custom Views → Server Roles → Network Policy and Access Services (hoặc Windows Logs → Security). Sự kiện 6272 là NPS cho phép truy cập, 6273 là từ chối. Thử kết nối thành công rồi thất bại và đọc:
Get-WinEvent -FilterHashtable @{LogName='Security'; Id=6272,6273} -MaxEvents 6 | ForEach-Object {
"{0} Event {1}" -f $_.TimeCreated, $_.Id
$_.Message -split "`r?`n" |
Select-String -Pattern 'Account Name:|Network Policy Name:|Connection Request Policy Name:|Reason Code:|Reason:|Calling Station Identifier:|NAS IPv4 Address:' |
ForEach-Object { ' ' + $_.Line.Trim() }
}
Trong 6272 thành công, Network Policy Name phải là WiFi-HOATRAN-Users, Connection Request Policy Name là WiFi-HOATRAN-CRP. Calling Station Identifier là MAC của client, NAS IPv4 Address là IP của AP. Trong 6273 đọc Reason Code theo bảng của Microsoft:
| Reason Code | Ý nghĩa (tóm tắt theo tài liệu Microsoft) |
|---|---|
| 16 | Sai thông tin: tên người dùng không tồn tại hoặc sai mật khẩu |
| 22 / 23 | NPS không thương lượng được kiểu EAP với client / lỗi trong quá trình EAP; hay gặp khi client bỏ ngang vì không tin chứng chỉ (cần kiểm lại trên máy thật) |
| 34 / 35 / 36 | Tài khoản bị vô hiệu hóa / hết hạn / bị khóa do nhập sai nhiều lần |
| 48 | Yêu cầu không khớp Network Policy nào (ví dụ user ngoài nhóm, sai NAS Port Type) |
| 49 | Yêu cầu không khớp Connection Request Policy nào |
| 65 | Tab Dial-in của user đang đặt Deny access |
| 66 | Client dùng phương thức xác thực không được bật trong policy khớp |
Đọc thêm nhật ký accounting (C:\Windows\System32\LogFiles) khi cần xem Start/Stop của phiên.
4.6 Kiểm tra phía UniFi
- Clients (bản cũ gọi là Client Devices): thiết bị xuất hiện với SSID
HOATRAN-WIFI, mạngVLAN75-USR, IP10.11.75.x, AP đang kết nối. - Insights / Events / System Log (tên menu theo phiên bản): sự kiện client kết nối, chuyển AP, ngắt kết nối. Client bị từ chối thường chỉ hiện là không kết nối được; lý do chi tiết xem ở NPS.
- UniFi Devices → AP → Settings (Debug): Ubiquiti khuyến nghị dùng Debug Console trong giao diện thay vì SSH khi cần xem trạng thái AP.
4.7 Test từ Linux bằng eapol_test và radtest
Chạy trên unifi (cùng VLAN 65 với DC nên không qua FortiGate). Trước hết khai báo máy test là RADIUS client tạm trên DC:
New-NpsRadiusClient -Name "Test-Linux-unifi" -Address "10.11.65.53" -SharedSecret "RadiusSecret@2024!"
Restart-Service IAS
Trên unifi, cài eapol_test (gói eapoltest 2:2.10-21ubuntu0.2 nằm trong kho universe của Ubuntu 24.04, kiểm tra bằng apt-cache policy eapoltest; radtest nằm trong freeradius-utils, bản 3.2.5 của Ubuntu noble) và dán chứng chỉ gốc dạng PEM lấy từ C:\PKI\WIFILAB-ROOT-CA.pem. Trên unifi chỉ dùng hai công cụ client này, không chạy dịch vụ máy chủ FreeRADIUS, nên thông báo bảo mật của FreeRADIUS < 3.2.9 (tràn bộ đệm phía server) không áp dụng ở đây; máy chủ FreeRADIUS thật của bài 40 dùng bản 3.2.10 từ kho InkBridge:
sudo apt install -y eapoltest freeradius-utils
sudo mkdir -p /etc/wifi-test
sudo nano /etc/wifi-test/WIFILAB-ROOT-CA.pem # dán nội dung file .pem từ DC
sudo tee /etc/wifi-test/peap.conf > /dev/null << 'EOF'
network={
ssid="HOATRAN-WIFI"
key_mgmt=WPA-EAP
eap=PEAP
identity="wifi.user1"
anonymous_identity="anonymous"
password="User1@Wifi2024!"
phase2="auth=MSCHAPV2"
ca_cert="/etc/wifi-test/WIFILAB-ROOT-CA.pem"
domain_suffix_match="wifi-dc01.wifilab.local"
}
EOF
# NAS-Port-Type = 19 (Wireless-802.11) để khớp điều kiện của Network Policy
eapol_test -c /etc/wifi-test/peap.conf -a 10.11.65.52 -p 1812 \
-s 'RadiusSecret@2024!' -N 61:d:19 -t 30
Kết quả mong đợi: dòng cuối SUCCESS (nhận Access-Accept) và trên DC có Event 6272. Đổi identity/password sang wifi.guest để thấy FAILURE và Event 6273 Reason Code 48. Cú pháp -N 61:d:19 (attr_id:syntax:value, d là số nguyên) theo man page của eapol_test.
radtest chỉ gửi PAP/CHAP/MSCHAP chứ không gửi EAP, nên với policy chỉ cho PEAP thì bị từ chối là đúng. Dùng làm phép thử "phương thức không được phép":
radtest -t mschap wifi.user1 'User1@Wifi2024!' 10.11.65.52 0 'RadiusSecret@2024!'
# Mong đợi: Access-Reject; NPS ghi 6273 (Reason Code 48 hoặc 66)
Xóa client tạm khi xong: Remove-NpsRadiusClient -Name "Test-Linux-unifi" rồi Restart-Service IAS.
4.8 Kịch bản sai và cách khắc phục
| Kịch bản | Cách tạo | Hiện tượng | Dấu vết ở NPS | Khắc phục |
|---|---|---|---|---|
| Sai mật khẩu | Nhập sai password wifi.user1 | Windows hỏi lại, điện thoại báo xác thực thất bại | 6273, Reason Code 16 | Nhập đúng; nếu bị khóa xem Reason 36 và Unlock-ADAccount wifi.user1 |
| User ngoài nhóm | Đăng nhập wifi.guest | Từ chối dù mật khẩu đúng | 6273, Reason Code 48 | Add-ADGroupMember WiFi-Users wifi.guest nếu cần cho phép |
| Chứng chỉ chưa tin cậy | Máy ngoài domain chưa cài CA gốc | Windows hỏi "Continue connecting?"; Android/iOS báo lỗi chứng chỉ; máy domain không nhận GPO thì không vào được | 6273 Reason 22/23 hoặc phiên EAP bị bỏ ngang (cần kiểm lại) | Cài WIFILAB-ROOT-CA.cer, chạy gpupdate /force, kiểm tra tên server wifi-dc01.wifilab.local |
| Sai shared secret | Đổi secret ở UniFi khác NPS | Mọi client đều thất bại | Không có 6272/6273 của người dùng; System log có sự kiện về Message-Authenticator không hợp lệ hoặc 6274 Reason 3 (cần kiểm lại) | Đặt lại secret giống hệt ở UniFi RADIUS profile và NPS RADIUS client |
| AP chưa là RADIUS client | IP AP nằm ngoài dải đã khai báo | Mọi client thất bại | System log báo gói từ RADIUS client có IP không hợp lệ (cần kiểm lại) | Thêm IP AP vào RADIUS client, Restart-Service IAS |
| Đồng hồ lệch | Chỉnh giờ client lùi 2 ngày (tắt đồng bộ giờ) | Client báo chứng chỉ chưa có hiệu lực; join domain/Kerberos lỗi | Không có 6272 thành công | w32tm /resync trên DC, chronyc tracking trên unifi, bật lại đồng bộ giờ trên client |
| Firewall chặn | Tắt policy UDP 1812/1813 trên FortiGate | Client treo ở "Connecting" rồi lỗi | Không có sự kiện nào | Bật lại policy; xem log FortiGate, Get-NetUDPEndpoint -LocalPort 1812 |
| Tài khoản bị vô hiệu hóa | Disable-ADAccount wifi.user2 | Từ chối | 6273, Reason Code 34 | Enable-ADAccount wifi.user2 |
4.9 Nghiệm thu
Coi như hoàn thành khi: wifi.user1 vào được WiFi và nhận IP VLAN 75; wifi.guest bị từ chối với Reason Code 48; xóa user khỏi WiFi-Users rồi kết nối lại bị từ chối; eapol_test ra SUCCESS; có cả sự kiện 6272 và 6273 trên DC; UniFi hiển thị client đúng SSID và VLAN.
Backup, giám sát và vận hành
Job backup VM trên PVE (VM281 và VM282) · System State của Windows (sao lưu trong VM) · Backup file-level của unifi lên PBS (lúc 05:00)
Lịch backup không trùng các bài khác (bài 13 lúc 01:00, bài 17 lúc 02:00, bài 18 lúc 02:30, bài 14 lúc 03:00, bài 15 lúc 03:30, bài 16 lúc 04:00): System State Windows 00:30, job PVE 01:30, backup file-level của unifi 05:00.
5.1 Job backup VM trên PVE (VM281 và VM282)
GUI: Datacenter → Backup → Add: Storage pbs-primary, Schedule 01:30, Selection mode Include selected VMs → chọn VM 281 và 282, Mode Snapshot → Create. Namespace st-20 đã gắn sẵn trong storage pbs-primary, không điền ở cấp job. Tương đương CLI (chạy trên một node bất kỳ):
pvesh create /cluster/backup --vmid 281,282 --storage pbs-primary --schedule "01:30" \
--mode snapshot --enabled 1 --comment "WiFi RADIUS (bai 39)"
vzdump 281 --storage pbs-primary --mode snapshot # chạy thử một lần
Với VM281, Qemu Guest Agent đã cài ở mục 1.3 nên snapshot có đóng băng hệ thống tệp (VSS). Khôi phục một DC từ backup an toàn nhờ VM Generation ID (--vmgenid 1); kịch bản khôi phục một forest chỉ có một DC không gặp vấn đề USN rollback.
5.2 System State của Windows (sao lưu trong VM)
PBS client không phát hành cho Windows, nên sao lưu System State (AD, SYSVOL, registry, cơ sở dữ liệu CA) bằng Windows Server Backup ra ổ F: (ổ 30 GB thuộc VM, được job PVE ở trên sao lưu theo), chạy lúc 00:30 để bản mới nhất nằm trong snapshot 01:30:
Install-WindowsFeature Windows-Server-Backup
wbadmin start systemstatebackup -backupTarget:F: -quiet
$a = New-ScheduledTaskAction -Execute "wbadmin.exe" -Argument "start systemstatebackup -backupTarget:F: -quiet"
$t = New-ScheduledTaskTrigger -Daily -At 00:30
Register-ScheduledTask -TaskName "SystemState-Backup" -Action $a -Trigger $t -User "SYSTEM" -RunLevel Highest
wbadmin get versions
Sao lưu cấu hình CA và NPS thủ công khi thay đổi: certutil -backup F:\CA-Backup (sẽ hỏi mật khẩu bảo vệ khóa) và netsh nps export (mục 2.10). Khôi phục System State dùng chế độ DSRM với mật khẩu Dsrm@WifiLab2024! (cần kiểm lại quy trình trên máy thật).
5.3 Backup file-level của unifi lên PBS (lúc 05:00)
Theo quy ước bài 04 mục 5.7: PBS user vm-backup@pbs, token vm-backup@pbs!unifi, namespace vm-unifi trong datastore syno-primary; tạo token và gán ACL DatastoreBackup tại /datastore/syno-primary/vm-unifi trên pbs01 trước khi chạy.
UniFi OS Server không còn lưu dữ liệu ở /var/lib/unifi như gói .deb cũ mà lưu trong các volume Podman của tài khoản hệ thống uosserver. Có hai lớp bảo vệ: job PVE 01:30 (mục 5.1) sao lưu cả VM, còn job dưới đây chép riêng thư mục volume của uosserver và /etc lên PBS. Dữ liệu là cơ sở dữ liệu đang chạy trong container, nên script dừng dịch vụ uosserver vài phút để có bản chép nhất quán rồi chạy lại; AP vẫn dùng cấu hình cuối cùng trong lúc controller tắt (theo help.ui.com). Bản backup offline tải từ Settings → Control Plane → Backups (mục 3.5) vẫn là cách khôi phục được Ubiquiti hỗ trợ, nên hãy tải một bản sau mỗi thay đổi lớn.
Trước hết xác định đúng đường dẫn volume trên máy của bạn (đường dẫn dưới đây theo ghi nhận cộng đồng, cần kiểm lại trên máy thật):
# Chạy trên unifi (sudo -i)
UOS_HOME=$(getent passwd uosserver | cut -d: -f6)
echo "$UOS_HOME"
ls "$UOS_HOME/.local/share/containers/storage/volumes/" # kỳ vọng thấy các volume dạng uosserver_*
du -sh "$UOS_HOME/.local/share/containers/storage/volumes/"
Cài client và tạo script. Proxmox Backup Server 4.x dùng repo pbs-client của Debian 13 "trixie"; tài liệu PBS ghi gói proxmox-backup-client-static là bản liên kết tĩnh cho mọi Linux x86-64 hiện đại và nói các bản Debian/Ubuntu "có thể dùng" repo này. Dùng gói -static trên Ubuntu 24.04 (glibc 2.39) để không phụ thuộc phiên bản thư viện hệ thống (gói động build cho trixie có thể đòi glibc mới hơn của Ubuntu 24.04); việc apt trên noble nhận kho/khóa này cần kiểm lại trên máy thật. Khóa đặt trong /usr/share/keyrings và khai báo bằng Signed-By (không dùng apt-key):
# Chạy trên unifi (sudo -i)
curl -fsSL https://enterprise.proxmox.com/debian/proxmox-archive-keyring-trixie.gpg \
-o /usr/share/keyrings/proxmox-archive-keyring.gpg
cat > /etc/apt/sources.list.d/pbs-client.sources << 'EOF'
Types: deb
URIs: http://download.proxmox.com/debian/pbs-client
Suites: trixie
Components: main
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
EOF
apt update && apt install -y proxmox-backup-client-static
cat > /usr/local/bin/unifi-backup.sh << 'EOF'
#!/bin/bash
set -euo pipefail
# Backup file-level theo bài 04 mục 5.7: token vm-backup@pbs!unifi, namespace vm-unifi
export PBS_PASSWORD="<TOKEN_SECRET>"
# export PBS_FINGERPRINT="XX:YY:..." # nếu pbs01 dùng chứng chỉ chưa được tin cậy
UOS_HOME=$(getent passwd uosserver | cut -d: -f6)
VOLDIR="$UOS_HOME/.local/share/containers/storage/volumes"
test -d "$VOLDIR"
# Dừng UniFi OS Server để chép nhất quán, luôn chạy lại dù backup lỗi
systemctl stop uosserver
trap 'systemctl start uosserver' EXIT
proxmox-backup-client backup \
"uosvolumes.pxar:${VOLDIR}" \
"etc.pxar:/etc" \
--repository "vm-backup@[email protected]:syno-primary" \
--ns vm-unifi
EOF
chmod +x /usr/local/bin/unifi-backup.sh
echo "0 5 * * * root /usr/local/bin/unifi-backup.sh >> /var/log/unifi-backup.log 2>&1" \
> /etc/cron.d/unifi-backup
Chạy thử một lần bằng /usr/local/bin/unifi-backup.sh && systemctl is-active uosserver, rồi xem snapshot trong namespace vm-unifi trên PBS. Khôi phục volume phải làm khi uosserver đang dừng: chép về đúng đường dẫn rồi chạy lại dịch vụ. Quy trình khôi phục này chưa được thử trong bài (cần kiểm lại trên máy thật).
5.4 Giám sát: node_exporter cho unifi
Chạy script install-node-exporter.sh ở bài 15 (Bước 5) trên unifi (UFW đã mở 9100 cho Prometheus ở mục 3.3). Script ở bài 15 đã ghim NODE_EXPORTER_VERSION="1.12.1" (bản stable mới nhất ngày 2026-10-15, phát hành 2026-07-14, giá trị dùng chung của cả series) nên chạy nguyên script trên unifi, không cần sửa; tên tệp tải về theo mẫu node_exporter-<phiên bản>.linux-amd64.tar.gz. Sau đó thêm 10.11.65.53:9100 vào danh sách target của job node_exporter trong prometheus.yml trên VM235 và nạp lại:
curl -X POST http://10.11.45.35:9090/-/reload
curl -s http://10.11.65.53:9100/metrics | head -3
wifi-dc01 là Windows nên không chạy node_exporter của Linux; muốn giám sát cần windows_exporter riêng (ngoài phạm vi bài). Theo dõi NPS bằng Event 6272/6273 và log accounting, theo dõi hạn chứng chỉ bằng certutil -store My.
Troubleshooting
| Vấn đề | Nguyên nhân | Giải pháp |
|---|---|---|
| Windows không bấm được vào ổ cài đặt | Thiếu driver VirtIO SCSI | Load driver vioscsi\2k22\amd64 từ ISO VirtIO (mục 1.2) |
Máy trong lab không phân giải wifilab.local | Pi-hole chưa có dòng conditional forward hoặc firewall chặn DNS tới DC | docker exec pihole pihole-FTL --config misc.dnsmasq_lines; thử dig @10.11.65.52 wifi-dc01.wifilab.local; kiểm tra policy 5 và 6 |
Pi-hole trả SERVFAIL cho wifilab.local | DNSSEC của Pi-hole xử lý tên miền nội bộ không ký | Đối chiếu cách bài 12 xử lý hoatranlabs.local (cùng loại dòng server=/…/); cần kiểm lại trên máy thật |
dcdiag báo lỗi DNS sau promote | SRV record chưa đăng ký xong | Chờ 5 phút; Restart-Service Netlogon; ipconfig /registerdns |
| NPS không liệt kê chứng chỉ trong PEAP | Chưa autoenroll, Subject trống, thiếu EKU Server Authentication | Kiểm tra mục 2.3 và 2.4: Subject name format, RAS and IAS Servers, template đã Issue; khởi động lại, gpupdate /force; certutil -pulse |
| Client lỗi sau khi chứng chỉ NPS gia hạn | Policy PEAP đang trỏ chứng chỉ cũ | Mở lại WiFi-HOATRAN-Users → PEAP → Edit → chọn chứng chỉ mới (cần kiểm lại cơ chế tự chọn trên máy thật) |
Cổng 11443 của unifi không mở sau khi cài, hoặc uosserver không chạy | Container UniFi OS chưa khởi động xong, thiếu Podman/slirp4netns/passt, hoặc CPU VM không có AVX | Chờ vài phút; systemctl status uosserver, journalctl -u uosserver -n 50, sudo -u uosserver podman ps; kiểm tra podman --version ≥ 4.9.3; đổi CPU VM282 sang host; không chạy trong LXC |
| Installer UniFi OS Server báo thiếu podman hoặc phiên bản thấp, hoặc báo lỗi mạng | Chưa cài gói phụ thuộc | apt install -y podman slirp4netns passt uidmap iptables, kiểm tra lại podman --version và slirp4netns --version; lấy link installer mới nhất ở trang Download của Ubiquiti (link cũ có thể hết hiệu lực); cần kiểm lại trên Ubuntu 24.04 |
Installer hoặc podman báo cannot clone: Permission denied / cannot re-exec process, uosserver không tạo được container (Ubuntu 24.04) | AppArmor 24.04 hạn chế user namespace không đặc quyền (kernel.apparmor_restrict_unprivileged_userns=1) và tiến trình Podman rootless không khớp profile có dòng userns | journalctl -k | grep -i userns_create có apparmor="DENIED" thì xác nhận bằng echo 0 | sudo tee /proc/sys/kernel/apparmor_restrict_unprivileged_userns; giữ lâu dài bằng /etc/sysctl.d/60-apparmor-namespace.conf (kernel.apparmor_restrict_unprivileged_userns=0) hoặc profile userns cho đúng tệp bị chặn (mục 3.4; cần kiểm lại trên máy thật) |
| AP kẹt ở Pending hoặc Adopting | AP không tới được TCP 8080 của unifi, hoặc inform URL sai | ssh ui@IP_AP rồi set-inform http://10.11.65.53:8080/inform lần nữa; kiểm tra policy 2 và UFW; nếu adopt xong lại Disconnected thì bật Override Inform Host 10.11.65.53 (mục 3.6) |
| Client vào WiFi nhưng không có IP | Cổng switch của AP thiếu tag VLAN 75, hoặc FortiGate chưa có DHCP VLAN 75 | Cho phép VLAN 75 trên cổng AP và các uplink; kiểm tra DHCP server của interface VLAN 75 |
| Client vào sai VLAN | Dùng Tunnel attributes nhưng RADIUS assigned VLAN chưa bật hoặc VLAN chưa tồn tại | Tắt thuộc tính trả VLAN hoặc bật tùy chọn trong RADIUS profile và tạo VLAN trong UniFi |
| Windows không hỏi mật khẩu mới | Profile cũ lưu thông tin đăng nhập | netsh wlan delete profile name="HOATRAN-WIFI" rồi kết nối lại |
| Android không kết nối | Thiếu CA hoặc thiếu Domain wifilab.local | Cài CA gốc và điền Domain (mục 4.4) |
| NPS từ chối mọi yêu cầu, Reason Code 48 | Network Policy không đứng đầu hoặc sai điều kiện NAS Port Type | Move Up WiFi-HOATRAN-Users; đối chiếu NAS-Port-Type trong log accounting, nếu AP gửi giá trị khác thì chỉnh điều kiện (cần kiểm lại với bản UniFi của bạn) |
| Hết hạn bản Evaluation | Windows Server Evaluation chỉ 180 ngày | slmgr /dlv xem thời hạn; cần license hoặc dựng lại (bài 40 là phương án không license) |
Checklist triển khai
Phần 1 — Windows, AD, DNS
- VM281
wifi-dc01tạo trên node2, VLAN 65, Datacenter Evaluation (Desktop Experience) cài xong - Driver VirtIO và Qemu Guest Agent cài xong,
qm config 281cóvmgenid - IP
10.11.65.52/24, gateway10.11.65.1, tên máywifi-dc01, múi giờ Asia/Ho_Chi_Minh - Forest
wifilab.local(NetBIOSWIFILAB, mứcWin2012R2) promote thành công,Get-ADForestraWindows2012R2Forest,Get-ADDomainraWindows2012R2Domain,dcdiag /qsạch - DNS forwarder về Pi-hole
10.11.45.53, reverse zone10.11.65.0/24có PTR - OU
WIFILAB, nhómWiFi-Users,WiFi-Admins, userwifi.user1,wifi.user2,wifi.admin,wifi.guestđã tạo -
w32tm /query /statusđồng bộ với NTP công cộng - Pi-hole có
server=/wifilab.local/10.11.65.52và bản ghiunifi.hoatranlabs.local
Phần 2 — NPS, RADIUS, chứng chỉ
- Enterprise Root CA
WIFILAB-ROOT-CAonline, đã xuấtC:\PKI\WIFILAB-ROOT-CA.cer - NPS cài xong và đã đăng ký AD (
RAS and IAS Serverscówifi-dc01) - Template
WiFi-NPS-Serverđược Issue, GPOWiFi-PKI-Autoenrollđã link domain - DC có chứng chỉ
CN=wifi-dc01.wifilab.localtừ templateWiFi-NPS-Server - RADIUS Client cho AP (
UniFi-AP-Rangehoặc từng AP) với secret khớp UniFi - Connection Request Policy
WiFi-HOATRAN-CRPvà Network PolicyWiFi-HOATRAN-Usersở vị trí đầu - PEAP + EAP-MSCHAPv2 dùng đúng chứng chỉ, các phương thức kém an toàn đã bỏ
- Audit NPS bật, accounting ghi tệp, UDP 1812/1813 mở trong Windows Firewall
- GPO
WiFi-Client-Wirelesscó profileHOATRAN-WIFI -
netsh nps exportraC:\NPS-Backup\nps-wifi.xml
Phần 3 — UniFi
- VM282
unifitạo trên node3, CPUhost, Ubuntu Server 24.04.5 LTS, IP10.11.65.53/24 - UFW bật, mở 22, 8080, 11443, 3478/udp, 9100 đúng nguồn
- Podman 4.9.3 (≥ 4.9.3), slirp4netns 1.2.1, passt cài xong; UniFi OS Server 5.x cài bằng installer, dịch vụ
uosserveractive (không cóuserns_createDENIED trongjournalctl -k) - Đăng nhập
https://10.11.65.53:11443thành công, tài khoản quản trị cục bộ đã tạo, Network Application đã cập nhật bản mới nhất - Settings → Control Plane → Backups: đã tải một bản backup offline
- AP adopt xong (
set-inform), trạng thái Connected, IP AP cố định - Network
VLAN75-USR(VLAN 75) đã tạo - RADIUS profile
wifilab-radius(10.11.65.52, 1812/1813) đã tạo - SSID
HOATRAN-WIFIWPA2/WPA3 Enterprise gán profile và VLAN 75 - Policy FortiGate: AP → NPS UDP 1812/1813, AP → unifi TCP 8080 và UDP 3478
Phần 4 — Test
- Windows 11 (không domain) kết nối được bằng
wifi.user1, nhận IP10.11.75.x - Android hoặc iOS kết nối được với CA đã cài
-
wifi.guestbị từ chối, NPS ghi 6273 Reason Code 48 - Sai mật khẩu ghi 6273 Reason Code 16
-
eapol_testtrảSUCCESS - UniFi Clients hiển thị client đúng SSID và VLAN
Phần 5 — Vận hành
- Job PVE 01:30 sao lưu VM281 và VM282 lên
pbs-primary - System State chạy 00:30,
wbadmin get versionscó bản mới - Backup file-level
unifi(tokenvm-backup@pbs!unifi, namespacevm-unifi) chạy 05:00 - node_exporter trên
unifiđược Prometheus scrape
Tài Liệu Tham Khảo
- UniFi — Self-Hosting UniFi (UniFi OS Server: yêu cầu, cài đặt Linux, lệnh systemctl): https://help.ui.com/hc/en-us/articles/34210126298775-Self-Hosting-UniFi
- UniFi — Tải xuống UniFi OS Server (bản 5.1.42, Network Application 10.x): https://ui.com/download/software/unifi-os-server
- UniFi — Ghi chú phát hành UniFi OS Server 5.1.42: https://community.ui.com/releases/r/uosserver/5.1.42
- UniFi — Backups and Migration in UniFi (Settings > Control Plane > Backups, Override Inform Host): https://help.ui.com/hc/en-us/articles/360008976393-Backups-and-Migration-in-UniFi
- UniFi — Creating Virtual Networks (VLANs) (Third-Party Gateway): https://help.ui.com/hc/en-us/articles/9761080275607
- UniFi — Required Ports Reference: https://help.ui.com/hc/en-us/articles/218506997-Required-Ports-Reference
- UniFi — Remote Adoption (Layer 3): https://help.ui.com/hc/en-us/articles/204909754-Remote-Adoption-Layer-3
- UniFi — Connecting to UniFi with Debug Tools & SSH: https://help.ui.com/hc/en-us/articles/204909374-Connecting-to-UniFi-with-Debug-Tools-SSH
- UniFi — Creating UniFi WiFi SSIDs: https://help.ui.com/hc/en-us/articles/26136823938583-Creating-UniFi-WiFi-SSIDs
- UniFi — WiFi SSID and AP Settings Overview: https://help.ui.com/hc/en-us/articles/32065480092951-UniFi-WiFi-SSID-and-AP-Settings-Overview
- UniFi — Using PPSK / RADIUS for Multiple VLANs On an SSID: https://help.ui.com/hc/en-us/articles/29887064407319-Using-PPSK-RADIUS-for-Multiple-VLANs-On-an-SSID-in-UniFi-Network
- UniFi — Configuring a RADIUS Server in UniFi (RADIUS assigned VLAN, CoA): https://help.ui.com/hc/en-us/articles/360015268353-Configuring-a-RADIUS-Server-in-UniFi
- UniFi — Setting Up Passpoint (Settings > Profiles > RADIUS): https://help.ui.com/hc/en-us/articles/25473982758551-Setting-Up-Passpoint-on-UniFi-Network
- MongoDB Production Notes (yêu cầu AVX): https://www.mongodb.com/docs/manual/administration/production-notes/
- Microsoft — Install-ADDSForest: https://learn.microsoft.com/en-us/powershell/module/addsdeployment/install-addsforest
- Microsoft — Install-AdcsCertificationAuthority: https://learn.microsoft.com/en-us/powershell/module/adcsdeployment/install-adcscertificationauthority
- Microsoft — Register an NPS in an Active Directory Domain: https://learn.microsoft.com/en-us/windows-server/networking/technologies/nps/nps-manage-register
- Microsoft — Configure RADIUS Clients (dải IP chỉ Datacenter): https://learn.microsoft.com/en-us/windows-server/networking/technologies/nps/nps-radius-clients-configure
- Microsoft — Configure Certificate Templates for PEAP and EAP requirements: https://learn.microsoft.com/en-us/windows-server/networking/technologies/nps/nps-manage-cert-requirements
- Microsoft — Configure the Server Certificate Template: https://learn.microsoft.com/en-us/windows-server/networking/core-network-guide/cncg/server-certs/configure-server-certificate-template-remote-access-network-policy-server
- Microsoft — Configure Certificate Auto-Enrollment for NPS: https://learn.microsoft.com/en-us/windows-server/networking/core-network-guide/cncg/server-certs/configure-server-certificate-auto-enrollment
- Microsoft — Wireless Access Deployment (GPO Wireless, NPS cho 802.1X): https://learn.microsoft.com/en-us/windows-server/networking/core-network-guide/cncg/wireless/e-wireless-access-deployment
- Microsoft — Export an NPS Configuration: https://learn.microsoft.com/en-us/windows-server/networking/technologies/nps/nps-manage-export
- Microsoft — New-NpsRadiusClient: https://learn.microsoft.com/en-us/powershell/module/nps/new-npsradiusclient
- Microsoft — NPS Reason Codes: https://learn.microsoft.com/en-us/previous-versions/windows/it-pro/windows-server-2008-R2-and-2008/dd197464(v=ws.10) và https://learn.microsoft.com/en-us/previous-versions/windows/it-pro/windows-server-2008-R2-and-2008/dd197521(v=ws.10)
- Ubuntu — Ubuntu Server 24.04.5 LTS ISO và SHA256SUMS: https://releases.ubuntu.com/24.04/
- Ubuntu — Ghi chú phát hành 24.04 LTS (giới hạn user namespace của AppArmor,
kernel.apparmor_restrict_unprivileged_userns): https://documentation.ubuntu.com/release-notes/24.04/ - Ubuntu — Gói podman 4.9.3 trên 24.04 (noble): https://packages.ubuntu.com/noble/podman
- Ubuntu — Danh sách tệp gói apparmor trên noble (profile podman, crun, slirp4netns, rootlesskit): https://packages.ubuntu.com/noble/amd64/apparmor/filelist
- Ubuntu — timedatectl và systemd-timesyncd (chrony thay thế khi được cài): https://ubuntu.com/server/docs/how-to/networking/timedatectl-and-timesyncd/
- Samba — Man page smb.conf 4.19 (
ad dc functional level: 2008_R2, 2012, 2012_R2, 2016): https://www.samba.org/samba/docs/4.19/man-html/smb.conf.5.html - Samba — Ghi chú phát hành 4.19.0 (Functional Level 2012/2012R2/2016 mới triển khai một phần): https://www.samba.org/samba/history/samba-4.19.0.html
- Tranquil-IT — Adding a Samba-AD in a Microsoft Active Directory domain (Samba 4.20 trở lên hỗ trợ schema MSAD 2016 với forest level 2016): https://samba.tranquil.it/doc/en/samba_advanced_methods-samba_add_samba_to_windows_domain.html
- Microsoft — Active Directory Domain Services Functional Levels (WS2022 chạy ở 2012 R2 và 2016): https://learn.microsoft.com/en-us/windows-server/identity/ad-ds/active-directory-functional-levels
- Proxmox — Cài Proxmox Backup Client (repo pbs-client, suite trixie, gói -static): https://pbs.proxmox.com/docs/installation.html
- Prometheus — node_exporter releases (bản 1.12.1): https://github.com/prometheus/node_exporter/releases
- Microsoft — Windows Server 2022 Evaluation (ISO, 180 ngày): https://www.microsoft.com/en-us/evalcenter/evaluate-windows-server-2022
- Microsoft — LDAP signing và mặc định trên Windows Server 2025: https://learn.microsoft.com/en-us/windows-server/identity/ad-ds/ldap-signing
- Microsoft — Credential Guard: các lưu ý và vấn đề đã biết (MS-CHAPv2, 802.1X): https://learn.microsoft.com/en-us/windows/security/identity-protection/credential-guard/considerations-known-issues
- Pi-hole — FTL configuration (
misc.dnsmasq_lines,dns.revServers): https://docs.pi-hole.net/ftldns/configfile/ -
eapol_testman page (tùy chọn-N): https://www.mankier.com/8/eapol_test
Tài liệu: HOATRANLABS Infrastructure — WiFi RADIUS trên nền tảng Windows (Full Windows)
Cập nhật: 2026-10-15