温馨提示×

debian部署swagger难不难

小樊
50
2026-10-10 14:34:15
栏目: 智能运维

在 Debian 上部署 Swagger 并不难,具体难度取决于你想用哪种“Swagger”:


一、先明确你说的是哪种 Swagger

常见有 3 种情况:

  1. Swagger UI(最常见的“部署 Swagger”)
    • 只是静态页面,用来查看/调试 API
  2. Swagger Editor
    • 在线编辑 OpenAPI 文档
  3. 基于代码的 Swagger(如 Springdoc、swaggo)
    • 代码里集成,Debian 只是运行环境

二、最简单:Swagger UI(推荐新手)

难度:⭐(非常简单)

方式 1:直接用 Docker(最省事)

docker run -p 8080:8080 \
  -e SWAGGER_JSON=/foo/swagger.json \
  -v $(pwd):/foo \
  swaggerapi/swagger-ui

访问:http://服务器IP:8080

方式 2:Nginx + 静态文件

apt update
apt install nginx -y

cd /var/www/html
git clone https://github.com/swagger-api/swagger-ui.git
cp -r swagger-ui/dist/* .

然后改 swagger.json 路径即可。


三、Swagger Editor

难度:⭐⭐

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

访问:http://IP:8081


四、如果你是“后端项目要接 Swagger”

  • Java / Spring Boot:加依赖即可,Debian 只是运行 jar
  • Go:用 swaggo,生成 JSON
  • Python:用 FastAPI(自带 Swagger)

这种 部署本身不难,难点在写 API 注解。


五、总结

场景 难度 建议
只看 API 文档 很简单 Docker 跑 Swagger UI
编辑 OpenAPI 简单 Swagger Editor
项目集成 中等 看语言

如果你愿意,可以告诉我:

  • 你是 Java / Go / Python / Node?
  • 是想 看文档 还是 写接口文档?

我可以直接给你一套 Debian 可复制的命令。

0 踩