XIUNOX 社区 OAuth2.0 v1.1.0 插件：统一第三方登录的新选择

本文共计1525个字，预计阅读时长6.1分钟。

本文基于 XIUNOX 社区发布于 2026 年 7 月 25 日的插件介绍帖（作者：贰先生）整理而成，内容仅使用原文可确认的事实，未加入任何推测或虚构。

一句话简介

xnx_oauth 是一款为 XIUNOX 系统设计的 OAuth2.0 社交登录插件，支持 QQ、GitHub、Google 等多个第三方平台，提供完整的授权码流程与安全校验，并可被其他插件扩展自定义 provider。

核心功能

• 多平台支持：内置 QQ、GitHub、Google 模板，并允许通过后台 KV 配置或插件静态注册（OAuthService::registerProvider()）添加自定义 provider。
• 完整 OAuth2.0 授权码流程：包括 state 参数防 CSRF、PKCE（S256）支持、SSL 证书校验。
• 灵活的登录/绑定逻辑：四种分支——已绑定直接登录、已登录则绑定、邮箱匹配自动合并、其他拒绝并引导注册。
• 头像自动下载：从第三方获取头像并保存到本地 upload/avatar/{dir}/{uid}.png，仅当用户无自定义头像时执行。
• 多语言：内置简体中文、繁体中文、英文三种语言包。
• 管理功能：后台可查看绑定记录（筛选、分页、强制解绑），个人中心提供绑定/解绑管理页。
• 字段映射：支持嵌套字段（如 a.b），适配各平台 userinfo 响应的差异。

配置与使用

1. 在后台「插件管理」启用 xnx_oauth。
2. 进入「插件设置」→「配置」，开启「启用 OAuth 登录」。
3. 选择要接入的平台（QQ / GitHub / Google 或自定义），填写 AppID、AppSecret，以及授权、Token、UserInfo 三个 URL，配置 scope 和字段映射。
4. 如需 PKCE（如 Google），勾选 enable_pkce。
5. 若希望邮箱匹配后自动合并已有账号，开启 automergeby_email。
6. 测试：退出登录 → 访问登录页 → 点击第三方登录 → 完成授权 → 跳转个人中心或触发绑定/解绑。

扩展性

插件通过 hook/modelincfile.php 自动加载核心服务类 OAuthService。其他插件可在自身的 modelincfile.php 或 hook 中调用 OAuthService::registerProvider($config) 注册自定义 provider，配置与内置 provider 结构一致。同名 provider 后注册会覆盖先注册，并记录 xn_log 警告。

数据表与安全性

• 数据表 xnxoauthbind 的字段包含 provider+openid 唯一索引、provider+unionid 普通索引，便于跨平台身份查询。
• handleCallback() 内部依次执行 state 校验、PKCE 校验、token 换取、用户信息获取（QQ 等平台额外调用 preuserinfourl 获取 openid）、字段映射、登录或绑定。

背景与影响

在网站开发中，统一第三方登录能显著降低用户注册门槛，同时提高账户安全性。该插件遵循 OAuth2.0 标准，并引入 PKCE 等现代安全措施，适合需要多平台社交登录的 XIUNOX 站点。通过开放 registerProvider() 接口，社区开发者可以轻松扩展更多登录渠道，形成一个可复用的生态组件。

以上内容由 AI 根据公开素材整理，所有事实均源自原文。如需详细操作，请访问原文链接查看完整示例。

>

原文：XIUNOX社区 - 【XIUNOX插件】OAuth2.0 v1.1.0

参考来源：XIUNOX 社区

本文由 AI 辅助整理，请以原始来源为准。