本文介紹如何在Linux環(huán)境下配置Swagger，主要涵蓋Swagger ui和Swagger Editor的安裝與配置。

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

此方法簡(jiǎn)化了安裝過(guò)程，避免了依賴管理的復(fù)雜性。

1. 安裝Docker: 若未安裝Docker，請(qǐng)執(zhí)行以下命令：

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

2. 拉取鏡像: 分別拉取Swagger UI和Swagger Editor鏡像：

   docker pull swaggerapi/swagger-ui:latest docker pull swaggerapi/swagger-editor:latest

   (使用 latest 標(biāo)簽獲取最新版本)

3. 運(yùn)行容器: 運(yùn)行Swagger UI和Swagger Editor容器，并映射端口：

   docker run -d -p 8080:8080 swaggerapi/swagger-ui:latest docker run -d -p 8081:8080 swaggerapi/swagger-editor:latest

   訪問(wèn) http://:8080 查看Swagger UI，訪問(wèn) http://:8081 查看Swagger Editor。

二、 使用npm安裝 (適用于需要更精細(xì)控制的情況)

此方法需要預(yù)先安裝Node.JS和npm。

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

   curl -sL https://deb.nodesource.com/setup_16.x | sudo -E bash -  # 使用16.x版本或其他穩(wěn)定版本 sudo apt-get install -y nodejs

2. 安裝依賴: 安裝express和http-server:

   npm install -g express http-server

3. 安裝Swagger UI:

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

4. 安裝Swagger Editor:

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

   同樣，訪問(wèn) http://:8080 查看Swagger UI，訪問(wèn) http://:8081 查看Swagger Editor。

三、 spring Boot集成Swagger (適用于spring boot項(xiàng)目)

對(duì)于Spring Boot項(xiàng)目，推薦使用Springdoc OpenAPI來(lái)集成Swagger。

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

   <dependency>     <groupId>org.springdoc</groupId>     <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>     <version>2.1.0</version> </dependency>

2. 配置Swagger (可選): 可以創(chuàng)建一個(gè)配置類來(lái)自定義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();     } }

3. 啟動(dòng)應(yīng)用: 啟動(dòng)你的Spring Boot應(yīng)用，訪問(wèn) http://:8080/swagger-ui/index.html 查看Swagger文檔 (端口可能因應(yīng)用配置而異)。

通過(guò)以上方法，您可以在Linux環(huán)境下輕松配置Swagger，方便API文檔的管理和測(cè)試。 記住替換 為你的實(shí)際服務(wù)器IP地址。