Flask-RESTX部署Nginx后Swagger无法通过域名访问求助

我来帮你排查这个问题——你现在的情况是本地和IP+端口能正常访问Swagger，但通过域名访问就出错，问题大概率出在Nginx的配置细节上，咱们一步步来解决：

问题分析 #

先看你当前的Nginx配置：你指定了root /project_root_folder和index swagger.json，这会让Nginx优先尝试去本地目录找swagger.json文件，而不是把请求转发给Flask的5000端口。当用域名访问时，Nginx会先去本地目录找这个文件，如果找不到就直接报错，完全没触发后续的代理转发逻辑。

解决步骤 #

1. 移除冗余的静态文件配置

你的Flask服务本身已经在提供Swagger文档了，不需要Nginx去本地目录找静态文件。直接删掉root和index这两行，让所有请求都通过代理转发到Flask服务。

2. 补充关键的代理头信息

很多Flask组件（尤其是Swagger）需要知道真实的请求Host、IP等信息，否则会生成错误的文档链接或者拒绝请求。给配置加上几个必要的代理头：

修改后的完整Nginx配置：

server{ 
    listen 80; 
    listen [::]:80; 
    server_name example.com; 

    location / { 
        add_header 'Access-Control-Allow-Origin' '$http_origin' always; 
        proxy_pass http://127.0.0.1:5000;
        # 让Flask能正确识别域名请求的关键配置
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    } 
}

3. 验证配置并重启Nginx

修改完配置后，先检查配置是否合法：

nginx -t

如果输出提示test is successful，就重启Nginx让配置生效：

systemctl restart nginx

额外检查点 #

• 确认你的域名example.com已经正确解析到服务器的公网IP
• 检查服务器防火墙是否开放了80端口，允许外部访问
• 如果Swagger文档里的接口地址还是显示127.0.0.1:5000，需要在Flask的Swagger配置里设置正确的服务器URL，或者确保Flask能通过代理头自动识别域名

内容的提问来源于stack exchange，提问作者Shahrear Bin Amin