让网址找到正确的静态文件
🎯 引言
首页能打开后,下一步是放入样式和下载资料。本篇解决“浏览器请求一个路径时,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",保存:
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。能分别写出两次访问对应的完整磁盘路径。
🎉 现在每一个静态资源地址都能找到明确的磁盘位置!
