数据整理手记
如何把信息源整理成自己的知识流
个人开发成果 · 技术实践分享
把微信里的更新，
放回你的阅读器。
wx2rss 在你自己的电脑或服务器上运行，将关注的公众号转换成标准 RSS 2.0、JSON Feed 和 OPML。数据由你保管，订阅方式由你选择。
微信扫码登录
标准 RSS 输出
本地保存数据
wx2rss
订阅列表
最新文章
账号登录
运行状态
今日更新3 个公众号
运行正常技术观察
本周值得关注的开源项目
深度阅读
从收藏到真正读完，只差一个 RSS
RSS
/feed/2390768340.xml输出开放标准，可用于
InoreaderFeedlyNetNewsWireFreshRSSReeder
为什么选择 wx2rss
只做一件事：让公众号订阅重新简单、可控
不改变你的阅读习惯，也不把账号、订阅和历史文章交给陌生平台。
一次扫码，自动批量
微信确认一次后自动获得并保存微信读书 App 登录态，无需抓包或手工填写令牌，首次订阅即可批量回溯文章。
多种方式添加
公众号数字 ID、文章链接或 __biz 均可添加，减少寻找特殊参数的麻烦。
多格式订阅
同时输出 RSS 2.0、JSON Feed 与 OPML，常见阅读器可以直接使用。
智能调度与退避
根据历史发布时间安排抓取，并在触发限频时自动延长间隔，降低频繁请求带来的风险。
数据留在本地
订阅、文章和登录状态保存到你的数据目录。迁移时带走目录即可，不依赖在线托管账户。
支持备份与迁移
可备份订阅和已保存的文章，更换设备时通过数据目录或备份文件恢复。
从部署到阅读
四步建立自己的公众号信息流
- 1
启动程序
在支持 Docker 的电脑、NAS 或服务器上运行 wx2rss。
- 2
准备数据目录
将配置、订阅和文章保存在独立目录，便于备份与迁移。
- 3
扫码并添加公众号
微信扫码登录后，用文章链接或公众号 ID 添加订阅。
- 4
复制 RSS 地址
把生成的链接加入常用阅读器，等待自动更新。
自托管部署
一条命令启动，数据目录独立保存
项目镜像同时支持常见的 Intel/AMD 64 位与 ARM64 设备，可在本地电脑、NAS 或 Linux 服务器上启动。镜像不含任何预置数据库、账号、订阅或登录信息。
Docker 环境建议 1GB+ 内存首次需微信扫码
中国大陆 · 阿里云镜像
推荐 · 始终拉取最新版
docker run --pull=always -d --name wx2rss \
-p 127.0.0.1:8000:8000 --restart unless-stopped \
-v "$PWD/data:/app/data" \
registry.cn-hangzhou.aliyuncs.com/whm412/wx2rss:latest国际网络 · Docker Hub
备用
docker run --pull=always -d --name wx2rss \
-p 127.0.0.1:8000:8000 --restart unless-stopped \
-v "$PWD/data:/app/data" \
whm412/wx2rss:latest两个仓库发布的是同一版本，命令中的 --pull=always 会在启动前检查并拉取最新镜像。中国大陆网络建议优先使用阿里云。启动后直接打开 http://localhost:8000；程序会在 ./data 创建空数据库。用户端没有用户名和密码，请仅在本机或可信局域网中使用，不要把 8000 端口直接暴露到公网。
常见问题
部署前先了解这些
这是在线 RSS 服务吗？
不是。wx2rss 是本人开发维护的自托管技术项目，程序和数据运行在使用者自己的设备上；本站用于分享项目介绍、部署方法和使用经验。
历史数据如何保留？
订阅、文章和配置都保存在自己的数据目录中。日常备份该目录，更换设备时恢复即可。
如何从旧版本升级到最新版？
升级会保留原来的微信账号、订阅、文章、配置和授权，关键是继续挂载原来的 data 目录。升级前请先备份该目录，并确认旧容器使用的目录位置。
- 进入原部署目录：
cd /你的/wx2rss目录； - 备份数据：
cp -a data data-backup-$(date +%Y%m%d-%H%M%S)； - 拉取最新版：
docker pull registry.cn-hangzhou.aliyuncs.com/whm412/wx2rss:latest； - 停止并保留旧容器：
docker stop wx2rss && docker rename wx2rss wx2rss-backup； - 用原数据目录启动新版：
docker run -d --name wx2rss -p 127.0.0.1:8000:8000 --restart unless-stopped -v "$PWD/data:/app/data" registry.cn-hangzhou.aliyuncs.com/whm412/wx2rss:latest； - 打开页面确认账号、订阅、授权和版本正常后，再决定是否删除旧容器。
如果原容器名称、端口、数据目录、代理或其他环境变量不同，请沿用原配置，不要直接照抄覆盖。国际网络可把镜像地址替换为 whm412/wx2rss:latest。
支持哪些 RSS 阅读器？
支持 RSS 2.0、JSON Feed 或 OPML 的阅读器均可使用，例如 Inoreader、Feedly、NetNewsWire、FreshRSS 和 Reeder。
扫码后无法抓取或很快触发风控，应该先检查什么？
请先确认微信已经与微信读书完成公众号文章授权。正式使用前按以下顺序操作：
- 手机安装微信读书；
- 使用准备扫码的同一个微信账号登录微信读书；
- 在微信中打开任意一篇公众号文章；
- 点击文章右上角的“…”分享菜单；
- 选择“在微信读书中阅读”（不同手机和版本的文字可能略有不同）；
- 按照页面提示完成微信与微信读书的授权；
- 完成后再回到 wx2rss 生成二维码并扫码登录。
如果没有完成上述关联授权，批量文章接口可能无法正常使用，也可能更容易触发微信读书风控。
为什么需要微信扫码？
扫码用于取得本机抓取文章所需的微信读书登录会话，并读取微信公开昵称用于账号识别；登录数据只保存在你的部署目录中。
扫码后会自动获得批量能力吗？
会。1.2.0 起登录页直接完成微信读书 App 扫码授权，自动保存批量接口所需的 accessToken 与 vid。登录成功后首次订阅即可回溯约 20 篇，无需另外绑定令牌。
数据中心网络出现风控怎么办？
程序会自动降低请求频率并等待恢复。必要时可在服务配置中使用自有网络代理，避免反复手动请求。
如何在手机上手动解除微信读书风控？
出现风控提示后，请先在手机上完成以下操作，再回到 wx2rss 的“微信登录”页面点击对应账号的“刷新风控”：
- 打开微信读书，在书架页进入“文章收藏”；
- 如果出现授权提示，请按页面提示完成微信与微信读书的授权；
- 在收藏列表中点击任意一个公众号的名称，注意点击公众号名称，不是文章标题；
- 进入该公众号的文章列表页，确认页面能显示该公众号的文章，并按提示完成操作。
点击“刷新风控”只会恢复本地调度状态，不会立即请求微信接口。系统会在短暂安全等待后通过正常抓取验证账号；如果令牌自然过期，会自动尝试续期。仍然受到风控时，系统会重新进入退避等待，请不要连续点击。
如何接收账号失效和风控通知？
在用户端“服务配置 → 异常告警”中可配置 Telegram、Server酱、通用 Webhook、Bark 或钉钉机器人。钉钉机器人请选择关键词安全校验并填写“通知”，保存后点击“发送测试通知”验证。
微信小程序
在微信中查看 wx2rss 使用指南
扫码进入 wx2rss 小程序，可查看产品介绍、自托管部署方法、版本说明和常见问题，也可以联系人工客服。
小程序不提供在线 RSS 订阅服务，不运营公共内容目录，不聚合公众号内容。
阅读权应该属于读者