Swagger 在 Debian 上可以离线使用,但具体取决于你指的是哪种“Swagger”用法。下面分情况说明:
可以,完全离线。
Swagger UI 本质是一个静态前端项目(HTML + JS + CSS)。
wget https://github.com/swagger-api/swagger-ui/archive/refs/tags/v5.x.x.zip
unzip v5.x.x.zip
然后将 dist/ 目录放到本地:
python3 -m http.server只要你的 swagger.json 或 swagger.yaml 也在本地,就不需要任何外网。
Debian 仓库里通常没有官方 Swagger UI 包,但你可以:
可以。
docker pull swaggerapi/swagger-editor
或在本地起静态服务:
npm install -g http-server
http-server swagger-editor
如果你是说 Spring Boot + springdoc-openapi:
/swagger-ui.html:离线注意:
确保使用的是本地资源,而不是:
<script src="https://unpkg.com/swagger-ui"></script>
❌ “Swagger 必须联网”
✅ 只有**在线 Demo(editor.swagger.io)**才需要网络
| 场景 | 是否可离线 |
|---|---|
| Swagger UI | ✅ 可以 |
| Swagger Editor | ✅ 可以 |
| Springdoc | ✅ 可以 |
| editor.swagger.io | ❌ 必须联网 |
如果你能说明:
我可以给你一份具体离线部署步骤。