jioyzen/nightscout-alert repository overview

⁠Nightscout Alert Service

一个血糖监控与告警微信推送工具。基于 Nightscout 血糖监控与告警服务，通过 API 实时获取血糖数据，并根据自定义阈值将告警信息推送到微信（PushPlus），支持PushPlus微信群发。

⁠✨ 项目特点

• 🧠 独立运行
  不依赖Nightscout内置插件，单独轮询API，稳定可靠。

• ⚡ 高频监控
  支持秒级血糖数据获取，实时性强。

• 🚨 智能告警机制

  • 高血糖 / 低血糖预警
  • 血糖快速波动（Delta）预警

• 🐳 多平台 Docker 支持
  支持以下架构自动拉取对应镜像：

  • linux/amd64
  • linux/arm64（树莓派 / ARM NAS）
  • linux/arm/v7

• 🪶 轻量高效
  基于精简Python镜像构建，占用资源极低，适合长期后台运行。

⁠📦 Docker 安装与运行

⁠快速启动（推荐）

docker run -d \
  --name nightscout-alert \
  --restart always \
  -p 8080:8080 \
  -v $(pwd)/config:/app/config \
  -v $(pwd)/logs:/app/logs \
  -e TZ=Asia/Shanghai \
  jioyzen/nightscout-alert:latest

⁠⚙️ 配置说明

容器启动后，通过webui配置服务参数和血糖参数后，即可自动运行。容器默认端口8080，请自行映射为不冲突端口。

⁠🔔 告警类型

• 高血糖告警 血糖持续高于设定阈值时触发。

• 低血糖告警 血糖低于安全阈值时立即推送。

• 血糖快速波动告警（Delta） 单位时间内血糖变化速率超过阈值时触发。

⁠🛠️ 故障排查

• 无法获取 Nightscout 数据

  • 检查网络是否能访问 Nightscout
  • 确认 NIGHTSCOUT_URL 包含 http:// 或 https://

• 未收到微信推送

  • 确认 PUSHPLUS_TOKEN 是否有效
  • 查看 logs 目录中的运行日志

⁠🧩 适用场景

• 家庭 Nightscout 血糖监控 ，希望将报警数据推送到微信。
• NAS / 树莓派 7×24 小时后台运行
• 对告警稳定性和灵活性要求较高的用户

⁠📄 License

MIT License

⁠❤️ 致谢

• Nightscout 社区
• PushPlus 微信推送服务