nginx 自定义403返回页面

2023-10-13 09:40小洋- Nginx

因公司内部域名通常用白名单的方式来进行域名访问限制，想要自定义 403 返回页面，下面是详细步骤，有需要的同学跟着了解下

背景

因公司内部域名通常用白名单的方式来进行域名访问限制，想要自定义 403 返回页面

配置

1、开启允许 nginx 使用 error_page 处理错误信息

fastcgi_intercept_errors on;

因为只涉及 nginx ip 白名单，所以只需要开启 fastcgi_intercept_errors 即可，如果需要自定义上游/代理服务器的状态吗，则需要开启 proxy_intercept_errors

2、关于 error_page 配置

error_page 403 /403.html 可显示自定义403页面内容，正常返回403状态码。
error_page 403 = /403.html 可显示自定义403页面内容，但返回200状态码。

3、ssi 配置

开启 ssi 配置就可以在 html 文件中使用 nginx 中的自有变量

以下配置就可以展示 nginx 中的 $remote_addr 变量

4、具体配置

也可以配置成返回固定的 html 文件

fastcgi_intercept_errors on;
error_page 403 /custom_403.html; #自定义错误页面 uri
location = /custom_403.html {
    ssi on;  # 使html支持读取变量
    ssi_silent_errors on;  # 默认值是off，开启后在处理SSI文件出错时不输出错误提示
    add_header Content-Type 'text/html';
    add_header X-Frame-Options 'SAMEORIGIN';
    return 403 '