ubuntu下安装keycloak-9.0.2

一、System Requirements：

1. Java 8 JDK
2. 512M RAM
3. 1G diskspace
4. database：mysql、postgresql、oracle、etc

二、下载与安装

1.下载keycloak的安装包

安装包名称为 keycloak-9.0.2.tar.gz

2.下载mysql-connect的jar包

第一步，查看mysql的版本，根据版本挑选所对应的jar包
mysql-connector-java与mysql版本对应列表

第二步，下载所对应的版本
我的mysql版本是5.5对应mysql-connector-java-5.1版本

3.安装

a. 上传安装包到linux的/usr/local/目录下

 解压 tar -zxvf keycloak-9.0.2.tar.gz

b. 修改文件夹名称

mv keycloak-9.0.2 keycloak

c. keycloak数据库的相关操作

创建keycloak数据库

mysql -uroot -p

create database keycloak；建议起这个名字

将上述下载的mysql-connector-java-5.1.44.jar放置到/usr/local/keycloak/modules/system/layers/base/com/mysql/main/目录下（如果该目录不存在，自行创建）

mv mysql-connector-java-5.1.44.jar /usr/local/keycloak/modules/system/layers/base/com/mysql/main/

创建mysql的module.xml内容

cat module.xml




    
        
    
    
        
        
        
    

d.修改keycloak配置文件standalone.xml

文件目录为
/usr/lcoal/keycloak/standalone/configuration/

修改内容为：

数据源

          
          jdbc:mysql://xxx.xxx.xxx.xxx:3306/keycloak?autoReconnect=true&useUnicode=true&createDatabaseIfNotExist=true&characterEncoding=UTF-8
          mysql
          
           20
          
          
                root
                admin
         
 

驱动

    com.mysql.jdbc.jdbc2.optional.MysqlXADataSource

设置所有ip可以访问

e.创建keycloak默认登录用户

cd /usr/local/keycloak/bin

sh add-user-keycloak.sh -r master -u admin -p admin

其中第一个admin是用户名，第二个admin是密码   用户名和密码随意设置，自己记住就行

f.运行keycloak
进入bin目录，运行命令

sh bin/standalone.sh -Djboss.socket.binding.port-offset=10

// 如果直接sh bin/standalone.sh  则使用默认端口8080，如果运行上面的端口就是8090

参数介绍：
-Djboss.socket.binding.port-offset=10  将端口8080往后移动10，则端口就是8090
-Djboss.http.port=8090  直接指定端口为8090

停止

上面这种启动后，命令行仍在前台，使用Ctrl+c强制结束进程，即可停止Keycloak

后台启动：

使用“nohup”和“&”，以后台进程的方式启动，即“nohup”+空格+要执行的命令+空格+“&”，如下：

hub  ./bin/standalone.sh -Djboss.socket.binding.port-offset=10 &

停止：
找到进程，kill掉即可

ps -ef | grep keycloak
kill -9 进程号

g.登录页面
浏览器访问： ip:port/auth
例如： xxx.xxx.xxx.xxx:8090/auth

安装遇到的问题：
1.出现mysql连接的错误，
原因是：没有设置mysql远程ip连接的权限，记得添加