把微信里的更新，
放回你的阅读器。

ADMIN_UI_TOKEN 是管理后台密码，用户名固定为 admin，通过 Docker 环境变量设置。

在终端运行 export ADMIN_UI_TOKEN="$(openssl rand -hex 24)" 生成密码，再在 Docker 启动命令中增加 -e ADMIN_UI_TOKEN。

已有容器需要保留原数据目录和其他启动参数后重新创建，仅重启无法新增环境变量。

忘记密码时，可在自己的服务器终端运行下面命令查看已配置的值（将 wx2rss 换成实际容器名），不要将输出发给他人：

docker inspect --format '{{range .Config.Env}}{{println .}}{{end}}' wx2rss | grep '^ADMIN_UI_TOKEN='

没有输出或等号后为空，表示尚未配置。

支持普通文章正文获取，可通过 RSS 阅读已成功保存的正文。升级前已保存的历史文章不会自动补抓；如有需要，可在“文章浏览”或“订阅管理 → 分析”中逐篇点击“抓取正文”。

升级后新获取的文章（包括新订阅公众号的文章），会随该公众号的正常抓取任务分批获取正文：每轮默认最多 5 篇，可在服务配置中调整；新增文章优先，不足时补该公众号的待处理文章。不会一次连续抓完全部正文，请求之间保留等待间隔，以降低集中访问带来的风控风险，但不能保证完全避免风控。

普通文章即使正文以图片为主也可获取；贴图以及没有有效普通正文的页面会跳过。文章浏览和订阅分析支持按正文状态及内容类型筛选，方便查看进度。

wx2rss 仍以自托管为主，程序和数据运行在使用者自己的设备上；本站另外提供少量经过人工审核的免费公众号 RSS，方便先体验，再决定是否部署自己的实例。

订阅、文章和配置都保存在自己的数据目录中。日常备份该目录，更换设备时恢复即可。

升级会保留原来的微信账号、订阅、文章、配置和授权，关键是继续挂载原来的 data 目录。升级前请先备份该目录，并确认旧容器使用的目录位置。

1. 进入原部署目录：cd /你的/wx2rss目录；
2. 备份数据：cp -a data data-backup-$(date +%Y%m%d-%H%M%S)；
3. 拉取最新版：docker pull registry.cn-hangzhou.aliyuncs.com/whm412/wx2rss:latest；
4. 停止并保留旧容器：docker stop wx2rss && docker rename wx2rss wx2rss-backup；
5. 用原数据目录启动新版：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；
6. 打开页面确认账号、订阅、授权和版本正常后，再决定是否删除旧容器。

如果原容器名称、端口、数据目录、代理或其他环境变量不同，请沿用原配置，不要直接照抄覆盖。国际网络可把镜像地址替换为 whm412/wx2rss:latest。

支持 RSS 2.0、JSON Feed 或 OPML 的阅读器均可使用，例如 Inoreader、Feedly、NetNewsWire、FreshRSS 和 Reeder。

请先确认微信已经与微信读书完成公众号文章授权。正式使用前按以下顺序操作：

1. 手机安装微信读书；
2. 使用准备扫码的同一个微信账号登录微信读书；
3. 在微信中打开任意一篇公众号文章；
4. 点击文章右上角的“…”分享菜单；
5. 选择“在微信读书中阅读”（不同手机和版本的文字可能略有不同）；
6. 按照页面提示完成微信与微信读书的授权；
7. 完成后再回到 wx2rss 生成二维码并扫码登录。

如果没有完成上述关联授权，批量文章接口可能无法正常使用，也可能更容易触发微信读书风控。

扫码用于取得本机抓取文章所需的微信读书登录会话，并读取微信公开昵称用于账号识别；登录数据只保存在你的部署目录中。

会。1.2.0 起登录页直接完成微信读书 App 扫码授权，自动保存批量接口所需的 accessToken 与 vid。登录成功后首次订阅即可回溯约 20 篇，无需另外绑定令牌。

新账号缺少正常使用记录，建议先在手机端培养一段时间的自然使用习惯，再逐步增加 wx2rss 的使用量：

1. 先在微信读书中订阅 10 个以上公众号；
2. 每天分散阅读公众号文章，并从文章页点击公众号名称查看历史文章；建议每天完成 5 次以上自然操作，每次间隔约 1 小时，避免短时间连续操作；
3. 使用 wx2rss 的前 3 天，每次只启用 2～5 个公众号，完成抓取后停用，间隔 1 小时以上再继续；3 天后再逐步延长启用时间，可先增加到约 3 小时；
4. 总体原则是手机端保持正常、持续使用，wx2rss 前期少量、分散使用，稳定后再逐步增加。

这些做法只能降低触发概率，不能保证完全避免微信读书的安全校验；如已触发风控，请停止抓取并按下方“如何在手机上手动解除微信读书风控？”操作。

程序会自动降低请求频率并等待恢复。必要时可在服务配置中使用自有网络代理，避免反复手动请求。

出现风控提示后，请先在手机上完成以下操作，再回到 wx2rss 的“微信登录”页面点击对应账号的“刷新风控”：

1. 打开微信读书，在书架页进入“文章收藏”；
2. 如果出现授权提示，请按页面提示完成微信与微信读书的授权；
3. 在收藏列表中点击任意一个公众号的名称，注意点击公众号名称，不是文章标题；
4. 进入该公众号的文章列表页，确认页面能显示该公众号的文章，并按提示完成操作。

点击“刷新风控”只会恢复本地调度状态，不会立即请求微信接口。系统会在短暂安全等待后通过正常抓取验证账号；如果令牌自然过期，会自动尝试续期。仍然受到风控时，系统会重新进入退避等待，请不要连续点击。

在用户端“服务配置 → 异常告警”中可配置 Telegram、Server酱、通用 Webhook、Bark 或钉钉机器人。钉钉机器人请选择关键词安全校验并填写“通知”，保存后点击“发送测试通知”验证。