在 Debian 上“装 Swagger”通常分几种场景,先确认你指的是哪一种,再注意对应坑点:
最常见的是:在 Debian 服务器上部署 Swagger UI,下面以这个为主。
Debian 官方源没有 Swagger UI 包
❌ apt install swagger 基本不存在或不是你要的
正确方式:
docker run -p 8080:8080 \
-e SWAGGER_JSON=/foo/api.yaml \
-v $(pwd):/foo \
swaggerapi/swagger-ui
注意:
apt install nginx
wget https://github.com/swagger-api/swagger-ui/archive/refs/tags/v5.x.x.zip
unzip
cp -r swagger-ui/dist /var/www/swagger
Nginx 配置:
server {
listen 80;
root /var/www/swagger;
index index.html;
}
⚠️ 注意:
swagger-config.yaml 指向你的 API JSONSwagger UI 在浏览器访问 API 时被拦
✅ 后端加:
Access-Control-Allow-Origin: *
告诉我:
我可以给你具体 Debian 下的配置示例
如果你说说:
“我是 Debian + Java/Spring”
或 “我是 Debian + Python FastAPI”
我可以直接给你一步步命令。