自托管的微信读书公众号 RSS：部署在你自己的机器上，连接上游服务后即可在浏览器里管理账号与订阅，阅读器通过 RSS 链接收文章。
请使用国内机器作为客户端访问，微信读书对于非大陆 ip 存在风控
初始默认密码为 admin: changeme ， 请进入后及时更改，或尽量使用内网访问客户端 注：不支持拉取所有历史文章，减少风控，默认拉取最新 30 篇，除此之外，第一次拉取花费时间较长
git clone https://github.com/cry0404/MyWechatRss.git
cd MyWechatRss/client
cp .env.example .env配置： 编辑 .env（普通文本编辑器即可）。
- 随机密钥（各至少 16 个字符，且互不相同）。在终端执行两次下面命令，把输出分别填到
APP_SECRET和JWT_SECRET：
openssl rand -hex 32- 上游服务：向 Cry 索取并填写
UPSTREAM_BASE_URL、UPSTREAM_API_KEY_ID、UPSTREAM_API_SECRET。(baseurl 大概率为 https://wechat.cry4o4n0tfound.cc) - 你的网站地址：
PUBLIC_BASE_URL填你实际用来访问本服务的地址（含http或https，不要末尾斜杠）。例如本机试跑可用http://127.0.0.1:8081；公网域名则填https://rss.example.com。 - 首次管理员：保留或修改
BOOTSTRAP_*。数据库里还没有任何用户时，会用这组账号创建第一个管理员（仅一次）。登录后请到「设置」里修改密码。
然后启动：
docker compose up -d浏览器打开你在 PUBLIC_BASE_URL 里填的地址即可。数据文件在项目下的 data/ 目录（已挂载到容器内 /data）。
升级镜像：
docker compose pull && docker compose up -d官方镜像： ghcr.io/cry0404/MyWechatRss
通过环境变量 CONTENT_FETCH_MODE 控制文章正文是否抓取：
| 模式 | 值 | RSS 输出 | 请求量 | 适用场景 |
|---|---|---|---|---|
| Full（默认） | full |
包含完整正文 HTML (<content:encoded>) + 摘要 |
高 | 阅读器内直接阅读完整文章 |
| Summary | summary |
仅摘要 + 原文链接，不抓取正文 | 低 | 降低风控风险、提升抓取速度；点击 RSS 条目跳转原文阅读 |
底层逻辑： Full 模式下，每篇文章会依次尝试三条链路抓取正文（微信读书网页端 → 公众号公开页 → App 接口），记录每条链路的耗时与成功率。Summary 模式跳过所有正文抓取，仅保存文章元数据（标题、摘要、发布时间等），显著减少对外请求量。
在 .env 中设置：
CONTENT_FETCH_MODE=summary # 或 full（不写则默认 full）| 需求 | 做法 |
|---|---|
| 换宿主机端口 | 在 .env 里增加 HOST_PORT=9090（或其它端口），再执行 docker compose up -d。 |
| 允许任何人注册 | .env 中设置 ALLOW_REGISTER=true。 |
| 账号全部失效时邮件提醒 | 配置 SMTP_HOST、SMTP_PORT 等；用户需在个人资料里填写邮箱。 |
| 隐藏日志侧边栏（构建时） | 前端构建时传入 VITE_ENABLE_LOGS=false，日志入口和路由将被移除。（默认已开启） |
前端「日志」页面提供正文抓取的可观测性：
- 概览卡片：今日成功率、近 30 分钟失败率、活跃链路数
- 链路统计（24h）：按 chain（web / mp / shareChapter）汇总的成功率和平均耗时
- 最近记录：单条抓取记录，支持 全部 / 失败 / 成功 筛选，失败记录可展开查看完整错误信息，Review ID 可一键复制
注：日志数据来自
article_fetch_logs表，仅记录正文抓取阶段。Summary 模式下无正文抓取，因此不会产生日志记录。
仅在你需要改代码或无法使用镜像时使用。
git clone https://github.com/cry0404/MyWechatRss.git
cd MyWechatRss/client
cd web && npm ci && npm run build && cd ..
go build -o wechatread-client ./cmd/client同样通过环境变量配置；本地可直接 export 或自建 .env 后用进程管理器加载。数据库路径等与 dockerfile 中说明一致时，可将 DB_PATH 指到持久化目录。
以下变量均可在 .env 中设置（Docker 与直接运行二进制均适用）。未列出的项有程序内默认值。
必填（不填无法启动）： APP_SECRET、JWT_SECRET、UPSTREAM_BASE_URL、UPSTREAM_API_KEY_ID、UPSTREAM_API_SECRET。
| 变量 | 说明 | 默认值 |
|---|---|---|
LISTEN_ADDR |
监听地址 | :8081 |
DB_PATH |
SQLite 路径；Docker 镜像内默认 /data/app.db（需挂载卷） |
./data/app.db |
PUBLIC_BASE_URL |
对外访问根 URL，RSS 与邮件内链接依赖此项 | — |
CONTENT_FETCH_MODE |
正文抓取模式：full 或 summary |
full |
FEED_ID_SALT |
RSS feedId 加盐 | wechatread-rss |
ALLOW_REGISTER |
是否开放用户注册 | false |
HOST_PORT |
Docker Compose 宿主机映射端口 | 8081 |
BOOTSTRAP_USERNAME / BOOTSTRAP_PASSWORD / BOOTSTRAP_EMAIL |
空库时创建首个用户；BOOTSTRAP_PASSWORD 为空则不自动创建 |
admin / changeme / you@example.com |
DEFAULT_DEVICE_NAME |
微信读书侧设备名 | wechatread-rss |
SMTP_HOST、SMTP_PORT |
二者齐全则启用发信；否则不发邮件 | — |
SMTP_USERNAME、SMTP_PASSWORD、SMTP_FROM、SMTP_USE_TLS |
邮件细节；SMTP_FROM 可空，回退为用户名 |
— |