综合介绍
WeWe RSS 是一个免费的开源工具,专门为微信公众号用户设计。它通过微信读书平台抓取公众号文章,生成 RSS 订阅源,让用户可以用 RSS 阅读器随时查看内容。这个工具解决了微信公众号信息封闭的问题,支持私有化部署,用户可以自己搭建服务,确保数据安全。WeWe RSS 提供定时更新和全文输出功能,操作简单,部署灵活。官方数据显示,截至 2025 年 3 月,项目在 GitHub 上已获超 6500 个星标,深受技术爱好者和 RSS 用户欢迎。
功能列表
- 订阅微信公众号:通过微信读书平台添加公众号,生成 RSS 订阅源。
- 多种 RSS 格式:支持
.atom
、.rss
、.json
三种格式输出。 - 历史文章获取:可提取公众号过往发布的内容。
- 定时自动更新:后台定期刷新订阅源,保持内容最新。
- 全文输出支持:提供完整文章内容,方便深度阅读。
- 标题过滤功能:通过参数筛选或排除特定关键词的文章。
- OPML 导出:支持将所有订阅源导出为 OPML 文件。
- 手动更新订阅:通过接口触发单个订阅源即时更新。
使用帮助
安装流程
WeWe RSS 支持多种部署方式,包括 Docker、本地部署和一键部署。以下是详细步骤。
方法一:Docker 部署(推荐)
- 安装 Docker
确保你的设备已安装 Docker。Windows/Mac 用户可从官网(https://www.docker.com/)下载 Docker Desktop,Linux 用户运行sudo apt install docker.io
(以 Ubuntu 为例)。 - SQLite 版本(简单部署)
在终端输入以下命令启动:
docker run -d --name wewe-rss -p 4000:4000 -e DATABASE_TYPE=sqlite -e AUTH_CODE=123567 -v $(pwd)/data:/app/data cooderl/wewe-rss-sqlite:latest
-p 4000:4000
:映射端口到本地 4000。-e AUTH_CODE=123567
:设置授权码,可自定义。-v $(pwd)/data:/app/data
:数据保存在当前目录的data
文件夹。
- MySQL 版本(稳定部署)
- 创建网络:运行
docker network create wewe-rss
。 - 启动 MySQL:
docker run -d --name db -e MYSQL_ROOT_PASSWORD=123456 -e TZ='Asia/Shanghai' -e MYSQL_DATABASE='wewe-rss' -v db_data:/var/lib/mysql --network wewe-rss mysql:8.3.0 --mysql-native-password=ON
- 启动 WeWe RSS:
docker run -d --name wewe-rss -p 4000:4000 -e DATABASE_URL='mysql://root:123456@db:3306/wewe-rss?schema=public&connect_timeout=30&pool_timeout=30&socket_timeout=30' -e AUTH_CODE=123567 --network wewe-rss cooderl/wewe-rss:latest
- 检查运行
部署后,打开浏览器访问http://localhost:4000
(本地)或服务器 IP 加端口。若看到界面,说明成功。
方法二:本地部署
- 安装依赖
下载 Node.js(建议 v18+)和 pnpm(命令:npm install -g pnpm
)。 - 克隆代码
git clone https://github.com/cooderl/wewe-rss.git
cd wewe-rss
- 配置环境
以 SQLite 为例:
export DATABASE_URL="file:../data/wewe-rss.db"
export DATABASE_TYPE="sqlite"
rm -rf apps/server/prisma
mv apps/server/prisma-sqlite apps/server/prisma
npx prisma generate --schema apps/server/prisma/schema.prisma
npx prisma migrate deploy --schema apps/server/prisma/schema.prisma
- 构建并运行
pnpm install && pnpm run -r build && pnpm run start:server
建议用 pm2 守护进程:pm2 start pnpm -- start:server
。
方法三:一键部署
- 通过 Zeabur(https://zeabur.com/templates/DI9BBD)或 Railway(https://railway.app/)部署,只需输入项目 URL,按提示操作即可。
如何使用
部署完成后,WeWe RSS 的操作分为账号登录和订阅添加两步。
添加账号
- 打开
http://localhost:4000
(或服务器地址)。 - 点击“账号管理” > “添加账号”。
- 用微信扫描二维码,登录微信读书账号。若提示失效,需重新扫码。
订阅公众号
- 点击“公众号源” > “添加”。
- 输入公众号分享链接(可在微信读书找到),提交订阅。
- 系统通过微信读书抓取内容,生成 RSS 链接。注意:添加频率过高可能被限制,需等 24 小时解封。
获取 RSS 链接
- 在“公众号源”页面,找到已订阅的公众号。
- 点击复制 RSS 链接(如
http://localhost:4000/feeds/公众号ID.rss
)。 - 将链接加入 RSS 阅读器(如 Feedly)。
标题过滤
- 在 RSS 链接后加参数:
- 包含关键词:
?title_include=张三|李四
(多个用|
分隔)。 - 排除关键词:
?title_exclude=张三丰
。 - 示例:
http://localhost:4000/feeds/all.rss?title_include=新闻|科技&title_exclude=广告
。
手动更新
- 在 RSS 链接后加
?update=true
,如http://localhost:4000/feeds/公众号ID.rss?update=true
。 - 更新后需再次请求无
update
参数的链接查看结果。
特色功能操作
全文输出
- 默认仅输出摘要。启用全文需设置环境变量
FEED_MODE=fulltext
(部署时添加)。 - 注意:全文模式会增加响应时间和内存占用。
定时更新
- 默认每天 5:35 和 17:35 更新(
CRON_EXPRESSION=35 5,17 * * *
)。 - 调整频率可修改此变量,如每小时更新设为
0 * * * *
。
私有化部署
- 设置
SERVER_ORIGIN_URL
为公网 IP 或域名(如http://你的域名:4000
),便于外网访问。 - 数据存储在 SQLite 或 MySQL 中,建议定期备份。
请求限制
- 默认每分钟 60 次请求(
MAX_REQUEST_PER_MINUTE=60
)。若遇“今日小黑屋”,可降低频率或等待 24 小时。
注意事项
- 网络优化:国内访问微信读书慢时,设置
PLATFORM_URL=https://weread.965111.xyz
。 - 日志排查:运行出错时,用
docker logs wewe-rss
查看日志。 - 账号状态:
- “今日小黑屋”:请求超限,需等一天或重启服务。
- “失效”:重新扫码登录。
通过以上步骤,你可以快速部署并使用 WeWe RSS,享受便捷的公众号订阅体验。