centos如何配置swagger

centos

小樊

2026-10-15 00:20:53

栏目: 智能运维

在 CentOS 上“配置 Swagger”通常有两种常见场景：

后端项目里集成 Swagger（如 Java / Spring Boot / Go / Python）
在 CentOS 上单独部署 Swagger UI（查看已有 API 文档）

下面我分别说明，你可以按需要看。

一、CentOS 上单独部署 Swagger UI（最常用）

适合：已有 swagger.json / swagger.yaml，只想在服务器上可视化查看

1. 安装 Nginx

sudo yum install -y epel-release
sudo yum install -y nginx
sudo systemctl enable nginx
sudo systemctl start nginx

2. 下载 Swagger UI

cd /usr/share/nginx/html
sudo rm -rf *
sudo yum install -y git
sudo git clone https://github.com/swagger-api/swagger-ui.git
sudo cp -r swagger-ui/dist/* .

3. 配置默认 Swagger 文件

编辑：

sudo vi /usr/share/nginx/html/swagger-initializer.js

修改这一行：

url: "swagger.json",

把你的 swagger.json 放到：

/usr/share/nginx/html/swagger.json

4. 浏览器访问

http://服务器IP/

二、Spring Boot 项目集成 Swagger（CentOS 上运行 Java 服务）

1. 添加依赖（Maven）

<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>3.0.0</version>
</dependency>
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>3.0.0</version>
</dependency>

2. 启用 Swagger

@Configuration
@EnableSwagger2
public class SwaggerConfig {
}

3. 访问地址

http://服务器IP:端口/swagger-ui/

三、Docker 方式（推荐，最简单）

docker run -p 8080:8080 \
  -e SWAGGER_JSON=/foo/swagger.json \
  -v /path/swagger.json:/foo/swagger.json \
  swaggerapi/swagger-ui

访问：

http://服务器IP:8080

四、常见问题

防火墙

sudo firewall-cmd --permanent --add-port=80/tcp
sudo firewall-cmd --reload

CentOS 8 已停止维护 → 建议用 Rocky / AlmaLinux

如果你能告诉我：

用的是 哪种语言/框架
是 本地查看 还是 服务器部署
是否有现成的 swagger.json

我可以给你更精确的配置步骤。