如何迁移linux swagger

linux

小樊

2026-09-06 17:50:02

栏目: 智能运维

你这个问题里“迁移 Linux Swagger”可能有几种不同含义，我分别说明，你可以对号入座：

一、迁移 Swagger 文档 / 项目（代码层面）

如果你是指：把 Swagger 相关的代码或文档从一个 Linux 服务器迁移到另一个 Linux 服务器

1. 确认 Swagger 使用方式

常见情况：

Spring Boot + Swagger / Springdoc
Node.js（Express + swagger-ui-express）
Python（FastAPI / Flask + swagger）
纯静态 Swagger UI + JSON/YAML

2. 迁移步骤（通用）

# 在源服务器
tar czf swagger-project.tar.gz /path/to/project

# 传到目标服务器
scp swagger-project.tar.gz user@new-server:/opt/

# 在目标服务器
tar xzf swagger-project.tar.gz
cd project
# 安装依赖
npm install / pip install -r requirements.txt / mvn clean package

3. 配置文件注意

端口（如 8080 / 3000）
Swagger 扫描路径
跨域（CORS）
访问地址（IP / 域名）

二、迁移 Swagger UI（静态页面）

如果只是 Swagger UI 页面 + API JSON

1. 安装 Swagger UI

npm install -g swagger-ui-express
# 或
docker pull swaggerapi/swagger-ui

2. Docker 方式（推荐）

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

迁移时只需拷贝：

swagger.json
Docker 启动命令

三、从 Swagger 2 迁移到 OpenAPI 3（版本升级）

Spring Boot 示例

旧：

springfox-swagger2

新：

springdoc-openapi-starter-webmvc-ui

访问地址变化：

/swagger-ui.html  →  /swagger-ui/index.html

四、迁移 Swagger 到另一个环境（Nginx 反向代理）

location /swagger/ {
    proxy_pass http://127.0.0.1:8080/;
}

五、常见坑

Linux 防火墙没开端口
SELinux 限制
JSON 路径不对
后端未暴露 /v3/api-docs

如果你能补充说明：

用的是 什么语言 / 框架
是 文档迁移、服务迁移，还是版本升级

我可以给你更精确的命令和配置。