🔥 HotPush
热点聚合推送平台 - 聚合全网热点，主动推送到你指定的平台
✨ 特性
- 🌐 公开热搜榜 - 访问首页即可浏览全网热点，无需登录也能快速体验
- 🔐 分级权限 - 热搜公开可见，数据源、推送、规则、用户管理等功能登录后按角色授权
- 📦 热点聚合 - 聚合微博、知乎、B站、V2EX、Hacker News、NodeSeek 等多个平台热榜
- 📨 多渠道推送 - 支持 Telegram、Discord、企业微信、飞书、钉钉等
- ⚡ 实时更新 - 分钟级热点监控，第一时间推送新热点
- 🎯 智能过滤 - 支持关键词过滤、时间段限制、来源过滤等规则
- 🤖 AI 摘要 - 支持 OpenAI、Claude、DeepSeek、Ollama 等，自动生成智能热点摘要
- 📈 趋势分析 - 可视化热搜排名变化趋势与热度走势
- 🎨 现代化界面 - Vue 3 + Tailwind CSS 构建的响应式前端
- 👥 用户管理 - 支持多用户、权限控制
- 🐳 一键部署 - Docker 快速启动，开箱即用
- 🆓 开源免费 - MIT 协议，自由使用
🌐 在线演示
想先体验一下？访问我们的在线演示站点：
演示地址：https://hotpush.dawenzaist.de5.net
热搜榜可直接访问，无需登录。需要体验推送配置、数据源、趋势分析等管理功能时，可使用测试账号：
| 账号 | 密码 |
|---|---|
| test | test123 |
⚠️ 演示账号仅供体验，权限受限。如需完整管理能力请自行部署。
📸 界面预览
🔥 公开热搜榜 - 未登录也可浏览
访问首页即可查看聚合热点，右上角保留登录/注册入口，侧边栏仅展示公开菜单。
🔐 登录页面
支持从登录页返回热搜榜，用户登录后按角色进入对应功能。
📡 数据源管理
查看内置数据源，并按分类管理自定义 RSS 源。
📈 趋势分析 - 排名变化与热度走势
📨 推送配置 - 多渠道推送
配置 Telegram、Discord、企业微信、飞书、钉钉、邮件、Webhook 等推送渠道，并选择参与推送的数据源。
🎯 推送规则 - 智能过滤
配置关键词包含、关键词排除、时间段限制、来源过滤等推送规则。
📜 推送历史
查看历史推送记录、成功率和推送统计。
⏰ 定时任务与 AI 摘要
配置定时摘要、立即推送摘要，并接入 OpenAI、Claude、DeepSeek、Ollama 等模型生成热点摘要。
👥 用户管理
管理员可管理用户账号和角色权限。
📦 支持的热榜源
| 分类 | 平台 |
|---|---|
| 热搜榜 | 微博热搜、知乎热榜 |
| 技术 | V2EX、Hacker News、掘金热榜、Linux DO、NodeSeek |
| 视频 | B站热搜 |
| 科技资讯 | 少数派 |
| 影视 | 豆瓣热映 |
| 阅读 | 豆瓣新书 |
| 新闻 | 联合早报、澎湃新闻 |
📱 支持的推送渠道
| 渠道 | 状态 | 配置难度 |
|---|---|---|
| Telegram | ✅ | ⭐ 简单 |
| Discord | ✅ | ⭐ 简单 |
| 企业微信 | ✅ | ⭐⭐ 中等 |
| 飞书 | ✅ | ⭐⭐ 中等 |
| 钉钉 | ✅ | ⭐⭐ 中等 |
| Webhook | ✅ | ⭐ 简单 |
| 邮件 | ✅ | ⭐⭐ 中等 |
🛠️ 技术栈
| 组件 | 技术 |
|---|---|
| 后端 | Python 3.11+ / FastAPI |
| 前端 | Vue 3 / Vite / Tailwind CSS |
| 数据库 | MySQL 8.0+ |
| 缓存 | Redis 6.0+ |
| 数据源 | RSSHub |
🚀 快速开始
环境要求
- Python 3.11+
- Node.js 18+
- MySQL 8.0+
- Redis 6.0+
方式一：Docker 部署（推荐）
# 克隆项目
git clone https://github.com/JackyST0/hotpush.git
cd hotpush
# 编辑 docker-compose.yml：
# 1. 修改 ADMIN_PASSWORD 和 JWT_SECRET
# 2. 按需配置 RSSHub Cookie、AI 摘要或推送渠道
# 启动
docker compose up -d
# 访问 http://localhost:3001，未登录即可查看热搜榜
⚠️ 重要：项目自带 RSSHub 实例，部分数据源需要配置 Cookie 才能正常使用，详见 Cookie 配置说明
默认管理员账号：
- 用户名：
admin - 密码：
admin123（请在docker-compose.yml中修改）
部署后请修改以下配置：
# 生成随机 JWT 密钥（防止重启后用户登录失效）
openssl rand -base64 32
将生成的字符串填入 docker-compose.yml 的 JWT_SECRET 中。
💡 Docker 部署时配置主要在
docker-compose.yml里完成；backend/.env主要用于本地开发模式。
方式二：本地开发
1. 启动后端
cd hotpush/backend
# 创建虚拟环境
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
# 安装依赖
pip install -r requirements.txt
# 配置环境变量
cp .env.example .env
# 编辑 .env 文件，配置 MySQL 和 Redis
# 创建数据库
mysql -u root -p -e "CREATE DATABASE hotpush CHARACTER SET utf8mb4;"
# 启动后端
uvicorn app.main:app --reload --port 8000
2. 启动前端
cd hotpush/frontend
# 安装依赖
npm install
# 启动开发服务器
npm run dev
# 访问 http://localhost:3000，未登录即可查看热搜榜
📖 API 文档
本地开发模式启动后，可访问 http://localhost:8000/docs 查看 Swagger API 文档。
生产/Docker 默认
DEBUG=false，不会暴露 Swagger 文档。
主要接口
公开接口：
| 接口 | 方法 | 说明 |
|---|---|---|
/api/hot/stream |
GET | 流式获取热榜，前端热搜榜默认使用 |
/api/hot |
GET | 获取所有热榜 |
/api/hot/{source_id} |
GET | 获取指定热榜 |
/api/stats |
GET | 获取基础统计信息 |
登录后接口：
| 接口 | 方法 | 说明 |
|---|---|---|
/api/sources |
GET | 获取所有热榜源 |
/api/sources/custom |
GET/POST | 管理自定义 RSS 源 |
/api/trends/ranking/{source_id} |
GET | 获取排名变化趋势 |
/api/config/push |
GET/POST | 管理推送渠道 |
/api/rules |
GET/POST | 管理推送规则 |
/api/history |
GET | 查看推送历史 |
/api/scheduler/status |
GET | 查看定时任务状态 |
/api/users |
GET | 用户管理（管理员） |
🍪 Cookie 配置
部分热榜源配置 Cookie 后更稳定、数据更完整。Docker 部署时可在 docker-compose.yml 中的 rsshub 服务下配置：
| 数据源 | 环境变量 | 是否必须 | 获取方式 |
|---|---|---|---|
| 微博热搜 | WEIBO_COOKIE |
推荐 | 登录 weibo.com → F12 → Network → 复制 Cookie |
| B站热搜 | BILIBILI_COOKIE |
推荐 | 登录 bilibili.com → F12 → Network → 复制 Cookie |
获取 Cookie 步骤
- 使用 Chrome 浏览器登录对应网站
- 按 F12 打开开发者工具
- 切换到 Network（网络）标签
- 刷新页面，点击任意请求
- 在 Headers 中找到
Cookie字段，复制完整内容
配置示例
编辑 docker-compose.yml：
rsshub:
environment:
- WEIBO_COOKIE=SUB=xxx; SUBP=xxx; ...
- BILIBILI_COOKIE=SESSDATA=xxx; bili_jct=xxx; ...
💡 Cookie 会过期，如果数据获取失败，请重新获取并更新配置
⚙️ 推送渠道配置
Telegram 配置
- 找 @BotFather 创建 Bot，获取 Token
- 找 @userinfobot 获取你的 Chat ID
- 登录管理界面，在「推送配置」里填写；也可以通过环境变量预配置：
TELEGRAM_BOT_TOKEN=your_bot_token TELEGRAM_CHAT_ID=your_chat_id
Discord 配置
- 服务器设置 → 整合 → Webhook → 创建 Webhook
- 复制 Webhook URL
- 登录管理界面，在「推送配置」里填写；也可以通过环境变量预配置：
DISCORD_WEBHOOK_URL=your_webhook_url
企业微信/飞书/钉钉
- 在群设置中添加机器人
- 复制 Webhook URL
- 登录管理界面，在「推送配置」里填写；也可以通过环境变量预配置
📚 功能说明
| 模块 | 说明 |
|---|---|
| 公开热搜榜 | 访问首页即可浏览各平台热点，支持按分类筛选和实时刷新 |
| 登录与权限 | 未登录只展示热搜榜；登录后按测试用户、普通用户、管理员角色开放功能 |
| 数据源 | 管理内置数据源，支持添加自定义 RSS 源 |
| 趋势分析 | 可视化各平台热搜排名变化趋势和热度走势，支持时间范围筛选 |
| 推送配置 | 配置 Telegram、Discord、企业微信等推送渠道 |
| 推送规则 | 设置关键词过滤、时间段限制、来源过滤等规则 |
| 推送历史 | 查看历史推送记录，支持清理旧数据 |
| 定时任务 | 配置抓取间隔、定时摘要推送 |
| AI 摘要 | 使用 AI 生成智能热点摘要，支持多种风格和模型 |
| 用户管理 | 管理系统用户，设置权限（管理员可见） |
🗺️ 路线图
- MVP：热点聚合 + 基础推送
- Vue 前端管理界面
- 用户系统 + 权限管理
- 公开热搜榜，未登录可浏览
- 推送规则（关键词过滤、时间段限制）
- 自定义数据源（RSS）
- Redis 缓存
- MySQL 持久化
- AI 摘要（支持 OpenAI / Claude / DeepSeek / Ollama 等）
- 移动端适配优化
- 热搜趋势图表
🤖 AI 摘要配置
AI 摘要功能使用 litellm 统一接入多种大模型，在定时摘要推送时自动生成智能热点摘要。
支持的模型
| 提供商 | 模型示例 | 说明 |
|---|---|---|
| OpenAI | gpt-4o-mini |
性价比高 |
| Anthropic | claude-sonnet-4-20250514 |
长文理解强 |
| DeepSeek | deepseek/deepseek-chat |
国产模型，价格低 |
| Ollama | ollama/llama3 |
本地部署，免费 |
| 其他 | 支持所有 litellm 兼容模型 | 完整列表 |
配置方式
在管理界面「定时任务」页面底部的「AI 摘要」面板中配置：
- 模型 - 填写模型名称（如
gpt-4o-mini） - API Key - 填写对应提供商的 API Key
- API 地址（可选）- 使用第三方代理或本地模型时填写
- 摘要风格 - 简洁速递 / 详细分析 / 晨间简报
💡 支持 OpenAI 兼容的第三方代理服务，填写代理地址和 Key 即可。系统会根据模型名自动识别 API 格式。
摘要风格
| 风格 | 特点 | 适合场景 |
|---|---|---|
| 简洁速递 | 按主题分组，每条1-2句话，500字以内 | 日常快速了解 |
| 详细分析 | 有背景分析和趋势点评，800字以内 | 深入了解来龙去脉 |
| 晨间简报 | 分版块、每条一句话，400字以内 | 像看专业早报 |
❓ 常见问题
Q: 热搜数据获取失败？
- 检查 RSSHub 服务是否正常运行：
docker logs hotpush-rsshub - 部分源需要配置 Cookie（微博、B站），参考 Cookie 配置
- Cookie 可能已过期，需要重新获取
Q: 推送没有收到消息？
- 检查推送渠道配置是否正确
- 使用"测试推送"功能验证
- 检查是否有推送规则过滤了所有内容
Q: 如何添加自定义数据源？
在"数据源"页面点击"添加自定义源"，输入任意有效的 RSS 地址即可。
Q: Docker 部署后无法访问？
- 确保所有服务正常启动：
docker compose ps - 检查端口是否被占用：默认前端访问端口是
3001 - 查看日志定位问题：
docker compose logs -f
🤝 贡献
欢迎提交 Issue 和 Pull Request！
📄 License
📚 相关项目
| 项目 | 说明 |
|---|---|
| awesome-rsshub-routes | 🎯 精选 RSSHub 实用路由推荐，让你的 RSS 阅读更高效！ |
💡 如果你想了解更多 RSSHub 路由或添加自定义数据源，可以参考这个项目获取灵感！