Network UPS Tools (NUT) trên Proxmox HomeLab: Tự Động Tắt Máy An Toàn Khi Mất Điện

HomeLab tutorial - IT technology blog
HomeLab tutorial - IT technology blog

Tại Sao Giám Sát UPS Là Bắt Buộc Với HomeLab Nghiêm Túc

Chạy một node Proxmox — hay cả một cluster — mà không có giám sát UPS chẳng khác nào đầu báo khói nhưng hết pin. Thiết bị vẫn đó, nhưng sẽ không cứu được bạn khi cần thiết. Tôi đã từng học bài học này theo cách khó nhất khi một cú chập điện ngắn làm sập NAS đúng lúc đang ghi dữ liệu, làm hỏng một ZFS dataset mất nửa ngày trời mới khôi phục được.

Tin tôi đi — làm đúng việc giám sát UPS là một trong những kỹ năng phân biệt một HomeLab nghiêm túc với đống phần cứng đắt tiền đang chờ ngày chết. Câu hỏi không phải là có nên giám sát UPS hay không. Mà là giám sát bằng cách nào. Và câu trả lời phụ thuộc hoàn toàn vào setup của bạn.

Ba Phương Án Giám Sát UPS

Môi trường HomeLab có ba lựa chọn thực tế, mỗi cái xây dựng trên một triết lý khác nhau.

Phương Án 1: Phần Mềm Hãng (APC PowerChute, Eaton IPP, CyberPower Panel)

Hầu hết UPS consumer đều đi kèm phần mềm giám sát riêng của hãng. APC có PowerChute, Eaton có Intelligent Power Protector, CyberPower có PowerPanel. Các công cụ này kết nối qua USB hoặc cổng serial, theo dõi trạng thái pin và kích hoạt tắt máy.

Trên máy tính Windows thì dùng được. Nhưng trên máy chủ Linux và Proxmox, câu chuyện phức tạp hơn nhiều. PowerChute Business Edition yêu cầu bản quyền và chạy một Java daemon với khả năng hỗ trợ Linux nổi tiếng là lộn xộn.

PowerPanel cho Linux của CyberPower đã không được cập nhật đáng kể trong nhiều năm. Quan trọng hơn: không phần mềm nào trong số này có thể phối hợp tắt nhiều máy cùng lúc. Với một cluster Proxmox ba node cộng thêm một NAS, phần mềm hãng sẽ không tắt chúng theo thứ tự cụ thể nào — hoặc thậm chí không tắt gì cả, với những máy không kết nối vật lý với UPS.

Phương Án 2: apcupsd (USB Trực Tiếp Một Máy)

apcupsd là một daemon trưởng thành giao tiếp trực tiếp với UPS của APC (và một số thương hiệu tương thích) qua USB. Nó đơn giản hơn NUT, dễ cấu hình và xử lý tắt máy đơn lẻ gọn gàng. Toàn bộ cấu hình nằm trong một file và script tắt máy rất dễ hiểu.

Hạn chế lộ ra ngay khi bạn có nhiều hơn một máy. apcupsd có thành phần mạng, nhưng kiểm soát truy cập rất sơ sài, báo cáo trạng thái hạn chế, và mô hình client/server được gắn vào sau chứ không được thiết kế từ đầu. Với một node Proxmox đơn và không có gì khác, apcupsd đủ dùng. Thêm máy thứ hai vào và NUT trở thành công cụ tốt hơn.

Phương Án 3: Network UPS Tools (NUT) Theo Chế Độ Server/Client

NUT tách bài toán thành các lớp riêng biệt: một driver giao tiếp với phần cứng, một server (upsd) phơi trạng thái UPS qua mạng, và các client (upsmon) đăng ký nhận dữ liệu và kích hoạt tắt máy. Một máy giữ kết nối USB. Mọi máy khác trong mạng đều nhận dữ liệu UPS theo thời gian thực mà không cần truy cập phần cứng vật lý.

Kiến trúc đó được thiết kế từ ngày đầu cho môi trường nhiều máy. Điều này thể hiện rõ trong tập tính năng: hỗ trợ 170+ mẫu UPS, kiểm soát truy cập theo ACL và tích hợp native với Proxmox. NUT cũng được duy trì tích cực — điều không thể nói với hầu hết phần mềm hãng.

So Sánh Ưu Nhược Điểm

Phần Mềm Hãng

  • Ưu điểm: Dùng được ngay với phần cứng được hỗ trợ, có GUI trên Windows
  • Nhược điểm: Hỗ trợ Linux rất lộn xộn, thường cần Java, không phối hợp được nhiều node, bị khóa vào hãng

apcupsd

  • Ưu điểm: Cấu hình đơn giản, tương thích tốt với phần cứng APC, overhead thấp
  • Nhược điểm: Chủ yếu chỉ dùng được với APC, hỗ trợ nhiều máy yếu, giao thức mạng cơ bản

NUT

  • Ưu điểm: Hỗ trợ 170+ mẫu UPS của tất cả hãng lớn, phối hợp nhiều máy tích hợp sẵn, kiểm soát truy cập ACL, hỗ trợ native Proxmox, được duy trì tích cực
  • Nhược điểm: Nhiều file cấu hình hơn cần quản lý, học mô hình server/client hơi dốc hơn một chút, không có GUI tích hợp sẵn

Setup Khuyến Nghị: NUT Server Trên Proxmox, Client Trên Mọi Máy

Với HomeLab thông thường, kiến trúc trông như sau:

  • NUT Server: Node Proxmox kết nối vật lý với UPS qua USB. Chạy upsd và driver UPS.
  • NUT Client: Mọi máy còn lại — các node Proxmox khác, TrueNAS, bất kỳ VM host nào bạn quan tâm. Mỗi máy chạy upsmon ở chế độ client, polling lên server.
  • Thứ tự tắt máy: Client tắt trước, server tắt sau. Server giữ kết nối USB và cần phát lệnh tắt nguồn UPS sau khi mọi thứ đã xong.

Chỉ có một node duy nhất? Chạy cả server lẫn client trên cùng một máy. Nguyên tắc tương tự, chỉ đơn giản hơn.

Hướng Dẫn Triển Khai

Bước 1: Cài Đặt NUT Trên Proxmox Host

SSH vào node Proxmox và cài đặt bộ package NUT đầy đủ:

apt update
apt install nut nut-client nut-server -y

Bước 2: Dò Tìm Phần Cứng UPS

Kết nối UPS qua USB, sau đó chạy lệnh quét tự động:

nut-scanner -U

Bạn sẽ nhận được một block cấu hình như thế này:

[nutdev1]
    driver = "usbhid-ups"
    port = "auto"
    vendorid = "0764"
    productid = "0501"
    product = "CP1500"
    serial = "XXXXXXXXXXXXX"
    bus = "001"

Sao chép block đó vào /etc/nut/ups.conf và đổi tên nutdev1 thành tên có nghĩa hơn:

nano /etc/nut/ups.conf
[homelab-ups]
    driver = usbhid-ups
    port = auto
    desc = "CyberPower CP1500 HomeLab"
    vendorid = 0764
    productid = 0501

Bước 3: Cấu Hình Chế Độ NUT Server

Đặt chế độ hoạt động — netserver cho setup nhiều máy, standalone cho setup một node:

nano /etc/nut/nut.conf
MODE=netserver

Cho phép upsd nhận kết nối từ mạng:

nano /etc/nut/upsd.conf
LISTEN 0.0.0.0 3493

Tạo tài khoản người dùng để client xác thực:

nano /etc/nut/upsd.users
[upsmon_local]
    password = strongpassword1
    upsmon master

[upsmon_remote]
    password = strongpassword2
    upsmon slave

Bước 4: Cấu Hình upsmon Trên Node Server

nano /etc/nut/upsmon.conf
MONITOR homelab-ups@localhost 1 upsmon_local strongpassword1 master
MINSUPPLIES 1
SHUTDOWNCMD "/sbin/shutdown -h +0"
POWERDOWNFLAG /etc/killpower
POLLFREQ 5
POLLFREQALERT 5
HOSTSYNC 30
DEADTIME 15

Bước 5: Khởi Động và Kích Hoạt Dịch Vụ NUT

systemctl enable nut-server nut-monitor
systemctl start nut-server nut-monitor

# Kiểm tra driver đã load và UPS đang phản hồi
upsc homelab-ups@localhost

Phản hồi thành công sẽ hiển thị mức pin, phần trăm tải, điện áp đầu vào và trạng thái. Chú ý trường ups.status: OL nghĩa là đang dùng điện lưới (On Line), OB nghĩa là đang chạy bằng pin (On Battery), và LB nghĩa là pin yếu (Low Battery) — sắp tắt máy rồi đó.

Bước 6: Cấu Hình Các Node Client

Trên mỗi máy bổ sung (các node Proxmox khác, TrueNAS, v.v.), chỉ cài package client:

apt install nut-client -y

Đặt chế độ thành netclient:

nano /etc/nut/nut.conf
MODE=netclient

Cấu hình giám sát, trỏ về địa chỉ IP của NUT server:

nano /etc/nut/upsmon.conf
MONITOR [email protected] 1 upsmon_remote strongpassword2 slave
MINSUPPLIES 1
SHUTDOWNCMD "/sbin/shutdown -h +0"
POLLFREQ 5
POLLFREQALERT 5
HOSTSYNC 30
DEADTIME 15
systemctl enable nut-monitor
systemctl start nut-monitor

Bước 7: Kiểm Tra Trình Tự Tắt Máy

Đừng bỏ qua bước này. Trước khi tin tưởng đưa vào production, hãy mô phỏng một lần mất điện. NUT có cơ chế tích hợp sẵn chính xác cho việc đó:

# Chạy trên NUT server
upsmon -c fsd

Lệnh này gửi tín hiệu Forced Shutdown đến tất cả client đang kết nối. Các node client sẽ bắt đầu tắt trong vòng 5–10 giây. Node server tắt sau cùng. Nếu POWERDOWNFLAG được cấu hình, NUT sẽ cố cắt nguồn ổ cắm UPS sau khi mọi thứ đã tắt — điều này ngăn các máy khởi động lại trên pin còn sót khi điện lưới trở lại.

Nếu hành vi không như mong đợi, kiểm tra log:

journalctl -u nut-server -f
journalctl -u nut-monitor -f

Một Vài Chi Tiết Thực Sự Quan Trọng

HOSTSYNC dễ bị bỏ qua nhưng cài sai thì đắt giá. Nó kiểm soát thời gian server chờ các node slave xác nhận lệnh tắt máy trước khi tự tiến hành. Đặt quá thấp và các client có thể vẫn đang xả buffer ghi disk khi server tắt nguồn. 30 giây là mặc định ổn; tăng lên 60 nếu bạn đang chạy VM với I/O nặng.

Proxmox tự động truyền tín hiệu tắt máy ACPI đến các VM khi host tắt. Việc đó vẫn mất thời gian — đặc biệt Windows guest có thể mất 20–30 giây chỉ để bắt đầu tắt một cách gọn gàng. Hãy tính điều đó vào khoảng thời gian HOSTSYNC, không chỉ tính cho Linux VM của bạn.

Về phía tường lửa: NUT lắng nghe trên cổng 3493/tcp. Hãy khóa chỉ cho phép đúng địa chỉ IP của các node client. Không có lý do gì để phơi nó ra cả subnet.

Khi mọi thứ đã chạy ổn định, bạn đã xây dựng được thứ gì đó thực sự đứng vững trước các sự cố thực — không phải kế hoạch lý thuyết, mà là hạ tầng thực sự hoạt động khi đèn tắt.

Share: