国内博主内容聚合阅读器
English · 简体中文
▶ 自托管部署：git clone → docker compose up -d → 打开 http://localhost（详细步骤）
国内博主内容聚合阅读器。关注的博主发的文章实时推送，覆盖雪球、集思录、淘股吧、微信公众号、知乎、微博、小红书等 14 个平台。
Folo 等 RSS 阅读器对国内个人博主支持不足。很多平台没有 RSS 输出，需要爬虫才能抓取内容。聚流通过混合适配器架构（RSS → RSSHub → 自定义爬虫）自动选择最优抓取方式，让你一个入口读到所有关注博主的更新。
- 14 个平台：雪球、集思录、淘股吧、东方财富、同花顺、韭圈儿、有知有行、微信公众号、知乎、微博、小红书、掘金、CSDN、V2EX
- 粘贴链接订阅：粘贴博主主页 URL，系统自动识别平台
- 新用户引导：注册后推荐高质量博主，一键批量订阅
- OPML 导入/导出：从其他阅读器迁移订阅
- 可配置抓取频率：1 分钟到 1 天，按订阅源独立设置
- 插件市场：社区贡献适配器，动态安装（仅管理员可安装，worker 需重启生效）
- 三栏布局：侧边栏 + 文章列表 + 阅读面板（桌面端）
- 移动端适配：响应式单栏布局 + 底部导航
- 安全渲染：文章内容通过 DOMPurify 净化后展示
- 分组/标签：自定义文件夹和彩色标签组织订阅
- 收藏 + 稍后阅读
- 标题搜索：关键词模糊匹配
- 键盘快捷键：j/k 导航、s 收藏、m 已读、? 帮助
- 暗色/亮色主题：支持跟随系统
- WebSocket：站内实时更新
- Web Push：浏览器系统通知
- 微信：企业微信群机器人 Webhook
- Telegram：Bot API
- 邮件：即时 / 每小时 / 每日摘要
- 免打扰：可配置静默时段，重要博主可豁免
- Cookie 过期提醒：平台凭证失效时自动通知用户更新
- PWA 支持：可添加到桌面，支持 Service Worker 缓存
- Cookie 管理：AES-256-GCM 加密存储平台凭证
- 开放 API：API Key 认证（仅支持
X-API-KeyHeader），第三方客户端接入 - 健康监控：适配器抓取成功率、耗时、错误追踪
- 国际化：中文 / English
- Docker + Docker Compose
- Git
# 1. 克隆项目
git clone https://github.com/rockbenben/juflow.git
cd juflow
# 2. 配置环境变量
cp .env.example .env
# 编辑 .env，必须修改：
# - SECRET_KEY（改为随机字符串，否则启动时会警告）
# - POSTGRES_PASSWORD（改为强密码）
# 3. 启动所有服务（带健康检查，自动等待依赖就绪，数据库迁移自动执行）
docker compose up -d
# 4. 访问
# 打开 http://localhost
# 注册后会看到推荐订阅源引导页，一键订阅即可开始| 服务 | 端口 | 说明 |
|---|---|---|
| frontend | 80 | Nginx 托管前端，反向代理 /api、/ws、/docs、/health 到后端 |
| backend | 8000 | FastAPI API + WebSocket（启动时自动执行数据库迁移） |
| celery-worker | — | 抓取 + 通知任务执行 |
| celery-beat | — | 定时调度 |
| postgres | — | 数据库（仅容器间通信，开发环境通过 override 暴露 5432） |
| redis | — | 任务队列 + 缓存（仅容器间通信，开发环境通过 override 暴露 6379） |
| rsshub | — | RSS 代理（开发环境通过 override 暴露 1200） |
开发端口通过
docker-compose.override.yml暴露（compose 自动加载）。生产部署时删除此文件或指定docker compose -f docker-compose.yml up -d。
- 登录后点击侧边栏底部的 + 添加订阅
- 粘贴博主主页 URL，如：
https://xueqiu.com/u/1234567890（雪球）https://blog.csdn.net/username（CSDN）https://www.zhihu.com/people/someone（知乎）半佛仙人（微信公众号 — 直接输入名称）
- 选择抓取频率，点击添加
进入 设置 → 通知：
- 选择默认通知渠道
- 微信：填入企业微信群机器人 Webhook URL
- Telegram：填入 Bot Token 和 Chat ID
- 邮件：填入接收邮箱
- 配置免打扰时段
部分平台（集思录、淘股吧、同花顺、韭圈儿、有知有行）需要登录才能抓取内容：
- 在浏览器中登录目标平台
- 打开开发者工具（F12）→ Application → Cookies
- 复制所有 Cookie 内容
- 进入 设置 → Cookie，粘贴并保存
Cookie 使用 AES-256-GCM 加密存储。当 Cookie 过期时，系统会自动通过 WebSocket 推送提醒。
安全说明：Cookie 在服务器端加密存储，但服务器管理员有能力解密。请仅在你信任的服务器上部署。
社区开发的适配器插件可通过 设置 → 插件 安装（仅管理员，即第一个注册的用户）：
- 输入插件 Git 仓库 URL，点击安装
- 或上传 zip 包
- 安装后 API 端立即生效；后台抓取任务需重启 worker（
docker compose restart celery-worker）
安全说明：插件在服务器上执行 Python 代码。仅安装你信任的插件。
第三方客户端可通过 API Key 接入：
- 进入 设置 → API，生成 API Key
- 请求时携带
X-API-KeyHeader（不支持 URL 参数传递，防止密钥泄露到日志） - API 文档：
http://localhost/docs
# 启动基础服务（override 文件自动暴露端口到 localhost）
docker compose up postgres redis rsshub -d
# 后端（不需要 .env，config.py 默认值指向 localhost）
cd backend
pip install -r requirements.txt
alembic upgrade head
uvicorn app.main:app --reload
# Celery Worker（新终端，在 backend/ 目录下）
celery -A app.tasks.celery_app worker --loglevel=info
# Celery Beat（新终端，在 backend/ 目录下）
celery -A app.tasks.celery_app beat --loglevel=info
# 前端（vite.config.ts 已配置 proxy，自动转发 /api /ws 到 localhost:8000）
cd frontend
npm install --legacy-peer-deps
npm run dev注意：
.env.example里的地址（postgres、redis）是 Docker 容器间通信用的。本地开发不要复制.env，直接用config.py的默认值（localhost）即可。
写适配器插件（三种基类、选择器写法、manifest 格式）和完整项目结构见 CONTRIBUTING.md。
| 变量 | 说明 | 必填 |
|---|---|---|
SECRET_KEY |
JWT 签名密钥（不设置会启动警告） | 是 |
POSTGRES_PASSWORD |
数据库密码 | 是 |
DATABASE_URL |
数据库连接字符串 | 是 |
REDIS_URL |
Redis 连接字符串 | 是 |
RSSHUB_URL |
RSSHub 实例地址 | 是 |
CORS_ORIGINS |
允许的前端域名（逗号分隔） | 否（默认 localhost） |
VAPID_PRIVATE_KEY |
Web Push 私钥 | 否（Web Push 需要） |
VAPID_PUBLIC_KEY |
Web Push 公钥 | 否（Web Push 需要） |
SMTP_HOST |
邮件服务器 | 否（邮件通知需要） |
SMTP_PORT |
邮件端口 | 否 |
SMTP_USER |
邮件账号 | 否 |
SMTP_PASSWORD |
邮件密码 | 否 |
SMTP_FROM |
发件人地址 | 否（默认 noreply@juflow.app） |
ACCESS_TOKEN_EXPIRE_MINUTES |
JWT 过期时间（分钟） | 否（默认 1440，即 24 小时） |
VAPID_CLAIM_EMAIL |
Web Push 联系邮箱 | 否（默认 admin@example.com） |
完整模板见 .env.example。
- XSS 防护：文章内容通过 DOMPurify 净化，邮件/Telegram 通知内容 HTML 转义
- XXE 防护：OPML 导入使用 defusedxml
- SSRF 防护：订阅 URL 阻止内网/元数据地址
- 输入验证：注册要求合法邮箱、密码 6 位以上、用户名 2-100 字符；搜索关键词转义 LIKE 通配符
- 认证限流：登录 10 次/分钟，注册 5 次/分钟（slowapi）
- 插件隔离：仅管理员可安装，插件名限制为字母数字，zip 防路径穿越
- API Key 安全：仅通过 Header 传递，不支持 URL 参数
- Cookie 加密：AES-256-GCM，按用户隔离
365 开源计划 的第 #007 个项目——一个人 + AI，一年 300+ 个开源项目。提交你的需求 → · Discord · Telegram