温馨提示×

linux swagger能离线使用吗

小樊
55
2026-09-27 19:23:22
栏目: 智能运维

可以的,Swagger 在 Linux 上完全可以离线使用,只是具体方式取决于你说的“Swagger”指的是哪一部分。下面分情况说明:


一、Swagger UI 离线使用(最常见)

Swagger UI 本身是一个纯前端静态项目,不需要联网。

方式 1:下载源码离线部署

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

或者直接从 Release 页面下载 swagger-ui.zip: https://github.com/swagger-api/swagger-ui/releases

部署方式(任选):

  • Nginx
  • Apache
  • Python 简易服务器
python3 -m http.server 8080

然后修改:

dist/swagger-initializer.js

把 url 指向你本地的 swagger.json 或 openapi.yaml

✅ 完全离线可用


二、Swagger Editor 离线使用

Swagger Editor 也可离线运行。

方式 1:Docker(可离线)

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

(镜像提前下载好即可离线)

方式 2:静态部署

下载 swagger-editor.zip,解压后用 Nginx 托管。

✅ 离线可用


三、Spring Boot + Springdoc / Swagger(后端生成文档)

如果你是用:

  • springfox-swagger2
  • springdoc-openapi

只要:

  • 依赖已下载到本地 Maven / Gradle 仓库
  • 不依赖外部 CDN

就可以完全离线访问:

http://localhost:8080/swagger-ui.html

⚠️ 注意:

  • 有些老版本 Swagger UI 会从 CDN 加载 JS/CSS
  • 新版本(springdoc)已内置,无需联网

四、常见“不能离线”的原因

  1. Swagger UI 引用了:
    https://cdn.jsdelivr.net/...
    
  2. 未提前下载依赖包
  3. 使用了在线 Swagger Editor(editor.swagger.io)

五、总结

✅ Linux 下 Swagger 可以完全离线使用
✅ 推荐方案:

  • 后端:Springdoc(内置 UI)
  • 前端:本地部署 Swagger UI
  • 编辑:本地 Swagger Editor

如果你能告诉我:

  • 用的是 Spring Boot / Node / Python / Go
  • 想离线的是 UI / Editor / 文档生成

我可以给你一套具体可复制的离线部署方案。

0 踩