快速上手

1 服务端jar获取

在该项目的github主页/server/target目录下可以下载MatrixAuthServer的最新jar包,名称为MatrixAuthServer-x.x.x.jar

将该包下载到本地。

2 服务端启动

然后在下载得到的MatrixAuthServer-x.x.x.jar本地的同级目录下使用下面的命令启动MatrixAuthServer。

java -jar MatrixAuthServer-x.x.x.jar dynamicDataSource.default.url=jdbc:mysql://localhost:3306/matrixauth?useUnicode=true&characterEncoding=UTF-8&serverTimezone=GMT%2B8 dynamicDataSource.default.username=root dynamicDataSource.default.password=yeecode

以上上命令中存在以下必须的配置项:

  • MatrixAuthServer-x.x.x.jar:这里要设置你所下载的版本的jar包。
  • dynamicDataSource.default.url:MatrixAuthServer的默认数据源地址信息。
  • dynamicDataSource.default.username:MatrixAuthServer的默认数据源用户名。
  • dynamicDataSource.default.password:MatrixAuthServer的默认数据源密码。

还有一些配置项可以根据实际情况选填,它们有:

  • matrixauth.server.adminToken:在这里设置系统管理员Token,即adminToken。如果设置了该项,则在调用MatrixAuthServer的系统管理员接口时必须携带该字段以验证系统管理员身份。
  • server.port:MatrixAuth工作的端口。如果不设置,则采用默认值12301
  • dynamicDataSource.default.driverClassName:MatrixAuthServer的默认数据源的驱动类型,如果不设置将采用默认值com.mysql.cj.jdbc.Driver

看到下图所示的启动界面后,表示MatrixAuthServer启动成功。


MatrixAuth——高性能轻量级分布式权限系统