Wallos项目中集成ntfy.sh通知服务的配置指南

背景介绍

Wallos作为一款开源项目，近期在2.5.1版本中新增了对ntfy.sh通知服务的支持。ntfy.sh是一款流行的通知推送服务，支持自托管部署，在家庭实验室(homelab)场景中应用广泛。本文将详细介绍如何在Wallos中正确配置ntfy.sh通知服务。

配置要点

基础配置

1. 服务地址：填写完整的ntfy.sh服务URL，包括协议头(https://)
2. 主题设置：指定接收通知的topic名称

认证配置

对于需要认证的ntfy.sh实例，可通过以下两种方式配置：

方式一：URL内嵌认证

在服务URL中直接包含Base64编码的用户名密码：

https://username:[e-mail]

方式二：自定义Header

更推荐使用自定义Header方式，格式要求严格遵循JSON规范：

{"Authorization": "Bearer your-token-here"}

或基础认证：

{"Authorization": "Basic base64-encoded-credentials"}

常见问题解决

错误提示"字符串不匹配预期模式"

此错误通常由以下原因导致：

1. 自定义Header未使用正确的JSON格式（缺少花括号）
2. 认证信息格式不正确
3. 服务URL格式不规范

测试建议

1. 先使用无需认证的公开topic测试基本功能
2. 逐步添加认证配置
3. 检查Wallos版本是否为2.5.1或更新

技术细节

Wallos通过标准的HTTP POST请求与ntfy.sh服务交互，请求体采用JSON格式。自定义Header会原样附加到请求头中，因此必须确保格式完全符合HTTP规范。

最佳实践

1. 对于自托管实例，建议使用HTTPS协议
2. 敏感信息建议通过自定义Header传递而非URL
3. 定期检查通知是否正常送达，即使界面显示错误

通过以上配置，用户可以在Wallos中实现稳定可靠的ntfy.sh通知推送功能，满足各类监控和提醒需求。