通知
Telegram、ntfy、Gotify、Discord、Webhook、またはシステム通知でアラートを受信します。
Dockermanは複数のチャンネルを通じて通知をプッシュできるため、デスクを離れている間に何かが発生したときに知ることができます。チャンネルは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のネイティブ通知 |
システム通知は常に利用可能でデフォルトで有効です。これらは「外部」チャンネルとしてカウントされません。
通知チャンネルの追加
チャンネルを追加
チャンネルを追加をクリックし、名前を付けてShoutrrr URLを貼り付けます。
チャンネルをテスト
テストをクリックしてテストメッセージを即座に送信します。メッセージが届けば、チャンネルの準備は完了です。
保存
チャンネルを保存します。これでアラートルールとイメージアップグレード監視で利用可能になります。
認証情報のセキュリティ
Shoutrrr URLの機密部分(トークンやパスワードなど)は、システムKeychain(macOS Keychain、Windows DPAPI、またはLinux Secret Service)に保存されます。データベースには、シークレットがプレースホルダーに置き換えられた編集済みバージョンのURLのみが保存されます。
Dockermanは認証情報を通知チャンネル自体以外のサーバーに送信することはありません。認証情報は送信時にKeychainから読み取られ、ログに記録されることはありません。
通知の使用場所
通知チャンネルは2つのシステムで使用されます:
アラートルール
各アラートルールは1つ以上のチャンネルにバインドされます。ルールが発火すると、バインドされたすべてのチャンネルにブロードキャストされます。
イメージアップグレード監視
イメージ監視はグローバルなデフォルトチャンネルリストを使用します。新しいイメージバージョンが見つかったとき、すべてのデフォルトチャンネルが通知を受信します。
チャンネルの管理
通知ページから以下ができます:
- チャンネルの名前またはURLを編集
- チャンネルを削除せずに無効化(無効化されたチャンネルは配信時にスキップされます)
- チャンネルを削除(参照していたアラートルールはそのチャンネルへの配信を停止します)
- いつでもチャンネルを再テスト
ヒント
- 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を受け入れる任意のサービスとの統合に使用してください。