docker中nginx的root与alias选择取决于挂载方式：整目录挂载时root可直接使用，需确保uri前缀在挂载路径下真实存在；单文件挂载难适配二者；alias适用于子路径映射（如/api/docs/→/swagger-ui/），要求alias值末尾带/且路径有读权限。

Nginx 在容器化环境中处理 root 和 alias，核心不是改指令逻辑，而是让指令行为与 Docker 挂载路径对齐。挂载方式决定了磁盘结构是否“存在”，而 root 依赖结构存在，alias 跳过结构——所以选哪个，得先看你怎么挂。

挂载方式决定 root/alias 的适用性
Docker 挂载分两类：整目录挂载（推荐）、单文件挂载（不推荐）。

• 整目录挂载（如 -v /host/static:/usr/share/nginx/html）→ 容器内 /usr/share/nginx/html 下直接呈现宿主机内容，层级清晰
• 单文件挂载（如 -v /host/app.css:/usr/share/nginx/html/css/app.css）→ 路径零散、不可维护，root 和 alias 都难适配

只要用整目录挂载，root 和 alias 就能按原逻辑工作，无需特殊调整。

root 在容器中怎么写才不 404
root 要求 URI 前缀在磁盘上真实存在子目录。比如：

Nginx Hosting

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

下载

• 宿主机有 /opt/web/dist/，你挂载为 -v /opt/web/dist:/usr/share/nginx/html
• 想让 /admin/ 访问 dist 下的资源，不能写：

  location /admin/ { root /usr/share/nginx/html; }

  因为它会去找 /usr/share/nginx/html/admin/ —— 但你挂的 dist 目录里可能根本没有 admin/ 子目录。

正确做法是：

• 把整个 dist 当作站点根，用 location / { root /usr/share/nginx/html; }
• 或者把 admin 目录单独挂载：-v /opt/web/admin:/usr/share/nginx/admin，再配 location /admin/ { root /usr/share/nginx; }

alias 更适合子路径映射场景
当你无法或不想调整宿主机目录结构时，alias 是更稳妥的选择。例如：

• 宿主机 Swagger UI 文件在 /opt/swagger-ui/，你想通过 /api/docs/ 访问
• 挂载：-v /opt/swagger-ui:/usr/share/nginx/swagger-ui:ro
• 配置：

  location /api/docs/ {
      alias /usr/share/nginx/swagger-ui/;
  }

  请求 /api/docs/index.html → 实际读 /usr/share/nginx/swagger-ui/index.html
  注意两点：alias 值末尾必须带 /；location 也建议以 / 结尾，避免拼接错误。

Docker + Nginx 启动时的路径一致性检查
容器启动后，先进入容器验证路径是否存在且可读：

docker exec -it nginx-container ls -l /usr/share/nginx/html
docker exec -it nginx-container cat /etc/nginx/nginx.conf | grep -A2 "location"

如果 root 对应路径下没有匹配的子目录，或 alias 路径不存在/无读权限，Nginx 不报错但返回 404。常见权限问题：宿主机证书或静态文件未开放 other 读权限（chmod -R o+r），尤其 Alpine 镜像中 nginx 用户 UID 为 101。