Web 服务器与网关 / 系统课时
设置首页与媒体类型
设置首页与媒体类型
本课将完成静态站点首页和资源类型映射配置,让 Nginx 能根据文件后缀返回正确的 Content-Type。完成后可以验证 HTML、CSS、JavaScript、字体和图片资源的响应头是否符合预期。
学习目标
- 理解 index 指令如何决定默认首页文件。
- 掌握 types 与 default_type 的配置作用。
- 能通过响应头验证静态资源类型是否正确。
配置首页文件
Nginx 接收到目录请求时,不会自动猜测入口文件,而是根据 index 指令指定的候选文件顺序查找。常见静态站点会优先使用 index.html,如果不存在则继续尝试其他文件。它不会自动把任何未知路由都变成首页;单页应用的路由回退需要另行配置。
下面建立独立本地实验,不改系统服务。前置条件是已经安装 Nginx 和 curl,并使用 Bash。创建一个可写目录作为实验根目录,在其中创建 html 和 logs;把已有静态站点的 index.html、app.css、app.js 放入 html。实验固定使用本机 8088 端口,被占用时需要同时替换配置和请求地址。
配置媒体类型映射
将以下完整配置保存为实验根目录中的 nginx.conf。root html 相对于启动时指定的 Nginx 前缀目录,因而不会依赖系统站点路径。default_type 只负责没有匹配到扩展名映射时的兜底,不会替代已匹配的 types。
worker_processes 1;
pid logs/nginx.pid;
error_log logs/error.log;
events { worker_connections 128; }
http {
# 教学用最小映射;真实站点应使用安装包提供的完整 mime.types。
types {
text/html html htm;
text/css css;
application/javascript js;
image/svg+xml svg;
image/png png;
font/woff2 woff2;
}
default_type application/octet-stream;
server {
listen 127.0.0.1:8088;
server_name localhost;
root html;
index index.html index.htm;
}
}预期结果:访问根路径时按顺序查找首页;CSS、JavaScript、SVG 和 WOFF2 文件分别使用映射中声明的类型;未知扩展名使用二进制流类型。没有首页且目录列表未开启时可能返回 403,文件不存在则通常返回 404,不能把错误页的类型当成目标资源的类型。
默认安装通常已经包含常见类型。生产配置可在 http 中引用该安装实际提供的 mime.types 文件,并保留兜底类型;不要在更低层的 location 中无意写一个只有单项的 types 表,使其他类型失去上层映射。新增类型后用实际响应核验,规则见 Nginx types 参考。
启动并验证资源响应头
在实验根目录运行以下命令。首次启动使用 nginx,修改配置后先测试,再对同一个前缀目录执行 nginx -s reload;不能只编辑文件却不让进程加载它。
nginx -p "$PWD/" -c nginx.conf -t
nginx -p "$PWD/" -c nginx.conf
curl -sS -I http://127.0.0.1:8088/
curl -sS -I http://127.0.0.1:8088/app.css
curl -sS -I http://127.0.0.1:8088/app.js预期结果:配置测试通过,三个请求均返回 200,首页为 text/html,CSS 为 text/css,JavaScript 为 application/javascript。部分环境可能附加 charset,判断时比较基础媒体类型;日期、长度等响应头随文件与环境变化。完成后在同一目录执行 nginx -p "$PWD/" -c nginx.conf -s quit 停止实验进程。
从错误响应定位问题
如果脚本请求返回 200 但类型是 text/html,先检查响应体是不是首页:常见原因是路由回退把缺失的脚本也改写成了入口页面。此时应修正资源路径或回退规则,不能把所有 HTML 响应强制声明成 JavaScript。
如果文件确实存在但类型是 application/octet-stream,再检查后缀与生效位置的映射。若修改后完全无变化,要核对请求的 Host、端口、命中的 server 和实际配置文件,再测试与重载;不要先关闭浏览器的类型检查。字体和图片也按同样步骤核验状态码、真实响应体和响应头,确认三者一致后再处理前端解析问题。