Skip to content

轻量级订阅管理系统,帮助您轻松跟踪各类订阅服务的到期时间,并通过Telegram发送及时提醒。

License

Notifications You must be signed in to change notification settings

xymn2023/SubsTracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SubsTracker 订阅管理系统

image

系统配置,修改账号密码,以及配置tg通知的信息

image

配置完成可以点击测试通知,查看是否能够正常通知,然后就可以正常添加订阅使用了!

image

Docker更新地址:SubsTracker-Docker

✨ 特性

  • 🔔 自动提醒: 在订阅到期前自动发送Telegram通知

  • 📊 订阅管理: 直观的Web界面管理所有订阅

  • 🔄 周期计算: 智能计算循环订阅的下一个周期

  • 📱 响应式设计: 完美适配移动端和桌面设备

  • ✅ 订阅列表按到期日期升序排序

  • ✅ 修复了提醒天数逻辑(reminderDays: 0 只在到期日提醒)

  • ✅ 添加了自动续费切换功能(autoRenew 字段)

  • ✅ 增强了测试通知功能(在配置页面独立测试按钮)

  • ✅ 实现了Toast通知系统

  • ✅ 表单验证和错误处理

  • ✅ 安全配置(不返回敏感信息)

1. 环境要求

  • Python 3.7 及以上
  • pip 包管理器

2. 安装依赖

在项目根目录下执行:

pip install -r requirements.txt

3. 启动项目

在项目根目录下运行:

python app.py

首次启动会自动生成 config.jsonsubscriptions.json 数据文件。

4. 访问方式

5. 配置说明

  • 管理员用户名/密码、通知方式等可在"系统配置"页面设置。
  • 支持 NotifyX、Telegram 两种通知推送方式。

6. 订阅管理

  • 可添加、编辑、删除订阅,支持周期续订、到期提醒、自动续期、启用/停用等功能。
  • 支持单条订阅测试通知。

7. 定时任务

  • 系统自动每小时检查一次订阅到期情况,并自动推送通知和续期(如设置了自动续订)。

8. Docker 部署(可选)

如需 Docker 部署:

docker build -t substracker .
docker run -d -p 5000:5000 --name substracker substracker

9. 依赖说明

  • Flask:Web 框架
  • PyJWT:JWT 登录认证
  • requests:第三方 HTTP 请求(用于通知推送)
  • APScheduler:定时任务调度

10. 数据文件

  • config.json:系统配置(自动生成/保存)
  • subscriptions.json:订阅数据(自动生成/保存)

11.docker部署

docker-compose.yml

version: '3.8'
services:
  web:
    image: smhw3565/substracker:latest
    container_name: substracker
    ports:
      - "5000:5000"
    restart: unless-stopped
    environment:
      - FLASK_APP=app.py
      - FLASK_RUN_HOST=0.0.0.0
      - FLASK_ENV=production

​ 一键启动

docker compose up -d

docker仓库地址

https://hub.docker.com/r/smhw3565/substracker

访问地址:

http://localhost:5000/

Star History

Star History Chart

About

轻量级订阅管理系统,帮助您轻松跟踪各类订阅服务的到期时间,并通过Telegram发送及时提醒。

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published