让网址找到正确的静态文件

理解 root、目录首页和文件权限,让 URL 与磁盘文件准确对应。

🎯 引言

首页能打开后,下一步是放入样式和下载资料。本篇解决“浏览器请求一个路径时,Nginx 到底读取哪份文件”,这样遇到 404 就不必反复猜配置。


🧱 从 URL 推导文件路径

保留前面的 root html; 和 try_files $uri $uri/ =404;。实验实例的路径前缀是 $HOME/nginx-course/,因此:

请求路径寻找的文件或目录
/index.html$HOME/nginx-course/html/index.html
/assets/site.css$HOME/nginx-course/html/assets/site.css
/chapter/$HOME/nginx-course/html/chapter/ 目录中的首页

root 的核心规则是根目录加请求路径。在 location /assets/ 中写 root html;,不会自动去掉 /assets/,仍然寻找 html/assets/...。准确规则可查核心模块的 root 与 alias。

index index.html; 在目录请求中找首页;找到后会在内部改用对应文件路径处理。没有首页并不意味着 Nginx 会自动列出目录,本课程保持目录列表关闭。


🛠 给学习笔记加上样式

执行 vim "$HOME/nginx-course/html/assets/site.css",保存:

html/assets/site.css
body {
    max-width: 48rem;
    margin: 2rem auto;
    padding: 0 1rem;
    font-family: sans-serif;
    line-height: 1.8;
}

在已有 HTML 的 <head> 中加入这一行:

<link rel="stylesheet" href="/assets/site.css">

浏览器读取 HTML 后,会根据 href 再请求一次 CSS。因此能看到文字但没有样式时,应检查 CSS 那次请求:

curl -i http://127.0.0.1:8080/assets/site.css

预期状态码 200,类型为 text/css,响应体包含刚写的 CSS。Content-Type 是告诉浏览器怎样解释内容的响应头;把 CSS 当普通文本发送可能导致浏览器不应用它。


🧰 用 alias 映射另一个目录

假设下载文件不想放入 html。先执行:

mkdir -p "$HOME/nginx-course/downloads"
printf 'Nginx learning checklist\n' > "$HOME/nginx-course/downloads/checklist.txt"

printf 输出文字,> 将输出写入文件,已有同名文件会被覆盖。在 site.conf 的 server 内增加:

location /downloads/ {
    alias /home/你的用户名/nginx-course/downloads/;
}

先用 echo "$HOME" 查看个人目录,把上面的占位路径改成自己的绝对路径,再检查和重载。 Nginx 不会展开 Bash 的 $HOME,不要把它直接写进配置。

alias 用目标目录替换匹配的路径前缀:/downloads/checklist.txt 对应 downloads/ 下的 checklist.txt。本例的 location 和 alias 都以 / 结尾,避免拼接出错误路径。它是一个独立映射实验,验证后可删除这个块,后续主线只依赖 html。


🪤 文件存在为什么仍然读不到

文件要允许工作进程读取,沿途目录也要允许进入。当前独立实例由你本人启动,网页放在你自己的目录中,通常不需要额外改权限。

系统服务可能使用另一个账号,这时不能假设它能进入个人目录。不要用 chmod -R 777 解决问题,那会让所有人都能修改文件。先根据错误日志确认究竟是文件不存在还是权限不足,再调整对应账号和目录。


❓ 知识问答

Q1:root 和 alias 可以互换吗?

不可以。前者保留完整请求路径,后者替换匹配前缀。先手算目标文件路径,才能决定用哪个。

Q2:修改 CSS 要重载吗?

一般不用;修改文件映射配置才需要检查并重载。


🧪 小练习

创建 html/chapter/index.html,写入“第一章”,访问 /chapter/;再访问 /chapter/missing.txt。

验收:前者返回 200 和“第一章”,后者返回 404。能分别写出两次访问对应的完整磁盘路径。


🎉 现在每一个静态资源地址都能找到明确的磁盘位置!