如何利用 sub_filter 指令在代理层自动修正缓存页面内不安全的 HTTP 引用

阿瑶酱_3085

阿瑶酱_3085

2026-05-19

354人浏览

原创

Nginx sub_filter可修复HTTPS页面中的HTTP混合内容,但需同时满足:禁用压缩、显式配置MIME类型、精准锚定HTML/CSS属性替换、关闭单次替换并禁用ETag,再辅以upgrade-insecure-requests头兜底。

如何利用 sub_filter 指令在代理层自动修正缓存页面内不安全的 http 引用

Nginx 的 sub_filter 指令能在代理层实时修改响应体中的文本内容,对已缓存的 HTTPS 页面中残留的 HTTP 资源链接(如 、<script src="http://..."></script>)进行协议升级,从而消除混合内容警告。但它不是“万能补丁”,生效依赖几个硬性条件,缺一不可。

必须禁用响应压缩
sub_filter 只处理明文文本流,一旦后端返回 Content-Encoding: gzip 或 br,Nginx 就无法解析和替换。

  • 在对应 location 块中加 gzip off;(最直接)
  • 或主动告知后端不返回压缩:proxy_set_header Accept-Encoding "";
  • 不推荐依赖 gunzip on;,它需模块支持、增加开销,且对 brotli 无效

必须显式声明可处理的 MIME 类型
默认只作用于 text/html,但缓存页面可能包含内联 CSS/JS、JSON 配置或服务端渲染的 HTML 片段。

  • 至少配置:sub_filter_types text/html text/css application/javascript application/json;
  • 若页面含 XHTML 或 SVG 内嵌 HTML,可追加 application/xhtml+xml
  • 避免 sub_filter_types *;,虽无害但会多做无效扫描

必须精准匹配上下文,避免误替换
sub_filter 是纯字符串替换,不识别语法结构。全局替换 http:// 极易出错(比如把 "http_status": 200 或注释里的 也改掉)。

  • 优先锚定 HTML 属性边界:
    sub_filter 'src="http://' 'src="https://';
    sub_filter "src='http://" "src='https://";
    sub_filter 'href="http://' 'href="https://';
  • 对 CSS 中 url(http://...),需额外加:sub_filter 'url(http://' 'url(https://';(注意括号和空格)
  • 不要省略引号——单引号、双引号都要覆盖,因 HTML 允许两者混用

必须关闭单次替换并处理缓存干扰
缓存页面往往带 ETag 或 Last-Modified,而 sub_filter 修改后响应体已变,原校验值失效。

  • 加 sub_filter_once off;(否则只改第一个 )
  • 加 etag off; 禁用 ETag,防止浏览器加载未替换的老缓存
  • 可选:加 add_header Cache-Control "no-store, must-revalidate"; 强制跳过代理/浏览器缓存(仅调试期用)

补充兜底策略,覆盖 sub_filter 盲区
动态生成的 URL(如 document.write('<script src="'%20+%20protocol%20+%20'//cdn.com/a.js&gt;')&lt;/code&gt;%EF%BC%89%E6%97%A0%E6%B3%95%E8%A2%AB%20&lt;code&gt;sub_filter&lt;/code&gt;%20%E8%A7%A6%E5%8F%8A%E3%80%82%20%20&lt;/p&gt;&lt;ul&gt;&lt;li&gt;%E5%BF%85%E9%A1%BB%E9%85%8D%E5%90%88%E5%93%8D%E5%BA%94%E5%A4%B4%EF%BC%9A&lt;code&gt;add_header%20Content-Security-Policy%20" upgrade-insecure-requests> <li>&#23427;&#30001;&#27983;&#35272;&#22120;&#25191;&#34892;&#65292;&#33258;&#21160;&#23558;&#39029;&#38754;&#20869;&#25152;&#26377; <code>http://</script> 资源请求升为 https://,与 sub_filter 形成互补

  • 同时建议用 proxy_redirect http:// https://; 修正后端返回的 Location 跳转头,确保重定向也走 HTTPS
  • 不复杂但容易忽略

    PHP速学视频免费教程(入门到精通)
    PHP速学视频免费教程(入门到精通)

    PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

    下载

    相关标签:

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

    相关专题

    更多
    nginx 重启
    nginx 重启

    nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

    2023.07.27

    423

    5

    nginx 配置详解
    nginx 配置详解

    Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

    2023.08.04

    4007

    6

    nginx配置详解
    nginx配置详解

    NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

    2023.08.04

    6865

    6

    tomcat和nginx有哪些区别
    tomcat和nginx有哪些区别

    tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

    2024.02.23

    601

    5

    nginx报404怎么解决
    nginx报404怎么解决

    当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

    2024.07.09

    1516

    5

    Nginx报404错误解决方法
    Nginx报404错误解决方法

    解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

    2024.08.07

    3978

    3

    nginx部署php项目教程汇总
    nginx部署php项目教程汇总

    本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

    2026.01.13

    122

    12

    nginx配置文件详细教程
    nginx配置文件详细教程

    本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

    2026.01.13

    537

    23

    Nginx跨平台安装实操指南:Windows、macOS与Linux环境快速搭建
    Nginx跨平台安装实操指南:Windows、macOS与Linux环境快速搭建

    本指南详解Nginx在Windows、macOS及Linux系统的安装全流程。涵盖官方包解压、Homebrew一键部署、APT/YUM源配置及Docker容器化方案。无论新手或开发者,均可快速搭建运行环境,掌握跨平台核心指令,为后续配置与调优奠定坚实基础。

    2026.03.16

    179

    12

    热门下载

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

    精品课程

    更多
    热门推荐
    /
    最新课程
    phpStudy极速入门视频教程
    phpStudy极速入门视频教程

    共6课时 | 54.7万人学习

    独孤九贱(4)_PHP视频教程
    独孤九贱(4)_PHP视频教程

    共89课时 | 134.1万人学习