通知定时发送系统

基于 ANotify 库的通知定时发送系统，支持多种通知渠道的定时和重复发送。提供完整的 Web 管理界面和 RESTful API。

• 主界面

• 日历视图

• 日历导出(订阅)

• 日历导入(同步)

功能特性

• ✅ 多渠道支持: 企业微信、飞书、钉钉、PushPlus、Server酱、Gotify、Ntfy、IYUU、巴法云 等第三方推送支持
• ⏰ 定时发送: 指定时间自动发送通知
• 🔁 重复任务: 支持使用 Cron 表达式创建重复任务
• 🌐 Web 界面: 美观的前端界面，支持任务的创建、查看、取消
• 🗄️ 任务管理: 完整的 CRUD 操作
• 📊 状态跟踪: 任务状态实时跟踪（待发送、已发送、失败、已取消）
• 🔌 RESTful API: 提供完整的 HTTP API 接口
• 🐳 容器化部署: 支持 Docker 和 Docker Compose 部署
• 🚀 生产就绪: 提供 Nginx、Systemd、Gunicorn 等生产环境配置

系统架构

┌─────────────────┐
│   Web 前端界面   │  ← 用户交互界面
└────────┬────────┘
         │
┌────────▼────────┐
│   Flask Web API │  ← 提供 RESTful 接口
└────────┬────────┘
         │
┌────────▼────────┐
│   APScheduler   │  ← 定时任务调度
└────────┬────────┘
         │
┌────────▼────────┐
│  Notification   │  ← 封装 ANotify 发送逻辑
│     Sender      │
└────────┬────────┘
         │
┌────────▼────────┐
│     ANotify     │  ← 多渠道通知发送
└─────────────────┘

快速开始

方式一：使用 Docker

# 1. 构建并启动容器
docker-compose up -d

# 2. 查看日志
docker-compose logs -f

# 3. 停止服务
docker-compose down

方式三：使用启动脚本

# 1. 克隆或下载项目到服务器
cd /path/to/notify-scheduler

# 2. 运行启动脚本（开发模式）
./start.sh

# 或者使用生产模式（Gunicorn）
./start.sh prod

Web 界面使用说明

访问 http://your-server:5000 打开 Web 管理界面。

📂 项目文件说明

核心代码文件

文件	说明	重要程度
app.py	Flask Web 应用主程序，提供 API 和前端服务	⭐⭐⭐⭐⭐
models.py	数据库模型定义，任务数据结构	⭐⭐⭐⭐⭐
scheduler.py	任务调度器，负责定时执行任务	⭐⭐⭐⭐⭐
notifier.py	通知发送器，封装各渠道发送逻辑	⭐⭐⭐⭐⭐
static/index.html	Web 前端界面	⭐⭐⭐⭐⭐

配置文件

文件	说明	用途
requirements.txt	Python 依赖包列表	安装依赖
gunicorn_config.py	Gunicorn 服务器配置	生产部署
nginx.conf	Nginx 反向代理配置示例	生产部署
docker-compose.yml	Docker Compose 配置	Docker 部署
Dockerfile	Docker 镜像配置	Docker 部署
notify-scheduler.service	Systemd 服务配置	Linux 系统服务

脚本文件

文件	说明	使用场景
start.sh	一键启动脚本	快速启动服务
stop.sh	停止服务脚本	停止运行中的服务

示例和文档

文件	说明	目标读者
README.md	完整项目文档	所有用户
DEPLOY.md	快速部署指南	运维人员
example_usage.py	API 使用示例	开发人员
test_system.py	系统测试脚本	测试人员
config_examples.json	各渠道配置示例	配置人员

创建通知任务

1. 在左侧表单中填写通知信息：
   • 通知标题: 任务标题
   • 通知内容: 通知正文，支持 Markdown 格式
   • 通知渠道: 选择发送渠道（企业微信、飞书等）
   • 渠道配置: 根据选择的渠道填写相应配置（如 Webhook URL）

• 已保存渠道: 如果你已在“我的通知渠道”中保存了渠道，可在下拉中直接选择已保存项（下拉样式与其他表单控件一致），选中后会自动填充该渠道的配置字段。
• 计划发送时间: 选择发送时间
• 重复任务: 勾选后可设置 Cron 表达式创建重复任务

2. 点击"创建任务"按钮

3. 系统会在指定时间自动发送通知

管理任务

• 查看任务: 右侧任务列表显示所有任务
• 筛选任务: 使用状态筛选器查看不同状态的任务
• 取消任务: 对于待发送的任务，点击"取消任务"按钮可取消
• 自动刷新: 任务列表每 30 秒自动刷新

渠道管理（前端）

• 在“创建通知任务”表单下方的“我的通知渠道”板块可以添加/管理个人渠道配置。
• 每个渠道项支持 编辑 与 删除 操作：编辑时会弹出模态框，允许修改渠道名称、配置字段及是否设为默认（渠道类型不可变更以保证安全）。
• 在创建任务时可从“选择已保存的渠道”下拉中快速选择，UI 已优化下拉样式以与表单一致，移动端也增加了触控友好性。

API 接口文档

主要接口：

• GET / - Web 管理界面
• POST /api/tasks - 创建任务
• GET /api/tasks - 获取任务列表
• GET /api/tasks/{id} - 获取任务详情
• PUT /api/tasks/{id} - 更新任务
• DELETE /api/tasks/{id} - 取消任务
• GET /api/channels - 获取支持的渠道列表

详细 API 文档请查看 example_usage.py。

项目结构

.
├── app.py                      # Flask Web API
├── models.py                   # 数据库模型
├── scheduler.py                # 任务调度器
├── notifier.py                 # 通知发送器
├── static/
│   └── index.html             # Web 前端界面
├── requirements.txt           # Python 依赖
├── gunicorn_config.py         # Gunicorn 配置
├── nginx.conf                 # Nginx 配置示例
├── docker-compose.yml         # Docker Compose 配置
├── Dockerfile                 # Docker 镜像配置
├── notify-scheduler.service   # Systemd 服务配置
├── start.sh                   # 启动脚本
├── stop.sh                    # 停止脚本
├── config_examples.json       # 配置示例
└── README.md                  # 项目文档

支持的通知渠道

具体见 ANotify

渠道	channel 值	配置字段
企业微信	wecom	corpid, corpsecret, agentid
企业微信Webhook	wecom_webhook	webhook_url
飞书	feishu	appid, appsecret, receiver_type, receiver_id
飞书Webhook	feishu_webhook	webhook_url
钉钉Webhook	dingtalk_webhook	webhook_url
PushPlus	pushplus	token
Server酱	serverchan	token
Gotify	gotify	server_url, token
Ntfy (ntfy.sh)	ntfy	server_url, topic
IYUU	iyuu	token (可选 server_url)
巴法云	bafayun	token (可选 server_url)

数据备份

# 备份数据库
cp notify_scheduler.db notify_scheduler.db.backup

# 使用 cron 定期备份
0 2 * * * cp /var/www/notify-scheduler/notify_scheduler.db /backup/notify_scheduler_$(date +\%Y\%m\%d).db

常见问题

Q: 如何更改运行端口？

A: 修改 gunicorn_config.py 中的 bind 配置或 app.py 中的端口设置。

Q: 支持哪些 Python 版本？

A: Python 3.8 及以上版本。

Q: 可以同时运行多个实例吗？

A: 不建议，因为会导致任务重复执行。如需高可用，建议使用主备模式。

Q: 如何添加新的通知渠道？

A: 在 notifier.py 中添加新的发送方法，并在 models.py 中添加渠道枚举。

开发计划

已完成

• 日历视图支持点击任务进行编辑
• 移动端响应式适配与触摸优化
• 拖拽调整任务时间（日历视图）
• 日历订阅及同步功能
• 支持多渠道消息推送
• 重复任务暂停功能
• 数据导入/导出
• 失败自动重试
• 脚本运行

License

MIT License

致谢

本项目使用 ANotify 作为通知发送库。