# 自宅で何かが起きたとき を把握。

> ホームラボのアラートをスマホにプッシュ通知。Uptime Kuma や Home Assistant、bash スクリプトから curl 1 本で Pocket Alert に連携できます。ポート開放は不要で、個人利用なら無料です。

<!-- source: https://pocketalert.app/ja/use-cases/homelab-alerts -->

最終更新日:2026-08-11

Home Assistant、Uptime Kuma、その他のセルフホストのマシンから、ポートを一切開放せずにスマホへプッシュ通知を送れます。どこからでもホームラボを見守れます。無料プランで個人のラボを運用できます。

## ホームラボのアラート設定は 3 ステップ

1. **URL または CLI を取得** — アプリケーションの Webhook URL をコピーするか、お使いのマシンに Pocket Alert CLI をインストールしてください。
2. **マシンに連携** — スクリプトに curl を繋げたり、Kuma や Home Assistant から Webhook を転送したり、systemd の OnFailure を使ったりします。
3. **どこからでも監視** — イベントを発生させるとスマホが振動します。NAT の内側からでも、ポートを開放せずに通知を受け取れます。

## ホームラボのための監視

セルフホストでも、しっかり状態を把握したいものです。ホームラボをスマホに接続して、クラウド監視の料金を削減しましょう。

- **お使いの環境にそのまま対応** — Uptime Kuma、Home Assistant、Proxmox、Pi-hole、*arr 系アプリから Webhook を転送したり、curl を繋げたりできます。
- **ポートの開放は不要** — アウトバウンドの HTTPS のみを使用します。パブリック IP は不要で、NAT や VPN の内側からでも問題なく動作します。
- **マシンごとのチャンネル** — マシンごとにアプリを 1 つ作成すれば、NAS、Proxmox、Pi-hole のアラートをそれぞれ専用のチャンネルで受け取れます。
- **どこからでもスクリプトで送信** — bash、systemd ユニット、Docker のヘルスチェック、cron ジョブのどこからでも呼び出せます。
- **趣味で使える無料プラン** — 無料プランで個人のホームラボを運用できます。席数に応じた料金はかかりません。
- **1 秒未満で配信** — 配信は 1 秒未満で完了するため、自宅で起きた問題はどこにいても即座に届きます。

## ホームラボを接続

### 1. bash または cron スクリプトから（CLI）

```
pocketalert auth YOUR_API_KEY
pocketalert send -t "NAS · disk degraded" -m "pool tank · drive 2 FAULTED"
```

CLI を使わず、任意のスクリプトからメッセージ API を直接 curl で呼び出すこともできます:

```
curl -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Proxmox backup failed","message":"vzdump job on pve1 exited 1","level":"high"}'
```

### 2. Home Assistant から

```
rest_command:
  pocketalert:
    url: "https://api.pocketalert.app/v1/messages"
    method: POST
    headers:
      Token: "YOUR_API_KEY"
    content_type: "application/json"
    payload: '{"title":"{{ title }}","message":"{{ message }}"}'
```

### 3. Uptime Kuma から（Webhook）

[Webhook](https://pocketalert.app/ja/webhooks) ページで Webhook を作成し、受信 URL をコピーします（例: `https://p4a.me/wh/1234abcd`）。Uptime Kuma で、その URL を指定した **webhook** 通知を追加し、`%monitor.name% is %heartbeat.status%` のような GJSON テンプレートで Kuma のペイロードをマッピングします。

すべてアウトバウンドの HTTPS で通信するため、ポート転送は一切不要です。詳しくは [ドキュメント](https://info.pocketalert.app/getting-started.html) をご覧ください。

## よくある質問

### ホームラボからアラートを送るにはどうすればよいですか？

HTTP リクエストを送れるセルフホストのマシンなら、どれでも通知できます。スクリプトに curl を繋げたり、Uptime Kuma や Home Assistant から Webhook を転送したり、systemd ユニットから CLI を呼び出したりできます。サーバーがどこで動いていても、通知はスマホに届きます。

### セルフホストのアプリでも使えますか？

はい。Pocket Alert は Uptime Kuma、Home Assistant、Proxmox のフック、Pi-hole、*arr 系アプリ、シンプルな bash スクリプトと連携できます。JSON を POST できるものであれば動作します。

### サーバーを外部公開する必要はありますか？

パブリック IP もポート転送も不要です。サーバーから Pocket Alert へアウトバウンドの HTTPS リクエストを送る仕組みなので、NAT の内側、家庭用ルーターの背後、VPN 経由でも動作します。

### 複数のマシンを分けて通知できますか？

マシンやサービスごとにアプリケーションを 1 つずつ作成してください。NAS、Proxmox、Pi-hole のアラートはそれぞれ別のチャンネルに届くため、見分けやすくなります。

### 趣味で使える無料のプランはありますか？

はい。無料プランで個人のホームラボを十分に運用できます。席数に応じた料金はなく、NAS の不調を知るためだけにエンタープライズ向けの監視契約を結ぶ必要もありません。

### 夜間でもおやすみモードを突破してアラートを届けられますか？

はい。level を critical にして送信すると、Android では専用の通知チャンネルに投稿されます。このチャンネルはおやすみモードを貫通し、全画面で表示することもできます（おやすみモードへのアクセスを一度許可する必要があります）。iPhone では high と critical が「時間に敏感な通知」として届き、集中モードを突破します。ミュートスイッチを無視する完全なクリティカルサウンドは、Apple による権限付与に合わせて順次提供されています。無料プランでは critical は high として配信されます。即時に届きますが、おやすみモードの突破はできません。
