Web 服务器与网关 / 系统课时

处理错误页面与访问权限

处理错误页面与访问权限

本课解决静态站点部署后常见的 403 无权限访问和 404 文件不存在问题,通过配置错误页面、检查 Nginx 用户权限和目录访问条件,建立完整的故障定位流程。

学习目标

  • 配置 Nginx 自定义错误页面。
  • 排查文件、目录和运行用户权限问题。
  • 根据日志快速定位静态站点访问失败原因。

认识静态站点错误来源

静态文件访问失败通常来自三类原因:请求路径不存在、Nginx 无法读取文件、目录访问策略阻止访问。

404 表示请求资源不存在,重点检查 URL 与文件路径映射;403 表示资源存在但访问被拒绝,重点检查权限、目录索引和安全策略。

配置自定义错误页面

Nginx 可以通过 error_page 将错误请求转发到指定页面,让用户看到友好的提示,同时保持服务器返回正确状态码。

nginx
server {
    listen <PORT>;
    server_name example.com;
    root /var/www/site;

    error_page 404 /404.html;
    error_page 403 /403.html;

    location = /404.html {
        internal;
    }

    location = /403.html {
        internal;
    }
}

预期结果

text
访问不存在文件时返回 HTTP 404,并展示 /404.html 内容。
访问无权限资源时返回 HTTP 403,并展示 /403.html 内容。

排查 403 权限问题

Nginx worker 进程通常不是 root 用户运行。如果站点目录或文件权限不允许该用户读取,即使文件存在也会返回 403。可以先检查目录链路权限:

bash
namei -l /var/www/site/index.html
ls -l /var/www/site/index.html

预期输出

text
f: /var/www/site/index.html
drwxr-xr-x root root /var
-rw-r--r-- nginx nginx index.html

检查结果应确保 Nginx 运行用户具备目录执行权限和文件读取权限。

检查目录遍历与安全策略

如果请求目录而目录中没有默认首页,同时又关闭了目录列表,Nginx 可能返回 403。生产环境通常关闭目录浏览,避免暴露文件结构。

nginx
location /files/ {
    autoindex off;
}

预期结果

text
访问 /files/ 且无 index 文件时返回 HTTP 403。

如果权限看起来正确,还需要检查 SELinux、安全模块、防火墙策略或挂载参数是否阻止访问。

建立故障定位顺序

排查静态站点错误时,应先看 Nginx 错误日志,再确认配置映射,然后检查文件权限。不要直接修改权限扩大范围,应先确认真正失败的环节。

bash
tail -f /var/log/nginx/error.log

预期输出

text
open() "/var/www/site/missing.html" failed (2: No such file or directory)

日志中的 No such file or directory 通常对应路径错误,而 Permission denied 通常对应权限问题。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

处理错误页面与访问权限

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通