Web 服务器与网关 / 系统课时

用 root 托管一个静态网站

用 root 托管一个静态网站

把 HTML 放到服务器上之后,还要让请求路径正确映射到文件。本篇准备一个包含 CSS、JavaScript 与 SVG 图片的最小站点,使用 root 托管,并分别检查首页与资源响应,避免只看首页正常就忽略资源失败。

学习目标

  • 用 root 将请求路径映射为磁盘文件路径。
  • 为简单静态站点配置首页与 MIME 类型。
  • 分别验证 HTML、脚本、样式和图片是否可访问。

准备完整的小站点

在安装了 Nginx 的 Linux 练习机执行下面的完整命令。文件保存在专用临时目录,适合实验;生产发布应放到有明确权限和版本管理的站点目录。

bash
set -e
# 四类文件必须一起部署,不能只复制 HTML 首页。
mkdir -p /tmp/nginx-static-site/assets
cat > /tmp/nginx-static-site/index.html <<'HTML'
<!doctype html>
<html lang="zh-CN">
<head><meta charset="utf-8"><title>Static Lab</title>
<link rel="stylesheet" href="/assets/site.css"></head>
<body><h1 id="title">Static Lab</h1>
<img src="/assets/logo.svg" alt="绿色圆形" width="40" height="40">
<script src="/assets/app.js"></script></body></html>
HTML
printf '%s\n' 'body { color: #2b6f6d; }' > /tmp/nginx-static-site/assets/site.css
printf '%s\n' 'document.getElementById("title").textContent = "Static ready";' > /tmp/nginx-static-site/assets/app.js
# SVG 是练习站点的真实文件,不依赖远程图片地址。
printf '%s\n' '<svg xmlns="http://www.w3.org/2000/svg" width="40" height="40"><circle cx="20" cy="20" r="18" fill="#2b6f6d"/></svg>' > /tmp/nginx-static-site/assets/logo.svg

预期结果:目录中出现一个 HTML 文件和三个资源文件,命令正常结束且没有额外控制台输出。以上内容是实际站点代码,SVG 只用于检验图片请求,与课程正文配图无关。

配置根目录与内容类型

片段示例:下列站点块放入主配置的 http 上下文或其 include 的站点文件。假设发行版提供 /etc/nginx/mime.types;若安装路径不同,先查到对应文件再替换该路径。

nginx
server {
    listen 127.0.0.1:8080;
    server_name static.test;
    root /tmp/nginx-static-site;
    index index.html;
    # 根据扩展名发送 CSS、脚本和 SVG 等文件的内容类型。
    include /etc/nginx/mime.types;
    location / { try_files $uri $uri/ =404; }
}

/assets/app.js 会在本例中映射为 /tmp/nginx-static-site/assets/app.js。root 后面不必再写 /assets,否则会把这段路径重复拼接。文件名大小写也要与请求一致;Linux 上 app.js 与 App.js 通常是不同文件。

检查资源而非只检查首页

检查并重载配置后,在本机执行:

bash
# 分别请求入口和三类资源,隐藏响应体,仅核对 HTTP 状态。
for path in / /assets/site.css /assets/app.js /assets/logo.svg; do
    curl -sS -o /dev/null -H 'Host: static.test' -w 'status=%{http_code}\n' "http://127.0.0.1:8080$path"
done

预期输出:

text
status=200
status=200
status=200
status=200

可再用 curl -I 查看各响应 Content-Type:首页应为 HTML、样式为 CSS、图片为 SVG;JavaScript 的具体标准类型字符串应以当前 MIME 配置为准。浏览器真正执行脚本后,标题应成为 Static ready,文字为青绿色且显示圆形图片;HTTP 200 本身不能证明脚本已经执行成功。

文件存在仍可能访问失败

Worker 用户需要对路径上的每级目录拥有进入权限,对文件拥有读取权限。生产目录不要使用全员可写权限来修复 403,应根据错误日志核对属主、组和访问控制。请求不存在的文件应得到 404,不应被误返回首页 HTML;否则脚本加载错误可能被 200 状态掩盖。

站点根目录只放可公开提供的文件,不应包含私钥、备份、源码仓库或环境配置。临时目录还可能被系统清理,完成练习后应将真实部署路径、文件清单和权限检查纳入发布步骤。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 root 托管一个静态网站

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通