Swagger在Linux环境下如何配置

本文介绍如何在Linux环境下配置Swagger，主要涵盖Swagger UI和Swagger Editor的安装与配置。

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

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

1. 安装Docker: 若未安装Docker，请执行以下命令：

   <code class="bash">sudo apt-get update
   sudo apt-get install -y docker.io
   sudo systemctl start docker
   sudo systemctl enable docker</code>

   登录后复制

2. 拉取镜像: 分别拉取Swagger UI和Swagger Editor镜像：

   <code class="bash">docker pull swaggerapi/swagger-ui:latest
   docker pull swaggerapi/swagger-editor:latest</code>

   登录后复制

   (使用 latest 标签获取最新版本)

3. 运行容器: 运行Swagger UI和Swagger Editor容器，并映射端口：

   <code class="bash">docker run -d -p 8080:8080 swaggerapi/swagger-ui:latest
   docker run -d -p 8081:8080 swaggerapi/swagger-editor:latest</code>

   登录后复制

   访问 http://<你的服务器IP>:8080 查看Swagger UI，访问 http://<你的服务器IP>:8081 查看Swagger Editor。

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

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

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

   

   冬瓜配音

   AI在线配音生成器

   66

   查看详情

   <code class="bash">curl -sL https://deb.nodesource.com/setup_16.x | sudo -E bash -  # 使用16.x版本或其他稳定版本
   sudo apt-get install -y nodejs</code>

   登录后复制

2. 安装依赖: 安装Express和http-server:

   <code class="bash">npm install -g express http-server</code>

   登录后复制

3. 安装Swagger UI:

   <code class="bash">git clone https://github.com/swagger-api/swagger-ui.git
   cd swagger-ui
   npm install
   http-server -p 8080</code>

   登录后复制

4. 安装Swagger Editor:

   <code class="bash">git clone https://github.com/swagger-api/swagger-editor.git
   cd swagger-editor
   npm install
   http-server -p 8081</code>

   登录后复制

   同样，访问 http://<你的服务器IP>:8080 查看Swagger UI，访问 http://<你的服务器IP>:8081 查看Swagger Editor。

三、 Spring Boot集成Swagger (适用于Spring Boot项目)

对于Spring Boot项目，推荐使用Springdoc OpenAPI来集成Swagger。

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

   <code class="xml"><dependency>
       <groupId>org.springdoc</groupId>
       <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
       <version>2.1.0</version> </dependency></code>

   登录后复制

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

   <code class="java">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();
       }
   }</code>

   登录后复制

3. 启动应用: 启动你的Spring Boot应用，访问 http://<你的服务器IP>:8080/swagger-ui/index.html 查看Swagger文档 (端口可能因应用配置而异)。

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

以上就是Swagger在Linux环境下如何配置的详细内容，更多请关注php中文网其它相关文章！