Debian安装Swagger工具教程

作者：袖梨 2026-06-18

在Debian系统上安装Swagger工具，可以按照以下步骤进行：

方法一：使用npm安装Swagger UI

更新系统包列表
```
sudo apt update
```
安装Node.js和npm如果尚未安装Node.js和npm，可以使用以下命令进行安装：
```
sudo apt install nodejs npm
```
全局安装Swagger UI使用npm全局安装Swagger UI：
```
sudo npm install -g swagger-ui-express
```

启动Swagger UI假设你有一个名为app.js的Express应用文件，可以在其中添加以下代码来启动Swagger UI：

const express = require('express');const swaggerUi = require('swagger-ui-express');const YAML = require('yamljs');const swaggerDocument = YAML.load('./swagger.yaml'); // 确保你的Swagger文档文件名为swagger.yamlconst app = express();app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument));const PORT = process.env.PORT || 3000;app.listen(PORT, () => {console.log(`Server is running on port ${PORT}`);});

然后运行你的应用：

node app.js

访问 http://localhost:3000/api-docs 即可看到Swagger UI界面。

方法二：使用Docker安装Swagger UI

如果你更喜欢使用Docker，可以按照以下步骤操作：

安装Docker如果尚未安装Docker，可以使用以下命令进行安装：
```
sudo apt updatesudo apt install docker.io
```

拉取Swagger UI镜像

docker pull swaggerapi/swagger-ui-express

运行Swagger UI容器假设你的Swagger文档文件名为swagger.yaml，并且位于当前目录下，可以使用以下命令运行容器：
```
docker run -p 8080:8080 -v $(pwd):/usr/src/app swaggerapi/swagger-ui-express --swagger-file /usr/src/app/swagger.yaml
```
访问 http://localhost:8080 即可看到Swagger UI界面。

方法三：使用Python安装Swagger UI

如果你更喜欢使用Python，可以按照以下步骤操作：

安装Python和pip如果尚未安装Python和pip，可以使用以下命令进行安装：
```
sudo apt updatesudo apt install python3 python3-pip
```
安装Flask和Swagger UI使用pip安装Flask和Swagger UI：
```
pip3 install flask swagger-ui
```

创建Flask应用创建一个名为app.py的文件，并添加以下代码：

from flask import Flask, jsonifyfrom flasgger import Swaggerapp = Flask(__name__)Swagger(app)@app.route('/')def index():return jsonify({"message": "Hello, World!"})if __name__ == '__main__':app.run(debug=True)