← 返回项目库

微信扫码登录系统

面向公众号验证码登录的微信认证系统，提供扫码关注、验证码登录、多站点接入与 SDK 演示。

wx-auth 将微信公众号消息处理、一次性验证码、签名 Token、登录态吊销和前端 SDK 集中为一套可本地运行的 Nuxt 应用。中文演示页展示了登录流程、NPM/CDN 接入、配置项和 API 方法，便于开发者快速评估与二次开发。

真实界面

项目截图

共 6 张

登录流程
SDK 接入演示
方式一：NPM 安装
方式二：CDN 引入
配置说明
API 方法

Capabilities

核心功能

✓扫码关注公众号
✓回复关键词获取验证码
✓验证码一次性校验
✓签名 Token 与 Cookie 登录态
✓多站点 siteId 接入
✓零依赖前端 SDK

适用场景

为会员站点增加微信认证
在本地演示公众号验证码登录流程
基于 SDK 二次开发多站点登录能力

适合谁

需要接入微信公众号登录的独立开发者、小型网站团队与 Nuxt/Vue 开发者。

商业化思路

开源源码交付与学习研究收录；不承诺代运营公众号、短信登录或第三方云服务。

你会拿到什么

  • ✓Nuxt 4/Vue 3/TypeScript 源码与 Docker Compose 配置
  • ✓微信认证后端、前端 SDK 与中文演示页
  • ✓6 张真实中文功能状态截图及运行证据
  • ✓MIT License、上游来源和修改披露

部署流程

  1. 1准备 Node.js 20+ 与 Docker（可选）。
  2. 2复制环境变量模板并填写公众号 Token、Session Secret 与 Turso 配置。
  3. 3执行 npm install 后运行 npm run dev，或执行 docker compose up -d --build。
  4. 4打开 http://127.0.0.1:3000，点击扫码登录查看演示弹窗。

真实验证结果

已通过 npm run build、wx-auth-sdk 10 项测试，以及固定浏览器 1440×900 DPR 1 的 6 张真实中文功能截图验证；控制台错误、破图和横向溢出均为零。

部署前须知

微信真实扫码和公众号回调需要运营主体配置；本地演示不能替代生产公众号验签与密钥管理。

部署难度

中等

最低配置

本地运行需要 Node.js 20+；生产部署还需要微信公众号配置、Turso 数据库和安全的环境变量。

开源许可证

MIT License

最后验证

2026-09-05

技术栈

Nuxt 4Vue 3TypeScriptTailwind CSSDocker Compose

授权说明

仓库根目录 LICENSE 为 MIT License，交付包保留许可证与版权声明；本次修改增加了中文演示提示与截图可验证状态，未主张上游源码权利。

Release notes

版本记录

1 个已发布版本

vcn-52cae988 当前推荐

完成中文演示提示适配，修复运行截图语义重复问题，并通过生产构建与 SDK 测试。

部署要求：Node.js 20+；生产环境需配置微信公众号与 Turso。

已知问题：真实微信扫码回调需要用户自行配置公众号；演示结果不代表已连接真实微信服务。

登录后领取