WeChatOArss

在算法推荐和信息茧房日益严重的今天，想要纯粹、完整且按时间顺序阅读微信公众号文章，似乎成了一种奢望。 折叠的订阅号列表、乱序的信息流、无法导出的封闭生态，让优质内容的获取变得支离破碎。

WeChatOArss 是一个长期稳定、可自部署的微信公众号 RSS 服务解决方案。它通过技术手段打破了微信的围墙，将封闭的公众号内容转化为标准的 RSS 2.0 或 JSON Feed 格式，让您能够使用任何喜欢的阅读器（如 Reeder, Feedly, Inoreader）或通过其自带的 Web 界面，重新掌控阅读的节奏。

核心特性：极简、私有、自由

WeChatOArss 专为追求数据主权和阅读体验的用户设计，具备以下核心能力：

• 📱 微信扫码，无缝登录
  无需复杂的账号密码配置或 Cookie 提取。首次访问只需使用微信扫描二维码即可授权登录，安全便捷，完美复用现有微信身份。
• 🔍 精准搜索，一键订阅
  支持通过公众号名称或直接粘贴文章链接进行搜索。找到目标后，一键添加至订阅列表，系统自动识别并追踪该公众号的最新动态。
• 📡 标准协议，全能兼容
  输出标准的 RSS 2.0 和 JSON Feed 格式。
  • 独立订阅：每个公众号拥有独立的 RSS 地址。
  • 聚合订阅：提供全量聚合地址，一站式获取所有订阅源更新。
  • 完美适配市面上几乎所有 RSS 阅读器及自动化工作流工具（如 IFTTT, Zapier）。
• 🌐 内置 Web 阅读器
  不仅提供数据源，还自带简洁优雅的 Web 阅读界面。支持在浏览器中直接浏览文章列表、阅读全文，体验纯净无广告的阅读环境。
• 🐳 Docker 部署，数据本地化
  基于 Docker 容器化技术，实现一键部署。所有数据（订阅关系、文章内容缓存）均存储在本地服务器，彻底杜绝隐私泄露风险，确保数据永远掌握在自己手中。

快速开始：5 分钟搭建私有阅读源

只需简单的几步，即可在本地或服务器上运行属于您的微信 RSS 服务。

1. 获取项目代码

git clone https://github.com/yourrepo/WeChatOArss.git
cd WeChatOArss

2. 配置环境变量

复制默认配置文件并根据需求修改（特别是 RSS_TOKEN，用于保护您的 API 接口）：

cp config/config.yaml config.yaml
# 使用编辑器打开 config.yaml，修改 RSS_TOKEN 为强随机字符串
# 同时可配置 RSS_HOST 为您的服务器域名或 IP

3. 一键启动服务

利用 Docker Compose 启动所有依赖组件：

docker-compose up -d

4. 开始使用

服务启动后，即可通过浏览器访问：

• Web 阅读界面: http://localhost:8080
• API 状态检查: http://localhost:8080/version

💡 提示：首次访问 Web 界面时，系统将展示微信登录二维码，请使用手机微信扫码完成授权。

使用指南：从订阅到阅读

🔐 第一步：登录授权

打开 Web 界面，扫描屏幕上的二维码。登录成功后，系统将保存会话，后续访问无需重复扫码（除非会话过期）。

➕ 第二步：添加公众号

进入 “公众号” 管理页面：

1. 点击 “添加公众号” 按钮。
2. 输入您想订阅的公众号名称，或直接粘贴一篇该公众号的文章链接。
3. 系统会自动解析并添加，随后开始后台抓取。

📡 第三步：获取 RSS 地址

每个订阅源都生成了固定的 RSS 地址，可直接填入阅读器：

• 单个公众号订阅：
  • XML 格式：/feed/{biz_id}.xml
  • JSON 格式：/feed/{biz_id}.json
  • (注：biz_id 可在公众号详情页查看)
• 全量聚合订阅（推荐）：
  • XML 格式：/feed/all.xml
  • JSON 格式：/feed/all.json
  • 将所有订阅的文章按时间倒序排列，适合一次性导入阅读器。

⚙️ 高级配置说明

通过修改 config.yaml 或设置环境变量，您可以深度定制服务行为：

为什么选择自部署 WeChatOArss？

1. 对抗算法操控：不再被“猜你喜欢”裹挟，严格按照关注时间和发布顺序阅读，不错过任何重要更新。
2. 数据隐私安全：所有抓取的数据存储在您自己的服务器或本地电脑上，没有第三方平台窥探您的阅读喜好。
3. 永久归档：即使公众号删除了文章，只要已被抓取，您本地的 RSS 记录或阅读器缓存中依然保留着副本（取决于阅读器策略）。
4. 跨平台统一：将微信内容与您关注的博客、新闻网站、YouTube 频道整合在同一个阅读器中，实现真正的信息流大一统。

⚠️ 注意事项与免责声明

• 合规使用：本工具仅供个人学习、研究及归档使用。请勿用于商业爬取、大规模分发或侵犯版权的行为。
• 账号安全：由于采用微信扫码登录机制，请避免在短时间内高频次抓取大量公众号，以免触发微信的风控机制导致账号受限。建议合理设置 SCHEDULER_TIMES。
• 稳定性：微信反爬策略不断升级，本项目致力于保持长期稳定，但无法保证 100% 永不被封锁。如遇失效，请关注项目更新或提交 Issue。