如何配置Django视图返回文件夹适配Nginx proxy_pass？

第一步：修复Nginx配置错误（主服务器未收到请求的核心原因） #

你的Nginx配置存在语法错误，导致请求根本没转发到主服务器：

• index index.html 末尾缺少分号 ;，会导致Nginx加载配置失败，无法正常处理请求。
• proxy_set_header X-Forwarded-Photo $scheme; 存在拼写错误，正确的请求头应为 X-Forwarded-Proto，错误的头信息会导致转发逻辑异常。

修正后的Nginx配置：

server {
    server_name 11.111.111.111;

    index index.html;

    location / {
        proxy_pass http://example.com/api/v1/render/;
        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;
    }
}

修改后重启Nginx：sudo systemctl restart nginx，先确认主服务器能收到请求。

第二步：配置Django的/api/v1/render视图返回站点内容 #

要让该视图返回包含静态资源的完整站点，需完成以下操作：

1. 编写视图返回index.html #

在Django视图中直接渲染并返回前端主模板（假设前端文件放在Django的templates目录下）：

from django.shortcuts import render

def render_site(request):
    # 单页应用直接返回主模板即可
    return render(request, 'index.html')

在项目urls.py中配置对应路由：

from django.urls import path
from .views import render_site

urlpatterns = [
    path('api/v1/render/', render_site, name='render_site'),
]

2. 确保静态资源可访问 #

生产环境不建议用Django直接处理静态资源，推荐以下两种方案：

• 方案一：代理服务器转发静态资源请求
  在代理服务器的Nginx配置中新增location块，专门处理静态资源（假设主服务器静态资源路径为/static/）：

location /static/ {
    proxy_pass http://example.com/static/;
    proxy_set_header Host $host;
}

同时确保主服务器已执行python manage.py collectstatic，将静态文件收集到settings.py中配置的STATIC_ROOT目录，且STATIC_URL设置为/static/。

• 方案二：Django临时处理静态资源（仅测试用）
  在主服务器settings.py中配置：

DEBUG = False
ALLOWED_HOSTS = ['example.com', '11.111.111.111']
STATIC_URL = '/static/'
STATIC_ROOT = '/path/to/your/static/files'

并在主服务器的urls.py中添加静态资源路由：

from django.conf import settings
from django.conf.urls.static import static

urlpatterns += static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)

注意：此方式仅适合测试，生产环境必须用Nginx或CDN处理静态资源。

3. 修正前端资源引用路径 #

确保index.html中的CSS、JS引用为绝对路径，例如：

<link rel="stylesheet" href="/static/css/style.css">
<script src="/static/js/app.js"></script>

这样代理服务器转发/static/请求到主服务器时，就能正确加载静态资源。

第三步：验证配置 #

1. 重启主服务器的Django服务和代理服务器的Nginx服务。
2. 访问http://11.111.111.111，检查页面及静态资源是否正常加载。
3. 若仍有问题，查看代理服务器Nginx日志（/var/log/nginx/error.log）和主服务器Django日志，定位具体错误。

内容的提问来源于stack exchange，提问作者Banderosik