怎样在CentOS上部署Swagger UI

centos

小樊

2025-08-22 23:00:52

栏目: 智能运维

在CentOS上部署Swagger UI，你可以按照以下步骤进行：

1. 安装必要的软件包

首先，确保你的CentOS系统已经安装了java和maven。如果没有安装，可以使用以下命令进行安装：

sudo yum install java-1.8.0-openjdk-devel
sudo yum install maven

2. 下载Swagger UI

你可以从Swagger的GitHub仓库下载Swagger UI的源码。使用以下命令克隆仓库：

git clone https://github.com/swagger-api/swagger-ui.git
cd swagger-ui

3. 构建Swagger UI

使用Maven构建Swagger UI项目：

mvn clean package

构建完成后，你会在swagger-ui/target目录下找到生成的静态文件。

4. 部署Swagger UI

将构建好的Swagger UI文件复制到你的Web服务器目录中。例如，如果你使用的是Apache HTTP Server，可以将文件复制到/var/www/html目录下：

sudo cp -r swagger-ui/target/swagger-ui-dist/* /var/www/html/

5. 配置Web服务器

确保你的Web服务器（如Apache）已经配置好，并且能够正确地提供静态文件服务。以下是一个简单的Apache配置示例：

<VirtualHost *:80>
    ServerName yourdomain.com

    DocumentRoot /var/www/html/swagger-ui-dist

    <Directory /var/www/html/swagger-ui-dist>
        Options Indexes FollowSymLinks
        AllowOverride None
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

将上述配置保存为/etc/httpd/conf.d/swagger-ui.conf，然后重启Apache服务：

sudo systemctl restart httpd

6. 访问Swagger UI

打开浏览器，访问http://yourdomain.com/swagger-ui.html，你应该能够看到Swagger UI界面。

7. 配置Swagger文档

如果你有Swagger定义文件（如swagger.json），可以将其放在Web服务器的某个目录下，并在Swagger UI中进行配置。例如，将swagger.json放在/var/www/html/swagger-docs目录下，然后在Swagger UI中输入该文件的URL：

http://yourdomain.com/swagger-docs/swagger.json

这样，Swagger UI就会加载并显示你的API文档。

通过以上步骤，你就可以在CentOS上成功部署Swagger UI了。