讲师中心 微信公众号
AI工具推荐 视频效率加速

如何在Python中为Django配置HTTPS与安全HTTP响应头

千宇同学_5887

千宇同学_5887

发布时间:2026-10-12 12:26:32

|

188人浏览过

|

来源于php中文网

原创

SECURE_SSL_REDIRECT=True在本地报错,因Django开发服务器runserver不支持HTTPS,强制跳转会导致“You're accessing the development server over HTTPS, but it only supports HTTP”错误;开发环境必须设为False,生产环境需配合反向代理透传X-Forwarded-Proto头并正确配置SECURE_PROXY_SSL_HEADER。

如何在python中为django配置https与安全http响应头

SECURE_SSL_REDIRECT=True 为什么在本地直接报错

因为 runserver 不支持 HTTPS,而 SECURE_SSL_REDIRECT=True 会强制对所有 HTTP 请求返回 301 跳转到 HTTPS 地址。浏览器一旦用 https://localhost:8000 访问,Django 就会尝试重定向,但开发服务器根本无法响应 HTTPS 请求,直接抛出 You're accessing the development server over HTTPS, but it only supports HTTP. 错误。

所以开发环境必须设为:SECURE_SSL_REDIRECT=False;生产环境才可设为 True,且前提是反向代理(如 Nginx)已终止 HTTPS 并透传协议头。

  • 不要在 settings.py 里硬编码 SECURE_SSL_REDIRECT=True,应按环境区分
  • 即使改回 False,浏览器可能仍缓存了之前的 301 跳转,需用隐身窗口或清空缓存验证
  • 若使用 Docker 或云服务(如 Cloudflare),要确认它们是否默认透传 X-Forwarded-Proto,否则 Django 始终认为是 HTTP

SECURE_PROXY_SSL_HEADER 必须配对设置,且值要严格匹配

SECURE_PROXY_SSL_HEADER 是元组,不是字符串,格式必须是 ('HTTP_X_FORWARDED_PROTO', 'https')。Django 默认不信任任何外部头,只有明确声明的头名 + 值组合才被接受为“可信的 HTTPS 来源”。

Nginx 配置中必须同步设置:proxy_set_header X-Forwarded-Proto $scheme;。如果 Nginx 实际传的是 X-Forwarded-Protocol: https,而 Django 期待的是 X-Forwarded-Proto,跳转逻辑就完全失效。

立即学习“Python免费学习笔记(深入)”;

Django Unfold
Django Unfold

提供使用 django-unfold (v0.56+) 构建高级 Django 管理界面的专业指导。当用户提及 django-unfold、unfold admin 等内容时使用此技能。

下载
  • Apache 用户注意:头名可能是 HTTP_X_FORWARDED_SCHEME 或 HTTP_X_FORWARDED_SSL,需根据 mod_headers 实际输出调整
  • 值必须全小写 'https',写成 'HTTPS' 或 'HttpS' 都不匹配
  • 该配置仅在 SECURE_SSL_REDIRECT=True 时生效,单独设置无意义

其他关键安全响应头要手动启用

Django 不自动注入 Strict-Transport-Security、Content-Security-Policy 等头,需靠中间件或响应钩子补充。最简单方式是在 MIDDLEWARE 中加入 django.middleware.security.SecurityMiddleware,并配置对应选项:

  • SECURE_HSTS_SECONDS = 31536000(推荐一年,首次上线可先设 300 测试)
  • SECURE_HSTS_INCLUDE_SUBDOMAINS = True(若你有子域名,否则可能阻断访问)
  • SECURE_CONTENT_TYPE_NOSNIFF = True(防 MIME 类型嗅探)
  • SECURE_BROWSER_XSS_FILTER = True(已弃用,Django 4.0+ 移除,仅旧项目需留意)

注意:SecurityMiddleware 必须放在 MIDDLEWARE 列表靠前位置(通常在 CommonMiddleware 之前),否则头可能被后续中间件覆盖。

证书文件本身不归 Django 管理,Nginx/Apache 才是 HTTPS 终结点

Django 应用本身不处理 SSL/TLS 握手。证书(.crt 或 .pem)和私钥(.key)必须由反向代理加载。例如 Nginx 配置中:

ssl_certificate /usr/share/nginx/ssl/your_domain.crt;
ssl_certificate_key /usr/share/nginx/ssl/your_domain.key;

路径必须可被 Nginx 进程读取(常因权限问题导致 502)。Django 只需通过 X-Forwarded-Proto 知道“外面已经是 HTTPS”,然后决定是否跳转、是否加 HSTS 头。

容易忽略的一点:云服务商(如 AWS ALB、Cloudflare)可能把证书托管在控制台,此时 Nginx 不需要配置证书,但仍需确保它把 X-Forwarded-Proto 正确传递给后端——否则 Django 完全不知道请求来源是 HTTPS。

热门AI工具

更多
咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

1751

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

4524

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1729

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

26697

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

3227

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

3247

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

1183

2023.08.11

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

596

2023.08.10

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

20

2026.10.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Uvicorn官方安装与入门手册
Uvicorn官方安装与入门手册

共0课时 | 0人学习

Python uv官方项目管理指南
Python uv官方项目管理指南

共0课时 | 0人学习

Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn