Swagger是一个流行的API文档生成工具，它可以帮助开发者轻松地创建和编辑API文档。在Debian系统中集成Swagger，可以极大地简化API文档的生成和管理过程。

准备环境

更新系统

先说说 确保你的Debian系统是最新的：

sudo apt update && sudo apt upgrade -y

安装Node.js和npm

Swagger UI是一个基于Node.js的应用程序，所以呢需要安装Node.js和npm：

sudo apt-get install -y nodejs

安装Swagger命令行工具

sudo npm install -g swagger-cli

创建Swagger配置文件

在你的项目目录中创建一个名为swagger.yaml的文件，用于定义你的API规范：

swagger: '2.0'
info:
  description: Sample API
  version: '1.0.0'
host: localhost:3000
basePath: /
schemes:
  - http
paths:
  /users:
    get:
      summary: List all users
      responses:
        '200':
          description: A list of users

生成API文档

使用Swagger命令行工具生成API文档：

swagger generate-spec -i swagger.yaml -o generated

部署Swagger UI

将生成的API文档部署到你的服务器上。你可以使用任何适合你的方法，比如Nginx或Apache。

打开浏览器并访问 http://localhost:3000/api-docs 你应该能够看到Swagger UI界面其中包含了你在swagger.yaml中定义的API文档。

集成到Spring Boot应用

添加依赖

如果你的应用是基于Spring Boot， 你需要在pom.xml文件中添加Swagger的依赖：

    io.springfox
    springfox-swagger2
    2.9.2


    io.springfox
    springfox-swagger-ui
    2.9.2

配置Swagger

在Spring Boot应用中配置Swagger：

import springfox.documentation.swagger2.annotations.EnableSwagger2;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
@Configuration
@EnableSwagger2
public class SwaggerConfig {
    @Bean
    public Docket api {
        return new Docket
                .select
                .apis)
                .paths)
                .build;
    }
}

将Swagger集成到Debian系统中是一个相对简单的过程，和管理你的API文档。Swagger不仅可以帮助你创建高质量的API文档，还可以提高开发效率，减少错误。

---