Swagger在Linux环境下如何配置_html5

swagger在linux环境下如何配置

本文介绍如何在linux环境下配置swagger，主要涵盖swagger ui和swagger editor的安装与配置。

一、使用docker容器部署 (推荐)

此方法简化了安装过程，避免了依赖管理的复杂性。

安装docker: 若未安装docker，请执行以下命令：

sudo apt-get update
sudo apt-get install -y docker.io
sudo systemctl start docker
sudo systemctl enable docker

登录后复制

拉取镜像: 分别拉取swagger ui和swagger editor镜像：
```
docker pull swaggerapi/swagger-ui:latest
docker pull swaggerapi/swagger-editor:latest
```
登录后复制
(使用 latest 标签获取最新版本)
运行容器: 运行swagger ui和swagger editor容器，并映射端口：
```
docker run -d -p 8080:8080 swaggerapi/swagger-ui:latest
docker run -d -p 8081:8080 swaggerapi/swagger-editor:latest
```
登录后复制
访问 http://:8080 查看swagger ui，访问 http://:8081 查看swagger editor。

二、使用npm安装 (适用于需要更精细控制的情况)

此方法需要预先安装node.js和npm。

安装node.js和npm: 使用以下命令安装：

curl -sl https://deb.nodesource.com/setup_16.x | sudo -e bash -  # 使用16.x版本或其他稳定版本
sudo apt-get install -y nodejs

登录后复制

安装依赖: 安装express和http-server:
```
npm install -g express http-server
```
登录后复制

安装swagger ui:

git clone https://github.com/swagger-api/swagger-ui.git
cd swagger-ui
npm install
http-server -p 8080

登录后复制

安装swagger editor:
```
git clone https://github.com/swagger-api/swagger-editor.git
cd swagger-editor
npm install
http-server -p 8081
```
登录后复制
同样，访问 http://:8080 查看swagger ui，访问 http://:8081 查看swagger editor。

三、 spring boot集成swagger (适用于spring boot项目)

对于spring boot项目，推荐使用springdoc openapi来集成swagger。

添加依赖: 在 pom.xml 文件中添加依赖：

<dependency>
    <groupid>org.springdoc</groupid>
    <artifactid>springdoc-openapi-starter-webmvc-ui</artifactid>
    <version>2.1.0</version> </dependency>

登录后复制

配置swagger (可选): 可以创建一个配置类来自定义swagger文档信息：

import org.springdoc.core.models.groupedopenapi;
import org.springframework.context.annotation.bean;
import org.springframework.context.annotation.configuration;

@configuration
public class swaggerconfig {
    @bean
    public groupedopenapi publicapi() {
        return groupedopenapi.builder()
                .group("public")
                .pathstomatch("/public/**")
                .build();
    }
}

登录后复制

启动应用: 启动你的spring boot应用，访问 http://:8080/swagger-ui/index.html 查看swagger文档 (端口可能因应用配置而异)。

通过以上方法，您可以在linux环境下轻松配置swagger，方便api文档的管理和测试。记住替换为你的实际服务器ip地址。

以上就是swagger在linux环境下如何配置的详细内容，更多请关注代码网其它相关文章！

ao3官网怎么进入 ao3官网最新进入方式

随着互联网的快速发展，网民对新内容的需求日益增长。ao3（archive of our own）作为全球最大的同人小说开放式创作平台，因其丰富的作品资源和开放宽... [阅读全文]

ao3官网最新进入方式

文章指出因无法访问外部网站，无法提供 ao3 最新进入方式具体信息。其官网常见进入方式有直接输官方网址、用 tor 浏览器访问（可能降速）、借助专用网络服务。若... [阅读全文]

Linux CPUInfo怎样查看PCIe通道

本文介绍如何在linux系统中查看pcie通道信息，主要利用lspci、lshw和ethtool三个命令行工具。方法一：使用lspci命令lspci命令是查看p... [阅读全文]

内网环境下，如何不修改浏览器设置，让网站项目通过HTTP协议调用高拍仪？

内网环境下网站项目如何通过http协议调用高拍仪？内网网站项目需要在现代浏览器（非ie）的http环境下读取高拍仪画面，而navigator.mediadevi... [阅读全文]

与初学者了解JavaScript

javascript：网络编程语言入门指南javascript，通常缩写为js，是当今最流行的编程语言之一，也是网络开发的核心技术，与html和css并驾齐驱。... [阅读全文]

Express服务器报错“连接丢失：服务器关闭了连接”如何解决？

express服务器报错：“连接丢失：服务器关闭了连接”的排查与解决在使用express.js框架搭建服务器时，可能会遇到“连接丢失：服务器关闭了连接”的错误。... [阅读全文]


验证码：

验证码：

Swagger在Linux环境下如何配置

2025年03月30日 • html5 •我要评论

相关文章:

发表评论