本格的なHomeLabにUPS監視が必須である理由
UPS監視なしでProxmoxノード(またはクラスター)を運用するのは、電池切れの煙感知器を設置するようなものです。ハードウェアはそこにあっても、いざという時には役に立ちません。私自身、一瞬の電力変動でNASが書き込み中にダウンし、ZFSデータセットが破損して半日かけて復旧した苦い経験があります。
断言できます。UPS監視を適切に設定できるかどうかは、本格的なHomeLabと死を待つ高価なハードウェアの山を分ける技術の一つです。問題はUPSを監視するかどうかではなく、どのように監視するかです。その答えは、あなたの環境次第です。
UPS監視の3つのアプローチ
HomeLab環境には、それぞれ異なる考え方に基づいた3つの現実的な選択肢があります。
選択肢1:ベンダーソフトウェア(APC PowerChute、Eaton IPP、CyberPower Panel)
コンシューマー向けUPSのほとんどは、ベンダー固有の監視ソフトウェアと一緒に出荷されます。APCにはPowerChute、EatonにはIntelligent Power Protector、CyberPowerにはPowerPanelがあります。これらのツールはUSBまたはシリアル経由で接続し、バッテリー状態を監視してシャットダウンをトリガーします。
Windowsデスクトップでは問題なく動作します。しかしLinuxサーバーやProxmox上では話が複雑になります。PowerChute Business EditionはライセンスとJavaデーモンを必要とし、Linuxサポートの不安定さは悪名高いです。
CyberPowerのPowerPanel for Linuxは何年も実質的なアップデートがありません。さらに重大な問題として、これらのツールのどれもマルチマシンのシャットダウンを調整できません。3ノードのProxmoxクラスターにNASを加えた構成では、ベンダーソフトウェアは特定の順序でシャットダウンしてくれない上、UPSに物理的に接続されていないマシンはまったくシャットダウンされません。
選択肢2:apcupsd(シングルマシンUSB直結)
apcupsdはUSB経由でAPC UPS(および一部の互換ブランド)と直接通信する成熟したデーモンです。NUTよりシンプルで設定が簡単で、シングルマシンのシャットダウンを綺麗に処理します。設定は1つのファイルにまとまっており、シャットダウンスクリプトも分かりやすいです。
制限は複数のマシンがある瞬間から現れます。apcupsdにはネットワークコンポーネントが含まれていますが、アクセス制御は最小限で、ステータスレポートも限られており、クライアント/サーバーモデルは設計に組み込まれたというよりは後付けです。単一のProxmoxノードだけであればapcupsdで十分です。しかし2台目のマシンを追加するとNUTの方が優れたツールになります。
選択肢3:Network UPS Tools(NUT)サーバー/クライアントモード
NUTは問題を明確なレイヤーに分離します:ハードウェアと通信するドライバー、ネットワーク上でUPS状態を公開するサーバー(upsd)、そしてサブスクライブしてシャットダウンをトリガーするクライアント(upsmon)です。1台のマシンがUSB接続を所有します。ネットワーク上の他のすべてのマシンは、物理的なハードウェアアクセスなしにリアルタイムのUPSデータを取得できます。
このアーキテクチャは最初からマルチマシン環境向けに設計されています。その証拠が機能セットに表れています:170以上のUPSモデルのサポート、ACLベースのアクセス制御、そしてProxmoxネイティブ統合。NUTはまた積極的にメンテナンスされており、これはほとんどのベンダー代替品には言えないことです。
メリット・デメリットの比較
ベンダーソフトウェア
- メリット:対応ハードウェアですぐに動作する、WindowsではGUIが利用可能
- デメリット:Linuxサポートにばらつきがある、Javaが必要なケースが多い、マルチノード調整不可、ベンダーロックイン
apcupsd
- メリット:シンプルな設定、APCハードウェアとの優れた互換性、低オーバーヘッド
- デメリット:ほぼAPC専用、マルチマシン対応が弱い、ネットワークプロトコルが基本的
NUT
- メリット:主要ベンダー全体で170以上のUPSモデルをサポート、マルチマシン調整が内蔵、ACLアクセス制御、Proxmoxネイティブサポート、積極的にメンテナンスされている
- デメリット:管理する設定ファイルが多い、サーバー/クライアントモデルの学習コストがやや高い、GUIが内蔵されていない
推奨構成:ProxmoxにNUTサーバー、各マシンにクライアント
一般的なHomeLabの場合、アーキテクチャは次のようになります:
- NUTサーバー:USB経由でUPSに物理的に接続されたProxmoxノード。
upsdとUPSドライバーを実行します。 - NUTクライアント:その他のすべてのマシン(追加のProxmoxノード、TrueNAS、管理対象のVMホストなど)。それぞれがクライアントモードで
upsmonを実行し、サーバーをポーリングします。 - シャットダウン順序:クライアントが先にシャットダウンし、サーバーが最後。サーバーはUSB接続を保持しており、すべてがシャットダウンした後でUPSの電源オフコマンドを発行する必要があります。
シングルノード構成ですか?同じマシンでサーバーとクライアントの両方を実行します。原則は同じで、よりシンプルなだけです。
実装ガイド
ステップ1:ProxmoxホストにNUTをインストールする
ProxmoxノードにSSH接続し、NUTパッケージ一式をインストールします:
apt update
apt install nut nut-client nut-server -y
ステップ2:UPSハードウェアを検出する
USB経由でUPSを接続し、自動検出スキャンを実行します:
nut-scanner -U
次のような設定ブロックが出力されます:
[nutdev1]
driver = "usbhid-ups"
port = "auto"
vendorid = "0764"
productid = "0501"
product = "CP1500"
serial = "XXXXXXXXXXXXX"
bus = "001"
そのブロックを/etc/nut/ups.confにコピーし、nutdev1をわかりやすい名前に変更します:
nano /etc/nut/ups.conf
[homelab-ups]
driver = usbhid-ups
port = auto
desc = "CyberPower CP1500 HomeLab"
vendorid = 0764
productid = 0501
ステップ3:NUTサーバーモードを設定する
動作モードを設定します。マルチマシン構成にはnetserver、シングルノードにはstandaloneを使用します:
nano /etc/nut/nut.conf
MODE=netserver
upsdがネットワークからの接続を受け入れるように設定します:
nano /etc/nut/upsd.conf
LISTEN 0.0.0.0 3493
クライアント認証用のユーザーアカウントを作成します:
nano /etc/nut/upsd.users
[upsmon_local]
password = strongpassword1
upsmon master
[upsmon_remote]
password = strongpassword2
upsmon slave
ステップ4:サーバーノードでupsmonを設定する
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
ステップ5:NUTサービスを起動・有効化する
systemctl enable nut-server nut-monitor
systemctl start nut-server nut-monitor
# ドライバーがロードされ、UPSが通信しているか確認する
upsc homelab-ups@localhost
成功すると、バッテリー残量、負荷率、入力電圧、ステータスが表示されます。ups.statusフィールドに注目してください:OLはオンライン(商用電源あり)、OBはバッテリー駆動中、LBはバッテリー残量低下を意味します(シャットダウンが間近です)。
ステップ6:クライアントノードを設定する
追加のマシン(他のProxmoxノード、TrueNASなど)それぞれに、クライアントパッケージのみをインストールします:
apt install nut-client -y
モードをnetclientに設定します:
nano /etc/nut/nut.conf
MODE=netclient
NUTサーバーのIPアドレスを指定して監視を設定します:
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
ステップ7:シャットダウンシーケンスをテストする
このステップを省略しないでください。本番環境で信頼する前に、停電をシミュレートします。NUTにはそのための内蔵メカニズムがあります:
# NUTサーバーで実行する
upsmon -c fsd
これは接続されているすべてのクライアントに強制シャットダウン信号を送ります。クライアントノードは5〜10秒以内にシャットダウンを開始するはずです。サーバーノードが最後に続きます。POWERDOWNFLAGが設定されている場合、NUTはすべてがオフになった後にUPSコンセントへの電力供給を遮断しようとします。これにより、商用電源が復旧した際にバッテリーが残っている状態でマシンが再起動するのを防ぎます。
動作が期待通りでない場合は、ログを確認してください:
journalctl -u nut-server -f
journalctl -u nut-monitor -f
実際に重要な細かい点
HOSTSYNCは見落としやすいですが、設定を誤ると高くつきます。これはサーバーが自ら処理を進める前に、スレーブノードがシャットダウンコマンドを確認するまで待つ時間を制御します。低すぎる値に設定すると、サーバーの電源が切れる際にクライアントがまだディスク書き込みをフラッシュしている可能性があります。30秒が適切なデフォルト値です。I/Oが多いVMを実行している場合は60秒に増やしてください。
Proxmoxはホストがシャットダウンする際に自動的にVMにACPIシャットダウン信号を送ります。それでも時間がかかります。特にWindowsゲストは正常なシャットダウンを開始するだけで20〜30秒かかる場合があります。LinuxのVMだけでなく、この時間もHOSTSYNCのウィンドウに考慮してください。
ファイアウォール側では:NUTはポート3493/tcpでリッスンします。クライアントノードの特定のIPアドレスのみに制限してください。サブネット全体に公開する理由はありません。
これが正常に動作するようになれば、理論上の計画ではなく、実際の障害条件下で機能するインフラ、つまり本当に停電が起きた時に動作するものを構築したことになります。

