WeRSS - 微信公众号订阅助手

快速运行

docker run -d  --name we-mp-rss  -p 8001:8001   ghcr.io/rachelos/we-mp-rss:latest

http://<您的ip>:8001/ 即可开启

一个用于订阅和管理微信公众号内容的工具，提供RSS订阅功能。

功能特性

微信公众号内容抓取和解析
RSS订阅生成
用户友好的Web管理界面
定时自动更新内容

界面截图

登录界面
主界面
添加订阅
扫码授权

系统架构

项目采用前后端分离架构：

后端：Python + FastAPI
前端：Vue 3 + Vite
数据库：SQLite (默认)/MySQL

安装指南

后端服务

克隆项目

git clone https://github.com/rachelos/we-mp-rss.git
cd we-mp-rss

安装Python依赖

pip install -r requirements.txt

配置数据库
复制并修改配置文件：

cp config.example.yaml config.yaml

启动API服务

uvicorn web:app --host 0.0.0.0 --port 8001 --reload

前端界面

cd web_ui

安装Node.js依赖

npm install

启动开发服务器

npm run dev

定时任务

配置定时抓取微信公众号内容：

python job.py

配置说明

编辑config.yaml文件配置以下参数：

数据库连接
微信公众号配置
抓取间隔时间
API密钥等

API文档

API服务启动后，访问以下地址查看文档：

Swagger UI: http://localhost:8001/api/docs

⚙️ 环境变量

更多环境变量配置请查看config.example.yaml文件

变量名	说明	默认值
`DB`	必填数据库地址例如: mysql+pymysql://<用户名>:<密码>@<数据库IP>/<数据库名>	sqlite:///db.db
`INTERVAL`	抓取间隔时间，单位秒	`300`
`SECRET_KEY`	JWT授权加密KEY	'we-mp-rss'
`DINGDING_WEBHOOK`	钉钉机器人Webhook地址	-
`WECHAT_WEBHOOK`	微信机器人Webhook地址	-
`FEISHU_WEBHOOK`	飞书机器人Webhook地址	-
`MODEL`	采集方式：web 或 api	web
`PORT`	API服务端口	8001
`DEBUG`	调试模式	False
`MAX_PAGE`	第一次添加时采集的最大页数	5
`RSS_BASE_URL`	RSS域名地址	""
`RSS_LOCAL`	是否为本地RSS链接	True
`TOKEN_EXPIRE_MINUTES`	登录会话有效时长(分钟)	60
`GATHER.CONTENT`	是否采集内容	True
`GATHER.MODEL`	采集模式(web模式可采集发布链接，api模式可采集临时链接)	web
`LOG_FILE`	日志文件路径(空表示不输出到文件)	-
`LOG_LEVEL`	日志级别(DEBUG, INFO, WARNING, ERROR, CRITICAL)	INFO
`USERNAME`	管理员用户名	admin
`PASSWORD`	管理员密码	admin@123

快速运行

Docker Sqlite

docker run -d \
  --name we-mp-rss \
  -p 8001:8001 \
  -e DB=sqlite:///db.db \
  -e USERNAME:admin \
  -e PASSWORD:admin@123 \
  -e DINGDING_WEBHOOK=https://oapi.dingtalk.com/robot/send?access_token=xxx \
  -v $(pwd)/data:/app/data \
  ghcr.io/rachelos/we-mp-rss:latest

Docker Mysql

docker run -d \
  --name we-mp-rss \
  -p 8001:8001 \
  -e DB=mysql+pymysql://<username>:<password>@<host>/<database> \
  -e USERNAME:admin \
  -e PASSWORD:admin@123 \
  -e DINGDING_WEBHOOK=https://oapi.dingtalk.com/robot/send?access_token=xxx \
  -v $(pwd)/data:/app/data \
  ghcr.io/rachelos/we-mp-rss:latest

Docker构建及运行

# 构建
docker build -t we-mp-rss .
# Docker运行
docker run -d --name we-mp-rss -p 8001:8001 we-mp-rss

开发指南

后端开发

安装开发依赖

pip install -r requirements-dev.txt

运行测试

pytest

前端开发

修改环境变量
编辑.env.development文件
开发模式

npm run dev

构建生产版本

npm run build

贡献指南

欢迎提交Pull Request。在提交前请确保：

代码通过所有测试
更新相关文档
遵循代码风格指南

❤️ 赞助

如果觉得 We-MP-RSS 对你有帮助，欢迎给我来一杯啤酒！

仓库地址

许可证

MIT License