Homelab
通知
Telegram、ntfy、Gotify、Discord、Webhook、またはシステム通知でアラートを受信します。
デスクを離れているあいだに起きたことを知るために、複数チャンネルへ通知を送れます。チャンネルは Shoutrrr 互換 URL スキーム です。Watchtower、Beszel、その他の Homelab ツールと同じ形式です。
サポートされているチャンネル
| チャンネル | URL形式 | 備考 |
|---|---|---|
| Telegram | telegram://token@telegram?chats=chat_id | BotFatherからのボットトークン |
| ntfy | ntfy://ntfy.sh/topic または ntfy://user:pass@ntfy.sh/topic | セルフホストまたはntfy.sh |
| Gotify | gotify://gotify.example.com/token | セルフホストGotifyサーバー |
| Discord | discord://token@id | Webhook URLをShoutrrr形式に変換 |
| Webhook | generic://example.com/webhook | 任意のエンドポイントへの汎用JSON POST |
| システム通知 | 組み込み、URL不要 | macOS、Windows、Linuxのネイティブ通知 |
システム通知は常に使え、デフォルトで有効です。「外部」チャンネルには数えません。
現在のデスクトップ対応範囲
通知ページでは、設定済みチャンネルの一覧とテスト送信が使えます。現在のデスクトップ UI には、追加、編集、無効化、削除の一通りの操作はありません。内部アダプターは、欠けている UI の代わりにはなりません。
認証情報のセキュリティ
現在のデーモンは、通知チャンネルのシークレット一式を Dockerman のアプリデータ内 secrets/notification-channels.json へ保存します。Unix では現在のユーザーだけが読める権限にしますが、システム Keychain には入れません。
Dockerman のアプリデータを機密情報として扱ってください。汎用 webhook URL のパスやクエリに認証情報が含まれる場合があるため、ログや診断データを共有する前に確認してください。
通知の使用場所
通知チャンネルは次の 2 つで使われます。
アラートルール
各アラートルールは1つ以上のチャンネルにバインドされます。ルールが発火すると、バインドされたすべてのチャンネルにブロードキャストされます。
イメージアップグレード監視
イメージ監視はグローバルなデフォルトチャンネル一覧を使います。新しいイメージバージョンが見つかると、すべてのデフォルトチャンネルが通知を受けます。
ヒント
- Watchtower や Beszel ですでに Shoutrrr URL を使っているなら、同じ URL を Dockerman に貼り付けてください。
- Discordの場合、webhook URL(
https://discord.com/api/webhooks/ID/TOKEN)をShoutrrr形式に変換してください:discord://TOKEN@ID。 - 汎用 webhook チャンネルは
titleとbodyフィールドを含む JSON POST を送ります。webhook を受け付ける任意のサービスにつないでください。