微信扫码登录

本文档用于指导在 PIGX v5.11 及其以后版本中接入微信扫码登录(微信开放平台网页应用),并支持账号绑定微信后直接扫码登录的使用流程。

前置条件

  • PIGX 版本:v5.11 及以上
  • 已部署可公网访问的域名(用于微信回调)
  • 已开通微信开放平台,并创建网页应用

微信开放平台配置

创建网页应用

  1. 进入微信开放平台:https://open.weixin.qq.com/
  2. 创建应用:选择网页应用
  3. 获取并保存以下信息:
    • AppID
    • AppSecret
微信开放平台创建网页应用

配置授权回调域名

在网页应用配置中,按微信要求填写授权回调域名(你的站点域名,不带协议、不带路径)。

域名配置要求

授权回调域名必须是已备案的域名,且不能包含协议(http/https)和路径

PIGX-UI 维护微信登录参数

新增密钥配置

在 PIGX-UI 中维护微信登录所需参数(通常在系统配置/密钥管理菜单):

  • AppID
  • AppSecret
  • Redirect URI(通常为 http://域名/#/authredirect
回调地址格式
PIGX 微信登录参数配置

微信扫码登录使用说明

PIGX 的微信扫码登录采用账号先登录后绑定的方式,避免出现扫码后不知道绑定到哪个账号的问题。

绑定流程

  1. 用户先使用账号密码正常登录系统
  2. 登录后进入右上角个人中心
  3. 选择绑定微信
  4. 使用微信扫码确认授权
  5. 绑定完成后,系统会将当前账号与微信 OpenID / UnionID 建立关联
微信扫码绑定入口
绑定建议

建议用户在首次登录后立即完成微信绑定,后续可直接使用微信扫码登录,提升使用体验