如何配置 Nginx 提供静态文件服务？

题目

如何配置 Nginx 提供静态文件服务？

信息

• 类型：问答
• 难度：⭐

考点

基础配置语法,静态资源处理,location 匹配规则

快速回答

配置 Nginx 提供静态文件服务的核心步骤：

1. 在 http 块中定义 server 块监听端口
2. 使用 location 指令匹配静态文件请求路径
3. 通过 root 或 alias 指定文件系统路径
4. 启用 autoindex 可选项实现目录列表（非必需）

原理说明

Nginx 通过 location 指令匹配 URL 路径，结合 root 或 alias 将请求映射到服务器文件系统，直接返回静态文件（如 HTML/CSS/JS/图片）。相比动态处理，静态服务消耗资源更少，响应更快。

代码示例

http {
  server {
    listen 80;
    server_name example.com;

    # 基础静态服务配置
    location /static/ {
      root /var/www/;
      autoindex off;  # 禁止目录列表
    }

    # 使用 alias 的示例
    location /images/ {
      alias /data/images/;
    }

    # 首页配置
    location / {
      root /var/www/html;
      index index.html;
    }
  }
}

关键指令解析

• root：将 URL 路径追加到指定目录后。如请求 /static/logo.png 会映射到 /var/www/static/logo.png
• alias：用指定路径替换匹配路径。如请求 /images/cat.jpg 会映射到 /data/images/cat.jpg
• autoindex on：当目录中没有 index 文件时显示文件列表（生产环境建议关闭）

最佳实践

1. 为静态资源设置独立 location 块，与动态请求分离
2. 添加缓存控制头提高性能：
   expires 30d;
3. 限制敏感文件访问：
   location ~* \.(conf|key)$ { deny all; }
4. 使用 gzip 压缩文本文件：
   gzip on; gzip_types text/css application/json;

常见错误

• 路径混淆：root 会拼接 URL 路径，alias 直接替换路径
• 权限问题：Nginx 进程用户（通常为 nginx 或 www-data）需有文件读取权限
• 缺少结尾斜杠：location /static 会匹配 /static-file.txt，应使用 /static/
• 缓存配置不当：频繁更新的文件不应设置长期缓存

扩展知识

• 性能优化：
  启用 sendfile 减少文件传输开销：sendfile on;
• 防盗链：
  valid_referers none blocked *.example.com;
if ($invalid_referer) { return 403; }
• MIME 类型：
  确保 types 块包含 text/css application/javascript 等类型