Nginx Alias 路径映射中避免 403 如何配

Nginx的alias正确映射且不返回403的核心是路径拼接准确与系统权限到位：alias值须为真实存在的绝对路径（末尾带/），location必须以/结尾精确匹配，Nginx worker进程需对完整路径链具备执行权（x）和读取权（r）。

要让 Nginx 的 alias 正确映射路径且不返回 403，核心不是“绕过权限”，而是确保 Nginx 工作进程能真实触达目标目录——既要路径拼接准确，又要系统级读取权限到位。

路径写法必须严格匹配文件系统真实形态

alias 后面的值是服务器上的绝对路径，它不接受 URL 编码或 Shell 转义。中文、空格、括号等特殊字符直接照原样写，前提是该路径在磁盘上真实存在且可被访问。

1. ✅ 正确：alias /var/www/my site/中文目录/;（末尾斜杠不能少）
2. ❌ 错误：alias /var/www/my%20site/%E4%B8%AD%E6%96%87/;（Nginx 找不到这个路径）
3. ❌ 错误：alias "/var/www/my site/";（反斜杠在 Nginx 配置中无效）

location 必须精确匹配，避免拼接出错

alias 的行为依赖于 location 的 URI 匹配方式。如果 location 定义不严谨，Nginx 可能错误拼接路径，导致访问越界或进入无权限区域。

1. 推荐用带结尾斜杠的精确前缀匹配，例如：location /static/ { alias /data/assets/; }
2. 避免模糊匹配如 location /static { ... }（缺少结尾斜杠），否则请求 /staticfile.txt 会被拼成 /data/assetsfile.txt，大概率 404 或 403
3. 若需支持无后缀访问，确保目标目录下有 index.html，并显式配置 index index.html;

用户权限必须覆盖完整路径链

Nginx 工作进程（非 master 进程）需要对 alias 指向目录及其所有上级目录都有执行权（x），对目标文件有读取权（r）。尤其注意 /root/、/home/xxx/ 等受限目录默认禁止其他用户 traverse。

1. 检查当前 worker 用户：ps aux | grep "nginx: worker"（常见为 nginx 或 nobody）
2. 确认路径权限：namei -l /var/www/my site/中文目录/（逐级显示每层目录的权限和属主）
3. 修复示例：sudo chmod 755 /var/www /var/www/my site /var/www/my site/中文目录；sudo chown -R nginx:nginx /var/www/my site/中文目录

务必验证配置并查错误日志

改完配置别急着 reload，先做两件事：

1. 语法检测：/usr/local/nginx/sbin/nginx -t（路径按实际安装位置调整）
2. 看错误日志：sudo tail -f /var/log/nginx/error.log，触发一次请求，观察是否出现 (13: Permission denied) 或 directory index of "/xxx/" is forbidden 等线索
3. 若日志提示 “no index file”, 补一个 index.html 或加 autoindex on; 临时调试