Orion-API-Manager搭建遇坑记录

不好意思安装一切顺利暂时没有遇到什么坑，如果观看的你有可以下面评论区留下一起讨论

Orion-API-Manager是一个API文档管理器，为后端开发人员提供API管理，也为前端人员提供友好容易查看与测试的UI; 系统集成了权限适合在一个机构中不同的团队使用，支持导入或显示OpenAPI (Swagger)等接口文档…

开源官方提供的教程，也可以去看看：链接
还有更多的好项目欢迎去访问，@。@这算不算引流呢，噗。。。
更多

启动方式

列表项项目你可以通过Releases(发行版)中下载最新已经打包的项目或者clone代码后执行mvn clean package进行打包,打包完毕后软件在target/Orion文件夹
项目的开发环境为java 1.8.0_121,理论上java1.8以上都可以运行
在Orion目录中执行java -jar Orion-API-Manager.jar 或运行start.bat(windows)start.sh(unix)启动OrionAM服务,端口号默认为8686
启动OrionAM服务后在浏览器访问http://服务地址:端口号 便可以进行API的管理,登录账号与密码参考下方用户与角色权限

用户与角色权限

OrionAM有3中身份角色:
root=超级管理员(管理所有项目)
server=普通管理员(管理自己的项目)
client=普通用户(查看自己加入的项目)
root用户需要在./config/user.json中定义,server与client用户在管理端的用户管理中创建;
用户管理中的标签相当于用户分组,项目中可以指定允许访问的分组(标签)
默认只有一个超级管理员用户,登录账号为X-root,登录密码为helloOAM

正确的做法应该使用超级管理员账号登录后,创建管理员用户(注:超级管理员可以创建管理员用户,管理员用户只能创建普通用户),再禁用超级管理员或修改超级管理员账号密码;

开始

安装java环境

不会安装java环境可以去看看这篇文章:链接

我这里安装了JDK，保证不会有所缺失

下载页面: 链接

root@hyo:~# java -version
java version "1.8.0_291"
Java(TM) SE Runtime Environment (build 1.8.0_291-b10)
Java HotSpot(TM) 64-Bit Server VM (build 25.291-b10, mixed mode)

安装mvn环境

下载mvn包: 链接
压缩包安装方法和java一样

root@hyo:~# mvn -version
Apache Maven 3.8.4 (9b656c72d54e5bacbed989b64718c159fe39b537)
Maven home: /usr/local/apache-maven-3.8.4
Java version: 1.8.0_291, vendor: Oracle Corporation, runtime: /usr/local/jdk1.8.0_291/jre
Default locale: zh_CN, platform encoding: UTF-8
OS name: "linux", version: "4.19.0-18-amd64", arch: "amd64", family: "unix"
#这里不要像我一样直接在root下，我这里是虚拟机，毕竟root权限不低啊
root@hyo:~# cd Orion-API-Manager_1.0.0.GA/
root@hyo:~/Orion-API-Manager_1.0.0.GA# mvn clean package

这里可以直接下载发行版，就不需要用mvn打包了
打包完毕后软件在target/Orion文件夹

运行服务

root@hyo:~/Orion-API-Manager_1.0.0.GA# java -jar Orion-API-Manager.jar 

  .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/
 :: Spring Boot ::        (v2.3.3.RELEASE)

访问ip:8686即可
默认超级管理员用户,登录账号为X-root,登录密码为helloOAM，记得修改账号密码哦

这里是官方使用视频

嘿哟博客