如何为Nginx设置404页面？

用户1560186

发布于 2019-11-20 17:07:29

5.6K0

发布于 2019-11-20 17:07:29

文章被收录于专栏：运维录运维录

开始之前

这篇文章发布于2013年，介绍如何为nginx设置一个404页面，当客户端试图访问一个并不存在的资源时，nginx会返回代码为404的错误信息"404 Not Found"，这个错误信息非常简陋并且不是很友好，建议根据实际需求设置一个专用的404错误页面(如果没有要求可以使用下面的“腾讯公益宝贝回家”404页面，也许一个微不足道的举动，却已帮助了别人。两全其美哈)。

操作步骤

1. 准备一个 404 HTML文档文档内容随意。

例如将HTML文档内容设置为“腾讯公益宝贝回家”，404将会返回失踪儿童信息。

cat 404.html

<html>
<head>
<title>404您访问的页面不存在</title>
</head>
<body>
<script type="text/javascript" src="http://www.qq.com/404/search_children.js" charset="utf-8"></script>
</body>
</html>

2. 配置 error_page

在 server字段加入 error_page 404 = /404.html; 例如:

server
{

    listen      80;
    server_name zongming.net;
    #... 其它配置项省略
    error_page 404 /404.html;

}

3. 重启nginx

nginx -t && nginx reload

error_page 指令

语法: error_page code [ code… ] [ = | =answer-code ] uri | @named_location
默认值: no
使用字段: http, server, location, location 中的if字段
功能: 这个参数可以为错误代码指定相应的错误页面。

示例

error_page  404          /404.html;
error_page  502 503 504  /50x.html;
error_page  403          http://example.com/forbidden.html;
error_page  404          = @fetch;

也可以将原有的响应代码修改为另一个响应代码:

error_page  404 =200 /empty.gif;
error_page  404 =403 /forbidden.gif;

另外还可以使用等号(=)指定你自己编写的错误处理程序返回相应的响应代码:

error_page   404  =  /404.php;

如果在重定向时不需要改变URI，可以将错误页面重定向到一个命名的location字段中:

location / (
    error_page 404 @fallback;
)

location @fallback (
    proxy_pass http://backend;
)

FastCGI服务器

需要注意的是，对于FastCGI上游服务器来说它会返回自己的错误信息，如图中的php-fpm会抛出"File not found."。

如果你希望它们使用相同的404错误页面，那么你需要指定 fastcgi_intercept_errors 指令。

1. 配置 fastcgi_intercept_errors 指令为"on" 。

grep 'intercept' /etc/nginx/nginx.conf
  fastcgi_intercept_errors on;

2. 不要忘记重启nginx

nginx -t && nginx reload

3. fastcgi_intercept_errors 指令

语法: fastcgi_intercept_errors on|off
默认值: fastcgi_intercept_errors off
使用字段: http, server, location
功能: 这个指令指定是否传递4xx和5xx错误信息到客户端，或者允许nginx使用error_page处理错误信息。