centos如何部署swagger

在 CentOS 上“部署 Swagger”通常有几种常见场景，下面我按最常见、最实用的方式给你讲，你可以按需要选择。

一、概念澄清（先搞清楚你要哪种）

二、方式一：在 CentOS 部署 Swagger UI（最推荐）

1️⃣ 安装依赖

yum install -y wget unzip nginx

2️⃣ 下载 Swagger UI

cd /usr/share/nginx/html
wget https://github.com/swagger-api/swagger-ui/archive/refs/tags/v5.17.14.zip
unzip v5.17.14.zip
mv swagger-ui-5.17.14 swagger-ui

3️⃣ 配置 Swagger UI

编辑：

vi /usr/share/nginx/html/swagger-ui/dist/swagger-initializer.js

修改：

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

改成你自己的 API 文档地址，例如：

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

4️⃣ 启动 Nginx

systemctl start nginx
systemctl enable nginx

访问：

http://服务器IP/swagger-ui/dist/

✅ 完成

三、方式二：Spring Boot 项目集成 Swagger（Java 项目）

1️⃣ 添加依赖（Springfox）

<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

@EnableSwagger2
@SpringBootApplication
public class App {}

3️⃣ 访问

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

四、方式三：Docker 部署 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

五、常见问题

❌ 页面打不开

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

❌ 跨域问题

后端需允许：

Access-Control-Allow-Origin: *

六、我可以继续帮你

你可以告诉我：

• ✅ 是 Java / Python / Go 项目？
• ✅ 想要 本地测试 还是 服务器生产环境？
• ✅ 用 Nginx / Docker / 直接运行？

我可以直接给你完整可复制的配置。