如何在Nginx中实现多路径共用同一index.html或双向重定向？

核心配置（无需重定向，双路径均加载同一HTML） #

假设你的静态文件存放在容器内/usr/share/nginx/html目录，主入口文件为index.html，以下配置可实现访问www.example.com和www.example.com/subdir时加载同一文件，同时解决403错误：

server {
    listen 80;
    server_name www.example.com;

    # 处理根路径访问
    location / {
        root /usr/share/nginx/html;
        # 优先匹配静态文件，不存在则返回index.html
        try_files $uri $uri/ /index.html;
    }

    # 处理/subdir路径，映射到根目录文件（无需复制）
    location /subdir {
        alias /usr/share/nginx/html;
        # 这里用/subdir/index.html是因为alias会替换路径，确保指向正确文件
        try_files $uri $uri/ /subdir/index.html;
    }

    # 统一处理静态资源，避免路径错误导致404
    location ~* \.(css|js|png|jpg|svg|html)$ {
        root /usr/share/nginx/html;
        expires 30d; # 可选：设置静态资源缓存
    }
}

解决403 Forbidden的关键要点 #

1. 路径正确性：确保root/alias指向的目录在容器内真实存在，官方Nginx镜像默认静态目录为/usr/share/nginx/html，不要写错路径。
2. 文件权限：如果是本地目录挂载到容器，需确保目录权限为Nginx进程可读取（官方镜像用nginx用户，可执行chmod 755 your-local-dir或启动容器时添加--user nginx）。
3. 禁用目录索引：不要开启autoindex on，否则Nginx会尝试列出目录内容，无权限时返回403；通过try_files直接指定入口文件即可。

双向重定向配置（可选） #

如果需要实现“访问根域名自动跳转到/subdir”或反向跳转，可替换对应location块：

根域名跳转至/subdir（301永久重定向）

location / {
    return 301 /subdir/;
}

location /subdir {
    root /usr/share/nginx/html;
    try_files $uri $uri/ /subdir/index.html;
}

/subdir跳转至根域名

location /subdir {
    return 301 /;
}

location / {
    root /usr/share/nginx/html;
    try_files $uri $uri/ /index.html;
}

Docker部署步骤 #

1. 编写上述Nginx配置文件，命名为default.conf。
2. 编写Dockerfile：

FROM nginx:alpine
# 复制静态文件到容器目录
COPY ./your-static-files/ /usr/share/nginx/html/
# 替换默认Nginx配置
COPY ./default.conf /etc/nginx/conf.d/default.conf

3. 构建并运行容器：

docker build -t my-static-site .
docker run -d -p 80:80 my-static-site

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