linux

Swagger UI在Linux系统中如何部署

小樊
41
2025-03-16 01:38:36
栏目: 智能运维

在Linux系统中部署Swagger UI可以通过多种方式实现,以下是几种常见的方法:

使用Docker容器部署

  1. 安装Docker: 如果你还没有安装Docker,请先安装它。可以参考Docker官方文档进行安装。

  2. 拉取Swagger UI镜像

    docker pull swaggerapi/swagger-ui:v4.15.5
    
  3. 运行Swagger UI容器

    docker run -d -p 38081:8080 swaggerapi/swagger-ui:v4.15.5
    

    这将启动Swagger UI容器,默认情况下可以通过访问http://localhost:38081来查看Swagger UI界面。

使用npm和http-server部署

  1. 安装Node.js和npm: 如果你还没有安装Node.js和npm,可以参考Node.js官方文档进行安装。

  2. 下载并解压Swagger UI

    git clone https://github.com/swagger-api/swagger-ui.git
    cd swagger-ui
    npm install
    
  3. 安装http-server

    npm install -g http-server
    
  4. 启动http-server

    http-server -p 8080
    

    这将在端口8080上启动http-server,你可以通过访问http://localhost:8080来查看Swagger UI界面。

使用Apache或Nginx部署

  1. 安装Apache或Nginx: 如果你使用的是Ubuntu系统,可以参考以下命令安装:

    sudo apt update
    sudo apt install -y apache2
    # 或者
    sudo apt install -y nginx
    
  2. 下载并解压Swagger UI

    wget https://repo1.maven.org/maven2/io/springfox/springfox-swagger-ui/2.9.2/springfox-swagger-ui-2.9.2.html
    unzip springfox-swagger-ui-2.9.2.html
    sudo mv springfox-swagger-ui-2.9.2 /var/www/html/swagger-ui
    
  3. 配置Web服务器

    • Apache
      sudo a2ensite default.conf
      sudo systemctl restart apache2
      
    • Nginx
      sudo cp /etc/nginx/sites-available/default /etc/nginx/sites-available/default.backup
      sudo nano /etc/nginx/sites-available/default
      
      修改server块中的rootindex指令:
      server {
          listen 80 default_server;
          listen [::]:80 default_server;
          root /var/www/html;
          index index.html index.htm;
          server_name _;
          location / {
              try_files $uri $uri/ =404;
          }
      }
      
      保存并退出编辑器,然后重启Nginx:
      sudo systemctl restart nginx
      
  4. 访问Swagger UI: 现在,你应该能够通过浏览器访问http://your_server_ip/swagger-ui来查看和使用Swagger UI。

0
看了该问题的人还看了