在 Debian 上部署 Swagger 并不难,具体难度取决于你想用哪种“Swagger”:
常见有 3 种情况:
docker run -p 8080:8080 \
-e SWAGGER_JSON=/foo/swagger.json \
-v $(pwd):/foo \
swaggerapi/swagger-ui
访问:http://服务器IP:8080
apt update
apt install nginx -y
cd /var/www/html
git clone https://github.com/swagger-api/swagger-ui.git
cp -r swagger-ui/dist/* .
然后改 swagger.json 路径即可。
docker run -p 8081:8080 swaggerapi/swagger-editor
访问:http://IP:8081
这种 部署本身不难,难点在写 API 注解。
| 场景 | 难度 | 建议 |
|---|---|---|
| 只看 API 文档 | 很简单 | Docker 跑 Swagger UI |
| 编辑 OpenAPI | 简单 | Swagger Editor |
| 项目集成 | 中等 | 看语言 |
如果你愿意,可以告诉我:
我可以直接给你一套 Debian 可复制的命令。