通知
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のネイティブ通知 |
システム通知は常に使え、デフォルトで有効です。「外部」チャンネルには数えません。
チャンネルの管理
設定 > 通知 で チャンネルを追加 をクリックすると、名前とチャンネル URL を入力します。Dockerman はチャンネルを追加するときに URL を確認し、シークレット部分を隠して一覧に表示します。各外部チャンネルは、テスト通知の送信や削除ができます。チャンネルを削除すると、保存された認証情報も削除されます。チャンネルの編集や無効化は、デスクトップ 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 を受け付ける任意のサービスにつないでください。