wechat-download-api

环境要求

• 已安装 Docker 和 Docker Compose（也可改用项目自带的 bash start.sh 一键脚本）
• 拥有一个微信公众号（订阅号、服务号均可），需用管理员微信扫码登录
• 如需抓取完整文章内容，建议准备 2-3 个 SOCKS5 代理（可自建，降低风控风险）
• 本地电脑即可运行，不强制要求公网服务器；仅远程访问时才需要域名或内网穿透

安装与启动步骤

1. 1克隆项目代码

   把项目源码下载到本地并进入项目目录，后续所有命令都在该目录下执行。

   git clone https://github.com/tmwgsicp/wechat-download-api.git
   cd wechat-download-api

   复制

2. 2复制配置文件

   把 env.example 复制成 .env，服务启动时会读取该文件；登录后的微信凭证也会自动写入这里。

   cp env.example .env

   复制

3. 3填写必要配置

   编辑 .env，重点是 SITE_URL 必须改成实际访问地址（否则 RSS 图片不显示）；有条件再填 PROXY_URLS 代理池。

4. 4启动服务

   使用 docker-compose 后台启动容器，默认监听 5000 端口，数据挂载到本地 data 目录。

   docker-compose up -d

   复制

5. 5或用 docker run 启动

   不想用 compose 时可改用单条 docker run，注意先确保当前目录下已有 .env 文件，否则挂载会失败。

   docker run -d \
     -p 5000:5000 \
     -v $(pwd)/data:/app/data \
     -v $(pwd)/.env:/app/.env \
     --name wechat-api \
     tmwgsicp/wechat-download-api:latest

   复制

6. 6扫码登录

   浏览器打开登录页，用公众号管理员微信扫码，成功后凭证自动保存到 .env，有效期约 4 天。

关键配置

如何确认成功

浏览器打开 http://localhost:5000/login.html 能看到登录页，微信扫码成功并提示凭证已保存即部署完成。

常见问题

注意事项

• SITE_URL 必须配置为实际访问地址（IP 或域名），否则 RSS 图片无法正常显示。
• PROXY_URLS 为可选项但强烈建议配置，配合项目内置的 Chrome TLS 指纹模拟可有效规避风控。
• 扫码登录凭证保存在 .env 中，约 4 天过期，过期需重新扫码，注意别把 .env 泄露或提交到仓库。
• 官方镜像支持 linux/amd64 与 linux/arm64（Apple Silicon、树莓派、ARM 服务器均可运行）。