NGINX配置的root路径未生效，自定义目录文件无法被访问

别着急，我来帮你搞定这个问题，尤其是Docker环境下的Nginx配置，核心还是配置细节和容器挂载权限的问题，咱们一步步来梳理：

一、正确的配置示例 #

假设你的自定义配置文件是/etc/nginx/conf.d/my-site.conf，可以参考下面的写法：

server {
    listen 80;
    server_name localhost; # 换成你的域名或者保持localhost都可以

    # 场景1：访问http://localhost/my-files/ 时，指向/mirrors/my-folder目录
    location /my-files/ {
        alias /mirrors/my-folder/;
        # 可选：开启目录索引，方便直接浏览文件列表
        autoindex on;
        # 可选：给静态文件加缓存，提升访问速度
        expires 30d;
    }

    # 场景2：如果想让根路径（http://localhost/）直接指向自定义目录
    # 这种情况用root更合适，注意root的路径就是你的自定义目录本身
    # location / {
    #     root /mirrors/my-folder;
    #     index index.html index.htm;
    # }
}

这里要重点区分alias和root的差异，很多人容易搞混：

• root：Nginx会把location的路径拼在root指定的路径后面。比如root /mirrors; location /my-files/，实际访问的是/mirrors/my-files/
• alias：Nginx会把location的路径直接替换成alias的路径。比如上面的场景1，location /my-files/对应/mirrors/my-folder/，注意两边的斜杠要统一（都加或者都不加），不然会出现路径拼接错误导致404。

二、Docker环境下的必查要点 #

因为你是在Docker里运行Nginx，还有几个关键问题必须排查：

1. 目录挂载是否正确 #

容器本身是隔离的，如果你宿主机的/mirrors/my-folder没挂载到容器里，容器内根本找不到这个目录！启动容器的时候一定要加挂载参数：

docker run -d -p 80:80 -v /宿主机实际路径/mirrors/my-folder:/mirrors/my-folder nginx

如果是用docker-compose，就在volumes里加上：

volumes:
  - /宿主机实际路径/mirrors/my-folder:/mirrors/my-folder

2. 目录权限是否足够 #

Nginx在容器里一般是以nginx用户运行的，你要确保容器内的/mirrors/my-folder和里面的文件对nginx用户有读权限。可以进入容器执行：

# 进入容器
docker exec -it your-nginx-container bash
# 修改权限
chmod -R 755 /mirrors/my-folder

3. 配置是否生效 #

修改配置后，一定要重载Nginx配置或者重启容器：

# 重载配置（不用重启容器）
docker exec your-nginx-container nginx -s reload
# 或者直接重启容器
docker restart your-nginx-container

三、排查步骤 #

如果还是不行，按下面的步骤逐一排查：

• 先确认容器内存在目标目录：docker exec your-nginx-container ls /mirrors/my-folder，看能不能列出文件
• 检查配置语法是否正确：docker exec your-nginx-container nginx -t，如果有错误会直接提示哪里出问题
• 查看Nginx日志找线索：docker logs your-nginx-container，如果是403就是权限问题，404就是路径/挂载问题，根据日志提示调整就行

内容的提问来源于stack exchange，提问作者jeromes