ntfy 如何配合 Watchtower 与 Shoutrrr 推送 Docker 镜像更新通知

ntfy 如何配合 Watchtower 与 Shoutrrr 推送 Docker 镜像更新通知【免费下载链接】ntfySend push notifications to your phone or desktop using PUT/POST项目地址: https://gitcode.com/GitHub_Trending/nt/ntfy你在服务器上跑着一组 Docker 容器用 Watchtower 定期检查并更新容器镜像但更新动作发生在你看不见的地方——你想让每次镜像更新都推送到手机或桌面。ntfy 官方文档给出了一条现成的集成路径Watchtower 的出站通知由 shoutrrr 通知库完成而 shoutrrr 内置了 ntfy 支持把 Watchtower 的WATCHTOWER_NOTIFICATION_URL配置成一个 ntfy 主题 URL 即可。本文的操作内容来自 docs/examples.md 的 “Watchtower (shoutrrr)” 一节两个工具的集成关系在 docs/integrations.md 中列有索引Watchtower 用于自动化 Docker 容器基础镜像更新Shoutrrr 是通知库。准备确定 ntfy 主题与 URL 格式在改配置之前先确定两件事主题名示例文档统一使用my_watchtower_topic你需要换成自己创建的主题名。域名示例使用公共服务ntfy.sh如果你自建了 ntfy 服务器则换成自己的服务器域名。如果主题开启了访问控制不支持匿名写入docs/publish.md 说明了发布方需要携带认证信息而 Watchtower 一节给出了两种可直接用于 shoutrrr 的 URL 格式文档要求把其中的域名、主题和 token 替换为你自己的值文档推荐Ntfy url 格式ntfy://:TOKENDOMAIN/TOPIC通用 webhook 加授权头的格式generichttps://DOMAIN/TOPIC?authorizationBearerTOKENTOKEN是你自己的 ntfy access token例如在 web app 的 Account 部分创建DOMAIN是 ntfy 服务器域名TOPIC是主题名。配置 Watchtower 的 docker-composedocs/examples.md 给出的示例docker-compose.yml如下services: watchtower: image: containrrr/watchtower environment: - WATCHTOWER_NOTIFICATION_SKIP_TITLETrue - WATCHTOWER_NOTIFICATION_URLntfy://ntfy.sh/my_watchtower_topic?titleWatchtowerUpdates其中WATCHTOWER_NOTIFICATION_URL是 ntfy 主题 URLURL 里的titleWatchtowerUpdates会作为推送通知的标题my_watchtower_topic换成你自己的主题。WATCHTOWER_NOTIFICATION_SKIP_TITLETrue这一行不是可选项。文档明确说明该环境变量是必需的用于阻止 Watchtower 替换掉 URL 中的title查询参数如果省略你在 URL 里提供的通知标题将不会被使用。如果你的主题需要认证则按上一节的格式把 URL 写成ntfy://:TOKENDOMAIN/TOPIC的形式再填入。可选分支单独用 shoutrrr 发测试消息如果你只想先验证 shoutrrr 到 ntfy 这条链路而不等 Watchtower 真正触发更新文档提供了直接发送一条测试消息的命令shoutrrr send -u ntfy://ntfy.sh/my_watchtower_topic?titleWatchtowerUpdates -m testMessage执行后主题上应收到一条正文为testMessage、标题为WatchtowerUpdates的消息。需要认证的主题同样改用带 token 的 URL 格式。验证通知是否到达确认消息进入主题的两种方式都在 ntfy 文档中有对应说明看订阅端在 ntfy 手机 app 或 web 界面订阅该主题等测试消息或 Watchtower 的更新通知弹出。用 API 拉取按 docs/subscribe/api.md 的 JSON 流接口执行my_watchtower_topic换成你的主题curl -s ntfy.sh/my_watchtower_topic/json连接会保持打开并逐行输出 JSON 事件。文档示例输出如下文档示例仅作格式参考{id:SLiKI64DOt,time:1635528757,event:open,topic:mytopic} {id:hwQ2YpKdmg,time:1635528741,event:message,topic:mytopic,message:Disk full} {id:DGUDShMCsc,time:1635528787,event:keepalive,topic:mytopic}当event为message的行出现、message字段是 Watchtower 发出的更新内容时说明整条链路已经打通。也可以用curl -s ntfy.sh/my_watchtower_topic/json?poll1只读取已缓存的消息后关闭连接方便做一次性检查。已知限制如前所述漏掉WATCHTOWER_NOTIFICATION_SKIP_TITLETrue时URL 中配置的title不生效这是该集成最容易踩的坑。docs/examples.md 开头的说明指出许多示例由社区贡献维护者不能保证所有示例都可运行如果按上述配置后主题收不到消息先按“可选分支”一节用 shoutrrr 单独发一条测试消息把问题定位在 Watchtower 配置还是 shoutrrr 到 ntfy 的链路上。自建 ntfy 服务器且主题需要认证时TOKEN必须有效否则消息无法写入token 的创建方式见 docs/publish.md 的 access tokens 部分。【免费下载链接】ntfySend push notifications to your phone or desktop using PUT/POST项目地址: https://gitcode.com/GitHub_Trending/nt/ntfy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考