117.info
人生若只如初见

如何利用Swagger在Linux上实现API文档共享

在Linux上利用Swagger实现API文档共享,可以按照以下步骤进行:

1. 安装Node.js和npm

首先,需要在Linux服务器上安装Node.js和npm。可以从Node.js官网下载适合Linux的安装包,然后使用以下命令进行安装:

cd /opt
wget https://nodejs.org/dist/v14.17.0/node-v14.17.0-linux-x64.tar.xz
tar -xvf node-v14.17.0-linux-x64.tar.xz
sudo mv node-v14.17.0-linux-x64 /usr/local/nodejs
export PATH=$PATH:/usr/local/nodejs/bin

验证安装:

node -v
npm -v

2. 安装Swagger Editor

接下来,安装Swagger Editor。可以通过以下命令下载并解压:

cd /opt
wget https://github.com/swagger-api/swagger-editor/archive/refs/tags/v3.16.1.tar.gz
tar -xvf v3.16.1.tar.gz
sudo rm v3.16.1.tar.gz

进入解压后的目录并启动Swagger Editor:

cd swagger-editor-3.16.1
npm install
nohup http-server -p 8080 &

访问http://your-server-ip:8080即可使用Swagger Editor。

3. 安装Swagger UI

安装Swagger UI的步骤如下:

cd /opt
wget https://github.com/swagger-api/swagger-ui/archive/refs/tags/v3.48.0.tar.gz
tar -xvf v3.48.0.tar.gz
sudo rm v3.48.0.tar.gz

初始化npm项目并安装Express:

cd swagger-ui-3.48.0
npm init -y
npm install express --save

编辑index.js文件,配置静态文件服务:

var express = require('express');
var app = express();
app.use('/swagger', express.static('public'));
app.get('/', function (req, res) { res.send('Hello World!'); });
app.listen(3000, function () { console.log('Example app listening on port 3000!'); });

将Swagger UI的dist目录下的文件复制到public文件夹中,然后启动服务器:

cd public
nohup node ../index.js &

访问http://your-server-ip:3000/swagger即可查看Swagger UI文档。

4. 集成Spring Boot项目(可选)

如果使用Spring Boot项目,可以使用springdoc来生成API文档。首先,在pom.xml中添加依赖:


    org.springdoc
    springdoc-openapi-starter-webmvc-ui
    2.1.0

然后,配置application.properties文件:

springdoc.api-docs.path=/api-docs
springdoc.swagger-ui.path=/swagger-ui

启动Spring Boot应用后,访问http://your-server-ip:8080/swagger-ui即可查看生成的API文档。

通过以上步骤,可以在Linux上成功搭建Swagger环境,实现API文档的共享和管理。

未经允许不得转载 » 本文链接:https://www.117.info/ask/feef4AzsKBQFXBV0.html

推荐文章

  • Linux中Kafka如何保障数据安全

    在Linux中,Kafka通过一系列机制来保障数据安全,主要包括以下几个方面: 加密传输:使用SSL/TLS协议对数据进行传输加密,确保数据在传输过程中不被截获和篡改。...

  • Linux环境下如何监控MinIO

    在Linux环境下监控MinIO,可以使用以下几种方法:
    使用MinIO自带的监控工具
    MinIO提供了一个丰富的运维工具和仪表板,便于用户进行集群配置、监控和维...

  • 如何利用top命令查看进程

    top命令是Linux系统中用于实时监控系统进程状态的工具。通过top命令,你可以查看当前系统中各个进程的资源占用情况,如CPU、内存等。以下是如何使用top命令查看进...

  • nohup命令日志中错误代码含义

    nohup 命令用于在后台运行程序,即使用户退出登录,程序也会继续运行。nohup 命令会将程序的输出重定向到一个名为 nohup.out 的文件中,除非指定了其他输出文件。...

  • Linux环境中Swagger与Docker如何协同工作

    在Linux环境中,Swagger与Docker可以协同工作,以简化API文档的生成和部署过程。以下是它们协同工作的基本步骤: 编写Dockerfile:首先,为Swagger UI应用程序编...

  • 如何通过Swagger在Linux上进行API监控

    在Linux上通过Swagger进行API监控,通常涉及以下几个步骤:安装Swagger UI和Swagger Editor,配置Swagger以连接到你的API,以及使用Swagger UI来查看和测试API文...

  • Linux下Swagger如何实现版本控制

    在Linux下,为Swagger实现版本控制可以通过以下步骤进行: 安装Swagger:首先,确保你已经在Linux系统上安装了Swagger。如果还没有安装,可以参考Swagger官方文档...

  • 在Linux系统中Swagger UI如何自定义主题

    在Linux系统中自定义Swagger UI主题可以通过以下几种方法实现:
    使用Swagger UI的默认主题
    Swagger UI本身提供了一些内置的主题,用户可以通过修改配置...