Swagger 其实有不同的“产品”,在 Debian / Linux 环境下常见的几种获取方式如下:
不需要“下载 Debian 版”,直接用浏览器打开官方在线版即可:
如果你想本地运行(Debian 上推荐用 Docker):
docker pull swaggerapi/swagger-editor
docker run -d -p 8080:8080 swaggerapi/swagger-editor
然后浏览器访问 http://localhost:8080
同样推荐 Docker:
docker pull swaggerapi/swagger-ui
docker run -d -p 8081:8080 swaggerapi/swagger-ui
或者直接用 npm 安装:
npm install -g swagger-ui-express
Debian 上可用 apt 或下载 jar:
方式 A:下载 jar(通用)
wget https://repo1.maven.org/maven2/io/swagger/codegen/v3/swagger-codegen-cli/3.0.41/swagger-codegen-cli-3.0.41.jar
java -jar swagger-codegen-cli-3.0.41.jar
方式 B:用 OpenAPI Generator(更现代)
npm install -g @openapitools/openapi-generator-cli
SwaggerHub 没有独立的 Debian 安装包,只有 Web 版:
| 需求 | Debian 推荐方式 |
|---|---|
| 写 API 文档 | Docker 跑 Swagger Editor |
| 看 API 文档 | Docker 跑 Swagger UI |
| 生成代码 | swagger-codegen-cli.jar |
| 不想装东西 | 直接用官网在线版 |
如果你指的是某一个具体叫“Swagger Debian 安装包”的东西(比如某个旧版 deb 文件),可以告诉我具体名称或截图,我帮你找。