Swagger UI在Linux上如何配置

在Linux上配置Swagger UI可以通過多種方法實現，以下是幾種常見的方法：

使用Docker容器部署Swagger UI和Swagger Editor

1. 安裝Docker： 如果你還沒有安裝Docker，可以使用以下命令安裝：

   sudo apt update
   sudo apt 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
   

3. 運行Swagger UI和Swagger Editor容器：

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

4. 訪問Swagger UI和Swagger Editor：

   • Swagger UI: http://localhost:8080
   • Swagger Editor: http://localhost:8081

使用npm安裝Swagger UI和Swagger Editor

1. 安裝Node.js和npm：

   curl -sL https://deb.nodesource.com/setup_16.x | sudo -E bash -
   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
   

4. 安裝Swagger Editor：

   git clone https://github.com/swagger-api/swagger-editor.git
   cd swagger-editor
   npm install
   

5. 啟動Swagger UI和Swagger Editor：

   • Swagger UI:

     http-server -p 8080
     

   • Swagger Editor:

     node index.js
     

6. 訪問Swagger UI和Swagger Editor：

   • Swagger UI: http://localhost:8080
   • Swagger Editor: http://localhost:8081

Spring Boot集成Swagger

1. 添加Maven依賴：

   <dependency>
       <groupId>io.springfox</groupId>
       <artifactId>springfox-swagger2</artifactId>
       <version>2.9.2</version>
   </dependency>
   <dependency>
       <groupId>com.github.xiaoymin</groupId>
       <artifactId>swagger-bootstrap-ui</artifactId>
       <version>1.9.6</version>
   </dependency>
   

2. 配置Swagger：

   @Configuration
   @EnableSwagger2
   @EnableSwaggerBootstrapUI
   public class SwaggerConfig {
       @Bean
       public Docket createRestApi() {
           return new Docket(DocumentationType.SWAGGER_2)
                   .apiInfo(apiInfo())
                   .select()
                   .apis(RequestHandlerSelectors.basePackage("com.example.demo.controller"))
                   .paths(PathSelectors.any())
                   .build();
       }
   
       private ApiInfo apiInfo() {
           return new ApiInfoBuilder()
                   .title("swagger-bootstrap-ui RESTful APIs")
                   .description("swagger-bootstrap-ui")
                   .termsOfServiceUrl("http://localhost:5050/")
                   .contact("developer@mail.com")
                   .version("1.0")
                   .build();
       }
   }
   

3. 啟動項目： 啟動項目后，訪問 http://ip:port/doc.html 即可查看Swagger UI。

以上方法可以幫助你在Linux系統上成功配置Swagger UI，選擇適合你項目需求的方法進行操作即可。