适用场景:
- 当你使用rust开发web应用时,使用本项目二次开发可以减少重复工作量。
- 当你需要一个包含oauth的轻量级开放平台服务时,可基于本项目快速实现鉴权,应用管理等.
- 当进行分模块独立开发(如:公司内分团队的各自独立开发)时,可用本项目作为一个内部应用管理中心。
- 当你希望把一些常用服务(如:发送短信,邮件 等)抽离出来公用时,可用本项目实现.
在线示例: https://lsys.site/ [账号:aaaaa 密码:000000]
- 执行编译
编译生成文件在
./build
中,并同时可生成./build
目录的压缩包
仅拷贝生成的
./build
到你的服务器即可,其他文件可以删除.
Windows(64bit)系统下可以下载 lsys-for-windows.zip 跳过此编译过程
windows
.\build.cmd zip assets
#zip :可选,生成 lsys-for-windows.zip
#assets :可选,从github下载对应资源
linux or macos
bash ./build.sh tar assets
#zip :可选,生成 lsys.tar.gz
#assets :可选,从github下载对应资源
- 导入SQL到数据库
mysql -u your_username -p your_database < ./build/assets/tables.sql #导入到你的MYSQL
- 修改项目配置
修改服务器配置。
./build/.env # 配置文件
修改UI访问后台服务地址
./build/ui/config.js # ui 使用内置HTTP服务无需修改,自行部署(如nginx)时指定,示例: "serverURL": "//lsys.site/"
- 启动服务
源码编译时,可在 https://github.com/shanliu/lsys/releases/tag/v0.0.0 下载项目使用的资源文件,下载后放置于
build/data
中。
执行
./actix-web-dome
启动服务。注意:初次启动会慢一些。
可使用
nohup ./actix-web-dome &
后台执行
根据
.env
配置访问服务.默认地址:http://127.0.0.1:8080/
sequenceDiagram
par 管理ui实现
前端->>lsys服务: 前端请求到 lsys-actix-web[actix-web] 服务
lsys服务-->>前端: 返回结果
end
par 自行开发RUST内部应用实现
前端->>lsys服务: 前端请求到 lsys-actix-web[actix-web] 服务
lsys服务->>内部rust实现: 由 actix-web 进行接入,可换其他支持tokio运行时框架
内部rust实现->>内部rust实现: 实现你的业务逻辑,示例应用[lsys-web-subapp-dome]
内部rust实现-->>lsys服务: 可以库调用访问lsys服务[lsys-rbac,lsys-user等]
lsys服务-->>前端: 返回结果
end
sequenceDiagram
par 普通应用实现[接入层处理业务逻辑]
前端->>外部应用接入层: 自行选择语言,实现方式等
外部应用接入层->>lsys服务: 通过以上协议 访问lsys提供的服务来实现部分你需要的功能
lsys服务-->>外部应用接入层: 处理结果返回到外部应用
外部应用接入层-->>前端: 返回结果
end
par 拆分接入层跟服务层的实现[服务层处理业务逻辑]
前端->>外部应用接入层: 自行选择语言,实现方式等
外部应用接入层->>外部应用服务层:自行选择语言,内部访问协议等,最好接入层 APPID 并传入
外部应用服务层->>lsys服务: 根据接入层传入的APPID,查询对应的APP信息
lsys服务-->>外部应用服务层: 可根据查询到的 APP信息
外部应用服务层->>外部应用服务层: 根据查询app信息及接入层传入APPID及其他参数 进行签名校验
外部应用服务层->>外部应用服务层: 校验请求通过后,继续完成内部服务层业务逻辑
外部应用服务层-->>外部应用接入层: 自行实现协议返回数据到接入层
外部应用接入层-->>前端: 返回结果
end