怎么在 Nginx 中为静态资源配置全局响应策略

小杰君_6410

小杰君_6410

2026-06-07

813人浏览

原创

nginx中为静态资源设置全局响应策略的核心是在server块根location /中定义兜底响应头,并通过正则匹配的location ~* .(js|css|...)$统一启用强缓存、禁用autoindex、限制请求方法;gzip等传输优化指令可直接置于http块全局生效。

怎么在 nginx 中为静态资源配置全局响应策略

在 Nginx 中为静态资源设置全局响应策略,核心是统一控制响应头(如缓存、安全、压缩)、禁用目录浏览、限制请求方法,并确保这些策略作用于所有静态资源路径(如 /css/、/js/、/images/ 等),而非逐个 location 重复配置。关键不在于“写多遍”,而在于合理复用与层级继承。


✅ 统一响应头:用 add_header + expires 在 http 块中定义

Nginx 的 add_header 和 expires 指令不能直接写在 http 块顶层生效(它们只在 server 或 location 中生效),但可以通过以下方式实现“类全局”效果:

  • 将通用响应策略放在 server 块的根 location / 中;
  • 利用 location 匹配优先级,让更具体的静态路径继承或覆盖它;
  • 对所有静态资源路径统一启用缓存和安全头。
http {
    # 全局 MIME 类型支持
    include mime.types;
    default_type application/octet-stream;

    # 开启 gzip 压缩(全局生效)
    gzip on;
    gzip_types text/plain text/css application/javascript image/svg+xml;
    gzip_min_length 1024;
    gzip_vary on;

    # 定义一个可复用的缓存策略块(通过 include 或配置模板管理)
    # 实际中推荐用 include 引入公共片段,例如:
    # include /etc/nginx/conf.d/static-headers.conf;

    server {
        listen 80;
        server_name example.com;

        # 【根 location:兜底策略,影响所有未被更具体 location 覆盖的请求】
        location / {
            root /usr/share/nginx/html;
            index index.html;

            # 公共响应头(适用于 HTML、图标等)
            add_header X-Content-Type-Options "nosniff";
            add_header X-Frame-Options "DENY";
            add_header X-XSS-Protection "1; mode=block";
            add_header Referrer-Policy "no-referrer-when-downgrade";

            # 默认不缓存 HTML(动态倾向)
            expires -1;
        }

        # 【静态资源专用 location:覆盖根策略,启用强缓存】
        location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot|webp)$ {
            root /usr/share/nginx/html;

            # 静态文件缓存 1 年(immutable 提升浏览器复用率)
            expires 1y;
            add_header Cache-Control "public, immutable";

            # 禁用目录列表(即使匹配到空目录也不展示文件列表)
            autoindex off;

            # 只允许 GET/HEAD(防御非法方法)
            if ($request_method !~ ^(GET|HEAD)$) {
                return 405;
            }
        }

        # 【可选】单独处理 /api/ 等动态路径,避免被上面正则误匹配
        location /api/ {
            proxy_pass http://backend;
            # 此处不加 expires,保持动态响应特性
        }
    }
}

? 提示:location ~* \. 这种正则匹配会优先于 location /,所以它能精准接管所有静态后缀请求,并应用专属策略。


✅ 禁用目录浏览与非法方法(全局防护)

这两项必须在每个涉及静态资源的 location 中显式配置,因为 Nginx 不会自动继承 autoindex 或 if 逻辑:

  • autoindex off; —— 防止用户访问 /images/ 时看到文件列表;
  • if ($request_method ...) —— 防止 POST/PUT 等对静态路径的滥用(注意:if 在 location 内是安全的)。

⚠️ 注意:不要把 if 放在 server 或 http 块顶层,Nginx 明确不支持。

Nginx Config Linter
Nginx Config Linter

对 Nginx 配置文件进行语法检查、验证和安全、性能审计。

下载

✅ 静态资源压缩与传输优化(真正全局生效)

以下指令写在 http 块中即对所有响应生效,无需重复:

http {
    sendfile on;           # 启用内核零拷贝,提升大文件传输效率
    tcp_nopush on;         # 配合 sendfile,合并 TCP 包
    tcp_nodelay on;        # 对小响应(如首屏 JS)减少延迟

    # Gzip 已在前文开启,此处补充常见优化项
    gzip_buffers 16 8k;
    gzip_comp_level 6;
    gzip_http_version 1.1;
    gzip_disable "msie6";
}

这些属于底层传输层优化,只要 gzip on 开启,所有符合条件的响应(由 gzip_types 控制)都会自动压缩。


✅ 进阶建议:用 map + variables 动态控制响应头

若需更灵活策略(比如根据文件后缀设置不同 Cache-Control),可用 map 提前定义变量:

http {
    map $sent_http_content_type $cache_control {
        ~*text/html                 "no-cache";
        ~*text/css                   "public, max-age=31536000, immutable";
        ~*application/javascript     "public, max-age=31536000, immutable";
        ~*image/                     "public, max-age=31536000";
        default                      "no-cache";
    }

    server {
        location ~* \.(js|css|html|png|jpg|gif)$ {
            root /usr/share/nginx/html;
            add_header Cache-Control $cache_control;
        }
    }
}

这样就把缓存策略从硬编码转为数据驱动,便于维护。


不复杂但容易忽略。

相关文章

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

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

下载

相关标签:

nginx

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

相关专题

更多
nginx 重启
nginx 重启

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

2023.07.27

383

5

nginx 配置详解
nginx 配置详解

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

2023.08.04

3167

6

nginx配置详解
nginx配置详解

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

2023.08.04

5805

6

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

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

2024.02.23

561

5

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

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

2024.07.09

1476

5

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

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

2024.08.07

3918

3

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

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

2026.01.13

122

12

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

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

2026.01.13

437

23

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

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

2026.03.16

159

12

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

nginx手册
nginx手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习