swagger 访问nginx 问题解决

最新推荐文章于 2025-05-23 09:29:33 发布

原创最新推荐文章于 2025-05-23 09:29:33 发布 · 8.3k 阅读

3 ·

CC 4.0 BY-SA版权

文章标签：

#nginx

Nginx 专栏收录该内容

1 篇文章

订阅专栏

本文详细记录了通过调整Nginx配置解决Swagger无法访问的问题过程，包括正确设置代理、主机名和端口，确保Swagger能够正常工作。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

服务架构

loadbalance层配置

nginx初始配置

server {
    listen       443;
    server_name  xxx.com;
    ssl on;
    ssl_certificate /etc/nginx/conf/xxx.com.pem;
    ssl_certificate_key /etc/nginx/conf/xxx.com.key;
    ssl_protocols       TLSv1 TLSv1.1 TLSv1.2;
    ssl_ciphers         HIGH:!aNULL:!MD5;

    #charset koi8-r;
    #access_log  /var/log/nginx/host.access.log  main;

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

   location / {
       proxy_pass http://x x x:y;
       proxy_set_header  X-Real-IP  $remote_addr;
       proxy_set_header X-Forwarded-For $remote_addr;
   }
}

测试后发现, 直接命令行curl xxx.com 或者浏览器访问都是正常的,但是swagger无法访问

开始解决问题

页面检查发现swagger 访问的地址变成了x x x:y, 可以确定是代理或请求转发有问题,

从nginx作手尝试增加对 host 的绑定

server {
    listen       443;
    server_name  xxx.com;
    ssl on;
    ssl_certificate /etc/nginx/conf/xxx.com.pem;
    ssl_certificate_key /etc/nginx/conf/xxx.com.key;
    ssl_protocols       TLSv1 TLSv1.1 TLSv1.2;
    ssl_ciphers         HIGH:!aNULL:!MD5;

   location / {
       proxy_pass http://x x x:y;
       proxy_set_header Host $host;
       proxy_set_header  X-Real-IP  $remote_addr;
       proxy_set_header X-Forwarded-For $remote_addr;
   }
}

reload 之后使用swagger访问发现访问地址变成了xxx.com:y, 设置代理的时候把端口带上了,

尝试指定协议和代理端口

server {
    listen       443;
    server_name  xxx.com;
    ssl on;
    ssl_certificate /etc/nginx/con/xxx.com.pem;
    ssl_certificate_key /etc/nginx/conf/xxx.com.key;
    ssl_protocols       TLSv1 TLSv1.1 TLSv1.2;
    ssl_ciphers         HIGH:!aNULL:!MD5;

   location / {
       proxy_pass http://xxx:y;
       proxy_set_header Host $host;
       proxy_set_header  X-Real-IP  $remote_addr;
       proxy_set_header X-Forwarded-For $remote_addr;
       #proxy_set_header Host $host:$server_port;
       proxy_set_header X-Forwarded-Proto $scheme;
       proxy_set_header X-Forwarded-Port $server_port;
   }
}

内部nginx配置

server {
    listen       y;
    server_name  xxx;

   location / {
       proxy_pass http://xxx:y;
       proxy_set_header  X-Real-IP  $remote_addr;
       proxy_set_header X-Forwarded-For $remote_addr;
   }
}

reload 之后使用swagger访问, 此时已经可以正常返回

配置参考:https://github.com/abel1225/DevOps-Configuration/blob/master/nginx/config/nginx-swagger.conf