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

部署前端静态资源站点

部署前端静态资源站点

前端首页能打开,不代表深层路由、脚本缓存和缺失资源都正确。本篇创建一组带真实内容哈希的最小实验文件,验证 SPA 回退与资源 404 分离,再说明正式构建产物应怎样保持版本一致和可回退。

学习目标

  • 托管一组一致的 HTML 与带哈希脚本。
  • 让页面路由回退,同时保持缺失资源和 API 的错误语义。
  • 区分入口重新验证与不可变资源长缓存。

创建最小实验文件

需要 Linux、Python 3、Nginx 1.28、curl 和空闲回环 8080。下面是完整准备程序;它手工生成教学文件,不是任何前端框架的实际构建:

python
from pathlib import Path
from hashlib import sha256

root = Path('/tmp/nginx-web-entry')
assets = root / 'assets'
assets.mkdir(parents=True, exist_ok=True)
script = b'document.body.textContent = "frontend-v1";\n'
name = f'app.{sha256(script).hexdigest()[:12]}.js'
(assets / name).write_bytes(script)
(root / 'asset-name.txt').write_text(name)
(root / 'index.html').write_text(
    f'<!doctype html><meta charset="utf-8"><script defer src="/assets/{name}"></script>'
)
print('prepared')

预期输出 prepared;目录内包含入口、脚本与供实验命令读取的文件名。浏览器加载正确文件后应显示 frontend-v1,画面需要在浏览器单独验收。

分离三种路径行为

仅页面路由允许回退,资源和 API 各自保留错误响应

以下片段示例放在 http,替换当前独立实验站点,不能与另一份同端口同名规则盲目叠加:

nginx
server {
    listen 127.0.0.1:8080;
    server_name app.test;
    root /tmp/nginx-web-entry;
    types { text/html html; application/javascript js; }
    default_type application/octet-stream;
    location = /index.html {
        add_header Cache-Control "no-cache";
    }
    location ^~ /assets/ {
        try_files $uri =404;
        add_header Cache-Control "public, max-age=31536000, immutable";
    }
    location ^~ /api/ { return 404; }
    location / { try_files $uri $uri/ /index.html; }
}

预期生效行为:页面路由回退到 index.html;缺失脚本和尚未接入的 API 返回 404。资源的长缓存头未使用 always,避免给缺失资源的 404 添加这项长期策略。try_files 行为见 官方说明。

对照正常与错误路径

检查并重载后执行完整命令:

bash
asset=$(cat /tmp/nginx-web-entry/asset-name.txt)
for path in / /account "/assets/$asset" /assets/missing.js /api/unknown; do
  curl --noproxy '*' --resolve app.test:8080:127.0.0.1 -sS -o /dev/null -w '%{http_code}\n' "http://app.test:8080$path"
done

预期输出:

text
200
200
200
404
404

还应检查首页和 /account 正文为同一个入口 HTML、脚本类型为 application/javascript,入口的 Cache-Control 为 no-cache,而脚本有长期不可变策略。no-cache 允许保存但要求复用前重新验证,不等于 no-store。

发布时保持资源引用一致

正式环境部署实际构建输出,确认框架的资源基础路径与站点路径一致。不能改变某个哈希文件名对应的内容;新版本应有新哈希,并保留旧资源一段时间,让仍持有旧 HTML 的客户端能正常加载。

以一个版本目录包含 HTML 和资源,受控切换并保留上一可用版本。Worker 需要目录遍历和文件读取权限,不应拥有无必要的写入权限,也不应通过开放目录列表暴露调试产物。

最后测试硬刷新、深层路由直达、旧资源引用和缺失脚本。不能用把所有路径都改成 HTML 200 的方式掩盖错误,否则 API 和脚本加载失败会更难定位。

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

目录与阅读设置

阅读设置

17

记录一个想法

部署前端静态资源站点

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

登录哪都通