项目部署到子目录时 Nginx Root 怎么配-Nginx-PHP中文网

应优先用alias，因root会将location路径原样拼接导致404（如请求/admin/index.html查找/opt/dist/admin/index.html），而alias精准替换前缀（/admin/→/opt/dist/），配合publicpath设为'/admin/'和try_files兜底，确保spa子目录部署正常。

项目部署到子目录时 nginx root 怎么配

项目部署到子目录（比如 https://example.com/admin/）时，root 不是首选方案，**应优先用 alias**。因为 root 会把 location 路径原样拼接进去，容易导致路径错位、静态资源 404 或白屏；而 alias 能精准替换匹配前缀，语义清晰、行为可控。

为什么 root 在子目录场景容易出错

root 的逻辑是：「请求路径 = root 目录 + 完整 URI」。例如：

配置：location /admin/ { root /opt/dist; }
访问 /admin/index.html → Nginx 实际查找 /opt/dist/admin/index.html
但 Vue 打包后文件都在 /opt/dist/ 下，没有 admin/ 子目录 → 404

除非你手动把整个 dist 内容挪进 /opt/dist/admin/，否则这条路走不通。

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

正确做法：用 alias 精准映射

alias 会把匹配的 location 前缀完全替换为目标路径，适合子目录部署：

确保 vue.config.js 中 publicPath 设为 '/admin/'（结尾斜杠不能少）

Nginx 配置写成：

location /admin/ {
    alias /opt/dist/;
    try_files $uri $uri/ /admin/index.html;
}

注意：alias 后的路径必须以 / 结尾，否则会拼接错误
访问 /admin/xxx.js → 直接读取 /opt/dist/xxx.js，不带多余层级

配套要点不能漏

光配对 alias 还不够，三个环节必须一致：

构建路径：Vue 打包输出目录（如 /opt/dist）要和 alias 指向的物理路径完全一致
资源引用前缀：publicPath 必须与 URL 子路径严格匹配（/admin/ → 生成的 js/css 链接自动带 /admin/ 前缀）
SPA 路由兜底：try_files $uri $uri/ /admin/index.html 中的 /admin/index.html 是相对 URL，对应 alias 下的 index.html