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 在容器中怎么写才不 404root 要求 URI 前缀在磁盘上真实存在子目录。比如：
- 宿主机有
/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。
