温馨提示×

linux swagger需要什么依赖

小樊
36
2026-09-24 22:16:33
栏目: 智能运维

你问的“Linux 上 Swagger 需要什么依赖”,其实要看你用的是哪种 Swagger / OpenAPI 方案。下面按常见场景给你梳理一下(都适用于 Linux 环境)。


一、通用前提(不管哪种方式都要)

  1. Linux 基础环境
    • 能联网(装依赖用)
    • 有包管理器(apt / yum / dnf)
  2. 运行环境(二选一)
    • Java(Spring Boot + Swagger)
    • Node.js(Express / Nest + Swagger)
    • Python(FastAPI / Flask + Swagger)

二、常见方案 & 依赖

1️⃣ Spring Boot + Swagger(Java,最常见)

运行依赖

  • JDK 8 或以上
  • Maven 或 Gradle

Swagger 依赖(Maven 示例)

<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>

或者用官方新方案:

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

✅ 访问:http://ip:port/swagger-ui.html


2️⃣ Node.js + Swagger(Express / Nest)

依赖

npm install swagger-ui-express
npm install yamljs

示例

const swaggerUi = require('swagger-ui-express');
app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument));

3️⃣ Python + Swagger(FastAPI 自带)

FastAPI 自动集成:

pip install fastapi uvicorn

访问:

/docs

Flask 需要:

pip install flask-restx

4️⃣ 纯 Swagger Editor(不写代码)

如果你只是写 / 看 API 文档:

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

或

npm install -g swagger-cli

三、Linux 常见系统依赖(可选但常用)

# Ubuntu / Debian
apt install openjdk-17-jdk nodejs npm python3-pip docker.io

# CentOS / Rocky
yum install java-17-openjdk nodejs python3 docker

四、你可以直接告诉我

我可以给你精确依赖清单,只要你说:

  • ✅ 用什么语言(Java / Node / Python)
  • ✅ 框架(Spring Boot / Express / FastAPI)
  • ✅ 用途(开发 / 文档展示 / 自动生成)

我可以按你的系统直接写好一条条命令。

0 踩