可以的,Swagger 在 Linux 上完全可以离线使用。下面按常见场景说明:
Swagger UI 本质是一套静态前端文件(HTML + JS + CSS),不需要联网。
wget https://github.com/swagger-api/swagger-ui/archive/refs/tags/v5.x.x.tar.gz
tar -zxvf v5.x.x.tar.gz
然后:
dist/ 目录放到 Nginx / Apacheswagger-initializer.js 中的 URL 为本地 JSONserver {
listen 80;
root /opt/swagger-ui/dist;
index index.html;
}
✅ 完全离线访问
Swagger Editor 也有离线版:
docker pull swaggerapi/swagger-editor
docker run -d -p 8080:8080 swaggerapi/swagger-editor
或下载静态版直接部署在 Linux 本地。
如果你指的是 接口文档自动生成:
springdoc-openapi 默认生成 JSONspringdoc:
api-docs:
enabled: true
swagger-ui:
enabled: true
只要:
就是完全离线
以下情况会“看起来不能离线”:
https://cdn.jsdelivr.net/...
✅ 解决办法:使用官方 dist 离线包
| 场景 | 是否可离线 |
|---|---|
| Swagger UI | ✅ 可 |
| Swagger Editor | ✅ 可 |
| Spring Boot 文档 | ✅ 可 |
| 在线 demo 站点 | ❌ 不可 |
如果你能说明:
我可以给你一份具体可复制的离线部署方案。