主页传送门 ： 📀 传送

---

概述

---

MaxKey单点登录认证系统，谐音为马克思的钥匙寓意是最大钥匙，是业界领先的IAM-IDaas身份管理和认证产品；支持OAuth 2.x/OpenID Connect、SAML 2.0、JWT、CAS、SCIM等标准协议；提供安全、标准和开放的用户身份管理(IDM)、身份认证(AM)、单点登录(SSO)、资源管理和权限管理等。

开发环境准备

---

官网上虽然是这么写的 但是根据实测，最新版的v4.0.2中 node版本最好用node20以上的版本，要不可能会遇到各种比较诡异的情况。。

从https://github.com/dromara/MaxKey或者https://github.com/dromara/MaxKey 下载下来代码

配置mysql环境 推荐Windows下载解压缩版本8.0.3以上 具体配置很简单 网上随便一搜就能找到，这里就不再赘述了。

配置jdk环境 需要注意jdk版本得是17以上。

配置gradle 因为项目是基于gradle构建的 所以需要配置gradle Gradle 推荐8.0以上。 不知道如何配置的阔以参考这篇，里边写的还是挺详细的，按照操作配置就好了。https://blog.csdn.net/qq_57756904/article/details/131565569

配置hosts

hosts配置文件目录

C:\Windows\System32\drivers\etc\hosts

这里比较怪的是 我的电脑没有找到hosts文件 查看隐藏文件夹也没有
所以直接用命令复制一个出来

for /f %P in ('dir %windir%\WinSxS\hosts /b /s') do copy %P %windir%\System32\drivers\etc & echo %P & Notepad %P

自动打出hosts文件并且命令行出现“已复制 1 个文件”。再次刷新，应该就会出来了

在hosts 文件新增下面内容

127.0.0.1  sso.maxkey.top
127.0.0.1  mgt.maxkey.top
127.0.0.1  tokenbased.demo.maxkey.top
127.0.0.1  cas.demo.maxkey.top
127.0.0.1  oauth.demo.maxkey.top

至此，环境准备就基本OK了。
接下来就是构建项目启动项目了。
需要注意的是
使用Spring boot 基于gradle构建需用

release_cnf_jar.bat

构建配置

在构建之前需要先配置jdk和gradle的环境变量

setEnvVars.bat
set JAVA_HOME=jdk安装位置\jdk
set GRADLE_HOME=gradle安装位置\gradle-8.0.2

修改数据库连接 把application-maxkey.properties 和application-maxkey-mgt.properties
的账号密码还有连接地址替换为自己的。

接下来按着文档要求一步步构建就可以了。

构建完之后出现

这四项就证明构建成功了
接下来启动MaxKeyApplication 和 MaxKeyMgtApplication后端就启动起来了。

启动这俩项的时候可能会报太长无法启动按照上图选择Shorten command line:为 JAR manifest 再重新启动即可。

maxkey官网文档：
maxkey文档