Dockerman Docs
Homelab

通知

Telegram、ntfy、Gotify、Discord、Webhook、またはシステム通知でアラートを受信します。

Dockermanは複数のチャンネルを通じて通知をプッシュできるため、デスクを離れている間に何かが発生したときに知ることができます。チャンネルはShoutrrr互換URLスキームを使用します。これはWatchtower、Beszel、その他のHomelabツールで使用されているものと同じ形式です。

サポートされているチャンネル

チャンネルURL形式備考
Telegramtelegram://token@telegram?chats=chat_idBotFatherからのボットトークン
ntfyntfy://ntfy.sh/topic または ntfy://user:pass@ntfy.sh/topicセルフホストまたはntfy.sh
Gotifygotify://gotify.example.com/tokenセルフホストGotifyサーバー
Discorddiscord://token@idWebhook URLをShoutrrr形式に変換
Webhookgeneric://example.com/webhook任意のエンドポイントへの汎用JSON POST
システム通知組み込み、URL不要macOS、Windows、Linuxのネイティブ通知

システム通知は常に利用可能でデフォルトで有効です。これらは「外部」チャンネルとしてカウントされません。

通知チャンネルの追加

通知設定を開く

サイドバーからまたはSpotlight経由で通知ページに移動します。

チャンネルを追加

チャンネルを追加をクリックし、名前を付けてShoutrrr URLを貼り付けます。

チャンネルをテスト

テストをクリックしてテストメッセージを即座に送信します。メッセージが届けば、チャンネルの準備は完了です。

保存

チャンネルを保存します。これでアラートルールイメージアップグレード監視で利用可能になります。

認証情報のセキュリティ

Shoutrrr URLの機密部分(トークンやパスワードなど)は、システムKeychain(macOS Keychain、Windows DPAPI、またはLinux Secret Service)に保存されます。データベースには、シークレットがプレースホルダーに置き換えられた編集済みバージョンのURLのみが保存されます。

Dockermanは認証情報を通知チャンネル自体以外のサーバーに送信することはありません。認証情報は送信時にKeychainから読み取られ、ログに記録されることはありません。

通知の使用場所

通知チャンネルは2つのシステムで使用されます:

チャンネルの管理

通知ページから以下ができます:

  • チャンネルの名前またはURLを編集
  • チャンネルを削除せずに無効化(無効化されたチャンネルは配信時にスキップされます)
  • チャンネルを削除(参照していたアラートルールはそのチャンネルへの配信を停止します)
  • いつでもチャンネルを再テスト

ヒント

  • WatchtowerやBeszelで既にShoutrrr URLを使用している場合は、同じURLをDockermanに貼り付けることができます。
  • Discordの場合、webhook URL(https://discord.com/api/webhooks/ID/TOKEN)をShoutrrr形式に変換してください:discord://TOKEN@ID
  • 汎用webhookチャンネルはtitlebodyフィールドを含むJSON POSTを送信します。webhookを受け入れる任意のサービスとの統合に使用してください。