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

部署单页应用

部署单页应用

本课解决前端单页应用部署后的路由问题。通过发布构建产物并配置 try_files 回退规则,可以让 Vue、React 等 History 模式应用在刷新任意页面时仍然返回入口文件,同时避免静态资源和后端接口被错误转发。

学习目标

  • 理解单页应用静态部署的文件访问模型。
  • 掌握 try_files 的页面路由回退配置。
  • 能区分前端路由、静态资源和后端接口路径。

准备前端构建产物

单页应用生产构建后通常生成 HTML、JavaScript、CSS 和图片字体等静态文件。部署时只需要将这些文件放入 Nginx 的站点目录,由 Nginx 直接提供访问。

bash
cp -r dist/* /var/www/app/
ls /var/www/app

预期输出

text
index.html
assets
favicon.ico

配置 History 路由回退

浏览器访问 /user/profile 时,服务器默认会寻找同名文件。如果应用使用前端路由,该路径通常不存在,因此需要通过 try_files 将不存在的路径交给入口文件处理。

nginx
server {
    listen <PORT>;
    server_name app.example.com;

    root /var/www/app;

    location / {
        try_files $uri $uri/ /index.html;
    }
}

预期结果

text
访问 /user/profile
如果存在真实文件则返回文件
如果不存在则返回 /index.html,由前端路由接管

区分静态资源与后端接口

实际项目中通常同时存在页面路由和 API 请求。静态资源需要由 Nginx 返回,接口请求则应该转发到后端服务,避免所有路径都回退到 index.html。

nginx
location /api/ {
    proxy_pass http://backend;
}

location / {
    try_files $uri $uri/ /index.html;
}

预期结果

text
/api/users 请求进入后端服务
/assets/app.js 直接返回静态文件
/profile 页面路由返回 index.html

验证部署效果

部署完成后,需要分别测试入口页面、静态资源和前端路由。出现刷新 404 时,通常检查 try_files 是否存在以及 index.html 是否位于 root 指定目录。

bash
curl -I http://app.example.com/profile

预期结果

text
HTTP/1.1 200 OK
Content-Type: text/html
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

部署单页应用

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

登录哪都通