介绍

为了你更好的使用MaxKey，本教程介绍在Windows中如何快速配置和使用MaxKey，在开始本文档前，请先下载MaxKey并解压到C:盘。

配置

hosts配置文件目录

C:\Windows\System32\drivers\etc

新增如下内容

127.0.0.1  sso.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

应用服务启动

1)启动数据库

start_maxkey_db.bat

2)启动认证服务

start_maxkey.bat

3)启动管理服务

start_maxkey_mgt.bat

4)启动样例及WIKI

start_maxkey_wiki.bat

访问

打开浏览器，访问以下地址

目录结构

LINUX 7 版本

1 OracleJDK 17 安装

1.1 下载地址 https://www.oracle.com/java/technologies/downloads/#JDK17

Java SE Development Kit 17

x64 RPM Package

	
wget --no-check-certificate --no-cookies wget https://download.oracle.com/java/17/latest/jdk-17_linux-x64_bin.rpm

1.2 解压缩及安装

rpm -Uvh jdk-17_linux-x64_bin.rpm

2.1 安装MySQL 8.0

2.1.1 安装MySQL官方的yum repository

wget -i -c https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm
 

2.1.2 下载rpm包：

yum -y install mysql80-community-release-el7-3.noarch.rpm
 

2.1.3 安装MySQL服务

yum -y install mysql-community-server
 

2.2 调整配置

编辑 /etc/my.cnf 文件

character-set-server=utf8
lower_case_table_names=1

2.3. 启动mysql服务

> systemctl start mysqld


停止

systemctl stop mysqld  --无需执行

2.4 登录MySQL

第一次启动MySQL后，就会有临时密码，这个默认的初始密码在/var/log/mysqld.log文件中，我们可以用这个命令来查看：

 grep "password" /var/log/mysqld.log
 

2.5 设置访问权限及密码

mysql -u root -p;

输入密码

set global validate_password.policy=0; --改变密码等级

set global validate_password.length=4; --改变密码最小长度

SET PASSWORD = 'maxkey';

use mysql;

alter user 'root'@'localhost' identified with mysql_native_password by 'maxkey';

flush privileges ;

---修改root用户的访问权限为‘%’

update user set host='%' where user='root';

flush privileges ;

2.7. 设置开机启动

chkconfig --add mysqld
chkconfig mysqld on

查看开机启动设置是否成功

 chkconfig --list | grep mysql*
 
 # mysqld 0:关闭 1:关闭 2:启用 3:启用 4:启用 5:启用 6:关闭停止

3 MaxKey安装

3.1 把MaxKey上传到Linux服务器

3.2 数据导入

MaxKey对应的版本SQL文件，参见

https://gitee.com/dromara/MaxKey/tree/master/sql

登陆LINUX MYSQL并创建schema maxkey，字符集utf8,数据文件导入到maxkey schema中，

mysql -u root -p;

输入密码

CREATE DATABASE  IF NOT EXISTS `maxkey` /*!40100 DEFAULT CHARACTER SET utf8 */ /*!80016 DEFAULT ENCRYPTION='N' */;

USE `maxkey`;

-- 使用source命令，后面参数为脚本文件(如这里用到的.sql),其中v2.9.0是对应的版本号

source your sql path/maxkey_v3.0.0.GA.sql;

source your sql path/maxkey_v3.0.0.GA_data.sql

3.3 启动 修改set_maxkey_env.sh以下参数

JAVA_HOME=/usr/java/jdk-17

export JAVA_HOME=/usr/java/jdk-17

  ./start_maxkey_db.sh & #自行编写
  
  ./start_maxkey.sh &
  
  ./start_maxkey_mgt.sh &
  
  ./start_maxkey_wiki.sh &

Docker快速部署

LINUX 7 基于Docker快速部署

1、创建MySQL数据文件和日志文件目录

mkdir /root/mysql/data

mkdir /root/mysql/logs

2、把 https://gitee.com/dromara/MaxKey/tree/master/docker 或者https://github.com/dromara/MaxKey/tree/master/docker目录上传到/root目录下

3、启动MySQL服务

docker pull mysql:8.0.27

docker 	run -p 3306:3306  \
-v /root/mysql/data:/var/lib/mysql \
-v /root/mysql/logs:/var/log/mysql \
-v /root/docker-mysql:/etc/mysql/conf.d \
-v /root/docker-mysql/sql:/docker-entrypoint-initdb.d \
--name mysql \
-e MYSQL_ROOT_PASSWORD=maxkey \
-d mysql:8.0.27

4、启动MaxKey服务

docker pull maxkeytop/maxkey:latest

docker 	run -p 443:443  \
-e DATABASE_HOST=192.168.0.102 \
-e DATABASE_PORT=3306 \
-e DATABASE_NAME=maxkey \
-e DATABASE_USER=root \
-e DATABASE_PWD=maxkey \
--name maxkey \
-d maxkeytop/maxkey:latest

5、启动MaxKey管理服务

maxkeytop/maxkey-mgt:latest

docker 	run -p 9527:9527  \
-e DATABASE_HOST=192.168.0.102 \
-e DATABASE_PORT=3306 \
-e DATABASE_NAME=maxkey \
-e DATABASE_USER=root \
-e DATABASE_PWD=maxkey \
--name maxkey-mgt \
-d maxkeytop/maxkey-mgt:latest

Docker Compose快速部署

LINUX 7 基于Docker Compose快速部署

1、创建MySQL数据文件和日志文件目录

mkdir /root/mysql/data

mkdir /root/mysql/logs

2、启动MaxKey服务

docker-compose up --build -d