在Linux系统中集成Swagger与OAuth2，可以按照以下步骤进行：
首先，你需要在你的Linux系统上安装Swagger。你可以使用npm（Node.js的包管理器）来安装Swagger。
sudo npm install -g swagger-ui-express 创建一个新的目录，并在该目录中初始化一个新的Node.js项目。
mkdir swagger-oauth2-example cd swagger-oauth2-example npm init -y 然后，安装Express和其他必要的依赖项。
npm install express body-parser swagger-ui-express 创建一个名为app.js的文件，并添加以下代码来设置一个基本的Express应用。
const express = require('express'); const bodyParser = require('body-parser'); const swaggerUi = require('swagger-ui-express'); const YAML = require('yamljs'); // Load Swagger document const swaggerDocument = YAML.load('./swagger.yaml'); const app = express(); // Parse incoming requests data app.use(bodyParser.json()); app.use(bodyParser.urlencoded({ extended: false })); // Serve Swagger docs app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument)); // Start the server const PORT = process.env.PORT || 3000; app.listen(PORT, () => { console.log(`Server is running on port ${PORT}`); }); 创建一个名为swagger.yaml的文件，并添加以下内容来定义你的API和OAuth2安全方案。
swagger: '2.0' info: title: Sample API description: A sample API with OAuth2 authentication version: '1.0.0' host: localhost:3000 basePath: /api schemes: - https paths: /users: get: summary: Get a list of users security: - OAuth2: [] components: securitySchemes: OAuth2: type: oauth2 flow: accessCode authorizationUrl: https://example.com/oauth/authorize tokenUrl: https://example.com/oauth/token scopes: read: Grants read access write: Grants write access 你需要一个OAuth2服务器来处理授权和令牌的发放。你可以使用passport和passport-oauth2来实现这一点。
首先，安装必要的依赖项。
npm install passport passport-oauth2 然后，创建一个名为auth.js的文件，并添加以下代码来配置OAuth2策略。
const passport = require('passport'); const OAuth2Strategy = require('passport-oauth2').Strategy; passport.use(new OAuth2Strategy({ authorizationURL: 'https://example.com/oauth/authorize', tokenURL: 'https://example.com/oauth/token', clientID: 'YOUR_CLIENT_ID', clientSecret: 'YOUR_CLIENT_SECRET', callbackURL: 'http://localhost:3000/auth/callback' }, function(accessToken, refreshToken, profile, cb) { // Here, you would typically find or create a user in your database // For this example, we'll just pass the profile through cb(null, profile); } )); passport.serializeUser(function(user, cb) { cb(null, user); }); passport.deserializeUser(function(obj, cb) { cb(null, obj); }); module.exports = passport; 修改app.js文件，添加OAuth2路由和中间件。
const express = require('express'); const bodyParser = require('body-parser'); const swaggerUi = require('swagger-ui-express'); const YAML = require('yamljs'); const passport = require('./auth'); // Load Swagger document const swaggerDocument = YAML.load('./swagger.yaml'); const app = express(); // Parse incoming requests data app.use(bodyParser.json()); app.use(bodyParser.urlencoded({ extended: false })); // Serve Swagger docs app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument)); // OAuth2 routes app.get('/auth/oauth2', passport.authenticate('oauth2')); app.get('/auth/oauth2/callback', passport.authenticate('oauth2', { failureRedirect: '/login' }), (req, res) => { // Successful authentication, redirect home. res.redirect('/'); }); // Start the server const PORT = process.env.PORT || 3000; app.listen(PORT, () => { console.log(`Server is running on port ${PORT}`); }); 现在，你可以运行你的Express应用。
node app.js 访问http://localhost:3000/api-docs，你应该能够看到Swagger UI，并且可以使用OAuth2进行身份验证。
通过以上步骤，你已经成功地在Linux系统中集成了Swagger与OAuth2。你可以根据需要进一步扩展和自定义你的API和OAuth2配置。
