Debian装Swagger难不难

debian

小樊

2026-09-28 20:36:15

栏目: 智能运维

在 Debian 上装 Swagger 其实不算难，但具体“难不难”取决于你说的 Swagger 是哪一部分：

一、先说清楚：Swagger 常见 3 种用法

只是看 API 文档的网页界面
✅ 非常简单

写 OpenAPI 文档用的编辑器
✅ 简单

比如 Spring / Node / Python 自动生成文档
⚠️ 中等，看后端语言

几乎零依赖，10 分钟搞定。

sudo apt update
sudo apt install docker.io -y
sudo systemctl enable --now docker

docker run -p 8080:8080 swaggerapi/swagger-ui

浏览器打开：

http://服务器IP:8080

✅ 难度：⭐（非常简单）

sudo apt install git nginx -y
git clone https://github.com/swagger-api/swagger-ui.git
cp -r swagger-ui/dist /var/www/html/swagger

Nginx 配置：

server {
    listen 80;
    root /var/www/html/swagger;
    index index.html;
}

✅ 难度：⭐⭐（稍微动手）

Debian 装 Swagger UI = 不难，甚至新手也能搞定

如果你愿意，可以告诉我：

我可以给你完全按你环境定制的安装步骤。