在 Debian 上“装不上 Swagger”通常不是 Debian 本身的问题,而是概念、安装方式或依赖环境不清楚导致的。下面把常见原因和正确做法说清楚。
在 Debian 里没有 apt install swagger 这种官方包,这也是最常见误区。
Swagger 相关东西分几类:
apt install swagger
❌ 不存在
✅ 正确方式取决于你用什么技术栈
Swagger UI / Editor 基本都靠 Node:
node -v
npm -v
如果没有:
sudo apt install nodejs npm
然后:
npm install -g swagger-ui
或本地:
npx swagger-ui-serve
Debian 默认:
检查:
sudo ufw status
很多人用:
docker run -p 8080:8080 swaggerapi/swagger-ui
需要先:
sudo apt install docker.io
sudo systemctl enable --now docker
比如:
<dependency>
<groupId>org.springdoc</groupId>
<artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
</dependency>
访问:
http://localhost:8080/swagger-ui.html
pip install fastapi uvicorn
自带 Swagger:
/docs
docker run -p 8080:8080 swaggerapi/swagger-ui
浏览器打开:
http://localhost:8080
wget https://github.com/swagger-api/swagger-ui/archive/refs/heads/master.zip
unzip master.zip
用 Nginx 指向 dist
看你语言,我可以直接给你完整配置。
cat /etc/os-release)我可以直接给你可复制可运行的命令。