debian swagger怎么导入文档

在 Debian 上“导入 Swagger 文档”通常分几种场景，下面按最常见用法给你说明，你可以对号入座。

一、Swagger UI 导入已有 Swagger 文档（最常用）

1. 安装 Swagger UI（Debian）

sudo apt update
sudo apt install npm -y
sudo npm install -g swagger-ui-express  # Node 方案（可选）

或者直接用静态版：

git clone https://github.com/swagger-api/swagger-ui.git
cd swagger-ui

2. 放置 Swagger 文档

把你的文档放到：

• swagger.yaml
• 或 swagger.json

例如：

/var/www/swagger/swagger.yaml

3. 修改 Swagger UI 配置

编辑：

swagger-ui/dist/index.html

找到：

url: "https://petstore.swagger.io/v2/swagger.json",

改为：

url: "/swagger.yaml",

如果你用 Nginx：

location /swagger.yaml {
    root /var/www/swagger;
}

4. 访问

http://你的IP/swagger-ui/

二、Spring Boot（Java）导入 Swagger 文档（Debian 服务器）

1. 引入依赖

<dependency>
  <groupId>io.springfox</groupId>
  <artifactId>springfox-swagger2</artifactId>
  <version>3.0.0</version>
</dependency>
<dependency>
  <groupId>io.springfox</groupId>
  <artifactId>springfox-swagger-ui</artifactId>
  <version>3.0.0</version>
</dependency>

2. 启动后访问

http://IP:端口/swagger-ui/

三、导入外部 Swagger JSON/YAML 到项目

如果你已有文档：

{
  "swagger": "2.0",
  "info": { "title": "API", "version": "1.0" }
}

直接：

• 放到项目 resources/
• 或 Swagger Editor 打开

https://editor.swagger.io/

→ File → Import File

四、Swagger Editor（Debian 本地）

docker run -p 8080:8080 swaggerapi/swagger-editor

访问：

http://IP:8080

→ Import → 选择 yaml/json

五、常见误区

❌ “Debian 本身导入 Swagger”
✅ Swagger 是应用层工具，Debian 只是运行环境

如果你能告诉我：

• 用的是 Node / Java / Python
• 想 查看文档 还是 生成代码

我可以给你更精确的命令。