Django多域名配置的难题集中在Session跨域隔离、CSRF信任白名单和反向代理路由三处,优化建议是从中间件层接管Host解析,配合Nginx按域名转发,再用二级域名做Session分区。
Django多域名配置最常见的三个坑,踩过才懂为什么前端总报403
子域名之间的Session串号问题,经常被当成缓存bug排查半天
不少人做Django多域名配置教程时,把域名都填进ALLOWED_HOSTS就以为完事,结果用户在shop.example.com登录后,跳转到www.example.com发现用户信息变成了另一个账号,这不是缓存问题,是SESSION_COOKIE_DOMAIN没隔离。
默认情况下,Django会把Session Cookie绑定到当前域名,但当你用同一个浏览器访问多个子域名时,如果不显式指定SESSION_COOKIE_DOMAIN,浏览器会按父域或当前域存储Cookie,只要其中一个域名下发了通用Cookie,另一个域名就会读到别人的会话数据。
具体排查路径:登录A子域名后,打开浏览器开发者工具的Application面板,查看Cookie列表里的sessionid字段,看它的Domain属性,如果你发现Domain是.example.com,说明已经串了,解决办法是在settings.py里给每个子域名单独设置SESSION_COOKIE_DOMAIN,或者干脆用SESSION_COOKIE_NAME区分,比如session_shop和session_www,让不同域名的会话物理隔离。
CSRF校验的域名白名单配置,没加这个配置天天被安全拦截
Django的CSRF中间件会校验请求来源,多域名架构下,如果主站页面里通过Ajax请求子域名的API接口,CSRF会直接拒绝,返回403,这是Django多域名配置难题里出现频率最高的问题。
不少新手只配置了CSRF_COOKIE_DOMAIN,却漏掉CSRF_TRUSTED_ORIGINS,在Django 4.x及以上版本,这个配置要求写全协议和端口,写成https://shop.example.com,只写shop.example.com会被忽略,这个细节在Django多站点部署方案对比时经常被拿出来讲。
实操修复路径:
- 在
settings.py中添加CSRF_TRUSTED_ORIGINS = ['https://www.example.com', 'https://shop.example.com', 'https://api.example.com'] - 确保前端请求头带
X-CSRFToken,且Cookie的SameSite属性设置合理 - 如果使用跨域Cookie,需把
CSRF_COOKIE_SAMESITE设为'Lax',不推荐用'None',除非你确实需要跨站携带Cookie
Nginx反向代理转发时丢失Host头,Django拿到的是内网IP
Django通过request.get_host()获取当前域名,用来解析URL和生成绝对链接,当Nginx反代到Django时,默认会把Host改写成0.0.1:8000,如果Django里没配USE_X_FORWARDED_HOST = True,生成的所有绝对URL都会指向内网地址,吞掉用户在浏览器里访问的域名。
Django多域名配置教程里经常强调这个细节:Nginx里必须写proxy_set_header Host $host;,同时Django这边开启USE_X_FORWARDED_HOST = True,如果你用了HTTPS,还得加上SECURE_PROXY_SSL_HEADER = ('HTTP_X_FORWARDED_PROTO', 'https'),否则Django会把所有请求当成HTTP处理,导致重定向死循环。
Django多站点部署方案对比:中间件路由和独立Site框架怎么选
场景拆解:什么时候该用django.contrib.sites,什么时候自己写中间件
Django官方建议用django.contrib.sites框架来管理多域名,通过Site模型绑定域名和内容,这个方案适合内容不同、展示层面差异明显的情况,比如企业站群,每个域名对应完全独立的页面内容。
但如果你只是想让一套代码服务多个功能子域,比如api.example.com提供API,admin.example.com做管理后台,www.example.com跑官网,那么django.contrib.sites反而会拖慢速度它的CurrentSiteMiddleware每次请求都要查一次数据库,行业共识认为,这类场景更适合自定义中间件,根据Host头直接路由到对应处理逻辑。
这块属于Django多域名配置优化建议中的核心讨论点。sites框架适合内容展示型多域,自定义Host路由适合功能性多域。
中间件路由的具体写法,可复制的代码逻辑
在项目的middleware.py里写一个HostRouterMiddleware,按域名前缀分发给不同的URLConf:
class HostRouterMiddleware:
def __init__(self, get_response):
self.get_response = get_response
def __call__(self, request):
host = request.get_host().split(':')[0]
if host.startswith('api.'):
request.urlconf = 'project.api_urls'
elif host.startswith('admin.'):
request.urlconf = 'project.admin_urls'
else:
request.urlconf = 'project.main_urls'
return self.get_response(request)
然后放在MIDDLEWARE列表最靠前的位置,确保在其他中间件执行前完成路由切换,这样做的好处有:
- 无需为每个域名单独部署一个Django进程,省服务器资源
- URLConf单独写,业务模块互不干扰,按域名隔离代码边界
- 配合Nginx做健康检查时,一个Django服务就能撑起全部流量
静态文件和数据表隔离的取舍,多数情况下不需要分库
子域名之间的静态资源尽量用独立域名或CDN域名,比如static.example.com,这样Django里统一配一个STATIC_URL就行,如果沿用原来的单域名静态路径,每次切换子域名都要重新带Cookie,拦截率会很高。
数据表隔离这个话题要看业务,对于Django多域名配置的常见需求来说,用一个数据库,靠tenant_id或site_id字段区分,比拆库轻量得多,只有用户量和数据量都大到单库扛不住了,才考虑分库。
settings.py里的多域名优化清单,直接照着抄
ALLOWED_HOSTS动态匹配,别再用列表写死域名
硬编码ALLOWED_HOSTS的问题是测试环境和生产环境域名不一致,改了代码才能跑,优化做法是用环境变量动态拼接:
import os
ALLOWED_HOSTS = os.getenv('DJANGO_ALLOWED_HOSTS', 'localhost,127.0.0.1').split(',')
生产环境用逗号分隔把所有域名塞进环境变量,Django启动时自动读取,多域名中间件所需的自定义配置可以放到request.META['HTTP_HOST']里判断,不依赖ALLOWED_HOSTS的精确匹配。
SESSION_COOKIE_DOMAIN和CSRF_COOKIE_DOMAIN的联动设置
如果子域名需要共享登录状态,比如用户在主站登录后跳转到博客子域保持登录,那么把SESSION_COOKIE_DOMAIN设为.example.com(带前导点)。CSRF_COOKIE_DOMAIN也要跟着设成同样的父域,否则CSRF跨域提交全被拦。
但这里有个副作用的坑:所有子域名都共享同一份Cookie,任何一个子域名能把用户Cookie踢下线。 所以如果子域名之间信任级别不同,建议放弃共享Session,用JWT Token代替,Token可以放在localStorage里,不随Cookie自动携带,也就没有跨域串号问题。
APPEND_SLASH对多域名的干扰,以及Django 4.x的优化
当APPEND_SLASH = True(默认值)时,Django收到不带头斜杠的请求会自动重定向,多域名环境下,如果Nginx已经把/api转发到Django,Django会把它重定向成/api/,这个重定向过程中Host头如果是内网地址,用户看到的URL就乱了。
建议把APPEND_SLASH关掉,在Nginx层统一处理斜杠:
location ~ ^/api[^/]?(.)$ {
rewrite ^/api(.)$ /api/$1 permanent;
proxy_pass http://django_backend;
proxy_set_header Host $host;
}
这样Django接收到的永远是完整路径,不用处理重定向,也规避了Host头丢失问题。
Django多域名部署完成后,Nginx和Django联调的关键验证步骤
部署阶段最容易忽略的是sites框架的数据库记录,如果你用了django.contrib.sites,必须进入Django Admin后台,手动把每个域名对应的Site记录加进去,否则request.site拿到的永远是默认的example.com。
验证多域名配置是否成功的三个命令:
python manage.py check检查Django配置是否合规curl -H "Host: shop.example.com" http://127.0.0.1:8000/health模拟域名访问,看返回的响应头curl -I https://www.example.com检查Nginx层返回的Location头是否带完整域名
在HTTPS场景下,还要确认CSRF_TRUSTED_ORIGINS里的协议写的是https,如果你用HTTP访问测试,CSRF仍然会报Origin checking failed,这会让Django多域名配置教程的初学者误以为还没配好。
针对Django多域名配置优化建议,最终的落点是把Host解析交给中间件而不是django.contrib.sites,尽量减轻数据库压力,Django多站点部署方案对比下来,中间件版可维护性更高,适合从零搭建的项目。
Django多域名配置常见问题解答
多个子域名必须建多个Django项目吗?
不需要,用中间件方案切换urlconf即可实现单进程多域名,节省内存占用,只有当子域名之间的负载差异非常大时,才考虑拆成独立项目并部署到不同端口,配合Nginx按域分流。
子域名间Session隔离和共享,哪种场景需要显式配置?
当所有子域名都属于同一信任域,且用户需要跨域维持登录状态时,配置SESSION_COOKIE_DOMAIN = '.example.com',如果子域名提供的是公开内容或完全独立的用户体系,则保持默认隔离状态,手动为每个子域名设置不同的SESSION_COOKIE_NAME即可。
Django多域名部署后出现403,一般是什么原因?
绝大多数情况是CSRF_TRUSTED_ORIGINS没包含当前域名,或者端口号写得不完整,少数情况是Nginx的proxy_set_header Host $host;缺失导致Django解析不了正确域名,从而无法匹配到白名单里的Host值,逐项检查这两个配置,基本能解决问题。
图片来源于AI模型,如侵权请联系管理员。作者:酷小编,如若转载,请注明出处:https://www.kufanyun.com/ask/930994.html


评论列表(3条)
这篇文章的内容非常有价值,我从中学习到了很多新的知识和观点。作者的写作风格简洁明了,却又不失深度,让人读起来很舒服。特别是配合部分,给了我很多新的思路。感谢分享这么好的内容!
这篇文章写得非常好,内容丰富,观点清晰,让我受益匪浅。特别是关于配合的部分,分析得很到位,给了我很多新的启发和思考。感谢作者的精心创作和分享,期待看到更多这样高质量的内容!
这篇文章写得非常好,内容丰富,观点清晰,让我受益匪浅。特别是关于配合的部分,分析得很到位,给了我很多新的启发和思考。感谢作者的精心创作和分享,期待看到更多这样高质量的内容!