centos怎么部署swagger

在 CentOS 上“部署 Swagger”通常有几种常见场景，下面我按最常见用法给你说明，你可以按需选择。

一、常见 Swagger 部署方式说明

1. Swagger UI（静态页面，最常用）
   用于查看和测试已有接口（OpenAPI 文档）
2. Swagger Editor
   用于编写 OpenAPI 文档
3. Spring Boot 集成 Swagger（代码级）
   接口自动生成文档

下面重点讲 CentOS 上部署 Swagger UI（最通用）。

二、方式一：用 Nginx 部署 Swagger UI（推荐）

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 yum install -y git
sudo git clone https://github.com/swagger-api/swagger-ui.git

3. 配置 Swagger UI

cd swagger-ui
cp dist /usr/share/nginx/html/swagger

编辑 Nginx 配置：

sudo vi /etc/nginx/conf.d/swagger.conf

内容示例：

server {
    listen 80;
    server_name localhost;

    location /swagger/ {
        root /usr/share/nginx/html;
        index index.html;
    }
}

重启 Nginx：

sudo nginx -t
sudo systemctl restart nginx

浏览器访问：

http://服务器IP/swagger/

三、方式二：修改默认 API 地址

编辑：

vi /usr/share/nginx/html/swagger/index.html

找到：

url: "https://petstore.swagger.io/v2/swagger.json"

改成你的接口文档地址：

url: "http://你的IP/api/swagger.json"

四、方式三：Docker 部署 Swagger UI（更简单）

1. 安装 Docker

sudo yum install -y docker
sudo systemctl enable docker
sudo systemctl start docker

2. 启动 Swagger UI

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

访问：

http://服务器IP:8080

五、Spring Boot 项目集成 Swagger（补充）

如果你是用 Java：

<dependency>
  <groupId>io.springfox</groupId>
  <artifactId>springfox-swagger2</artifactId>
  <version>2.9.2</version>
</dependency>

访问：

http://IP:端口/swagger-ui.html

六、常见问题

• 打不开页面 → 检查防火墙

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

• 跨域问题 → 后端需允许 CORS
• 文档不显示 → 确认 JSON 地址可访问

如果你能告诉我：

• 是 Java / Python / Go？
• 想 看文档 还是 自动生成文档？

我可以直接给你一套适合你项目的部署方案。