MaiQR Anywhere.
  • Python 74.5%
  • JavaScript 9.5%
  • Shell 6.5%
  • HTML 5.2%
  • CSS 2.9%
  • Other 1.4%
Find a file
2026-04-05 06:19:41 +00:00
.github/workflows 删除 Dependabot 配置文件 2026-04-04 17:26:05 +00:00
app 优化 OCR 识别区域,优先处理下半部分以提高稳定性,增加回退机制以应对极端情况 2026-04-05 06:19:41 +00:00
data first commit 2026-04-04 16:57:26 +00:00
docker 在 Dockerfile 中添加 hsetroot 依赖以支持图形界面功能 2026-04-05 06:19:35 +00:00
.dockerignore first commit 2026-04-04 16:57:26 +00:00
.env.example 添加 Telegram 预警功能,支持连续抓取失败时通过 Telegram 发送通知 2026-04-04 17:14:04 +00:00
.gitignore 添加 Telegram 预警功能,支持连续抓取失败时通过 Telegram 发送通知 2026-04-04 17:14:04 +00:00
docker-compose.dev.yml 更新 docker-compose 文件,使用环境变量替代硬编码的端口配置 2026-04-04 18:00:15 +00:00
docker-compose.yml 更新 docker-compose 文件,使用环境变量替代硬编码的端口配置 2026-04-04 18:00:15 +00:00
Makefile 更新 CI 配置,添加 Docker 构建和推送步骤;修改 Makefile 和 README 以支持新启动流程;新增开发环境的 docker-compose 文件 2026-04-04 17:25:56 +00:00
README.md 更新 CI 配置,添加 Docker 构建和推送步骤;修改 Makefile 和 README 以支持新启动流程;新增开发环境的 docker-compose 文件 2026-04-04 17:25:56 +00:00

MaiQR

docker-wechatLinux 微信)+ noVNC 网页桌面 + 舞萌 DX / 中二节奏登录二维码抓取 打包成一个可直接 docker compose 启动的项目,并对外提供 PNG / JSON 两种取码接口。

快速开始

1)(可选)复制配置文件并修改 token/端口等:

cp .env.example .env
  1. 启动服务(默认使用 GHCR 镜像):
docker compose pull
docker compose up -d

开发环境(本地构建镜像):

docker compose -f docker-compose.dev.yml up -d --build
  1. 浏览器访问:
  • 控制台:http://localhost:5000/?token=maiqr
  • 二维码 PNGhttp://localhost:5000/img?token=maiqr
  • 二维码 JSONhttp://localhost:5000/json?token=maiqr
  • noVNChttp://localhost:6080/vnc.html?autoconnect=true&resize=remote

首次使用时在 noVNC 里登录微信后,通过控制台触发抓取即可。

最小配置说明

  • MAIQR_TOKEN:接口访问 token同时作为默认 noVNC/VNC 密码)
  • MAIQR_BIND_ADDR:默认 127.0.0.1(更安全)。如需对外访问设为 0.0.0.0
  • MAIQR_HTTP_PORT / MAIQR_NOVNC_PORT:对外端口

其余可选参数见 .env.example;网页控制台内的参数会持久化到数据卷(容器内路径 /data/config.json)。

可选:支持 Telegram 预警(连续多次抓取失败时通知),配置见 .env.example 的 Telegram alerting 部分。

风险提示

该方案基于在容器里运行微信的思路,可能存在账号风险;请自行评估,生产/常用账号谨慎使用。

参考