温馨提示×

debian swagger能离线用吗

小樊
44
2026-09-25 23:05:04
栏目: 智能运维

可以的,Swagger 在 Debian 上可以离线使用。下面分几种常见情况说明:


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

✅ 方式 1:本地部署 Swagger UI(完全离线)

  1. 在有网络的机器上下载:
    git clone https://github.com/swagger-api/swagger-ui.git
    
  2. 把 dist/ 目录拷贝到 Debian 服务器
  3. 用 Nginx / Apache 静态托管:
    cp -r swagger-ui/dist /var/www/swagger
    
  4. 修改 index.html 中的 url 指向你的本地 JSON:
    url: "/swagger/swagger.json"
    

✅ 不依赖任何外网 CDN,可完全离线运行


二、Swagger Editor 离线使用

✅ 方式 1:Docker(提前拉镜像)

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

✅ 方式 2:静态文件

下载 swagger-editor 的 dist 版本,直接放到本地 Web 服务器。


三、Spring Boot + Swagger(后端项目)

如果你指的是 Springdoc / Swagger2:

  • 只要不引用外网 CDN(如 webjars 从 Maven 本地仓库来)
  • 打包后部署到 Debian,完全可离线

注意:

  • 不要使用在线 swagger-ui CDN 链接
  • 使用内置 springdoc-openapi-ui

四、常见坑(Debian 离线注意)

❌ 使用了在线资源:

<script src="https://unpkg.com/swagger-ui-dist/..."></script>

✅ 改为本地引用


五、总结

场景 是否可离线
Swagger UI 静态部署 ✅ 可以
Swagger Editor ✅ 可以
Spring Boot 集成 ✅ 可以
在线 unpkg/CDN ❌ 不行

如果你能说明你是:

  • 用 Nginx + Swagger UI
  • 还是 Spring Boot
  • 还是 只查 API 文档

我可以给你一份可直接用的离线配置示例。

0 踩