这篇文章发布于2013年,介绍如何为nginx设置一个404页面,当客户端试图访问一个并不存在的资源时,nginx会返回代码为404的错误信息"404 Not Found",这个错误信息非常简陋并且不是很友好,建议根据实际需求设置一个专用的404错误页面(如果没有要求可以使用下面的“腾讯公益宝贝回家”404页面,也许一个微不足道的举动,却已帮助了别人。两全其美哈)。
操作步骤
1. 准备一个 404 HTML文档文档内容随意。
例如将HTML文档内容设置为“腾讯公益宝贝回家”,404将会返回失踪儿童信息。
代码语言:javascript复制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; 例如:
代码语言:javascript复制server
{
listen 80;
server_name zongming.net;
#... 其它配置项省略
error_page 404 /404.html;
}
3. 重启nginx
代码语言:javascript复制nginx -t && nginx reload
error_page 指令
代码语言:javascript复制语法: error_page code [ code… ] [ = | =answer-code ] uri | @named_location
默认值: no
使用字段: http, server, location, location 中的if字段
功能: 这个参数可以为错误代码指定相应的错误页面。
示例
代码语言:javascript复制error_page 404 /404.html;
error_page 502 503 504 /50x.html;
error_page 403 http://example.com/forbidden.html;
error_page 404 = @fetch;
也可以将原有的响应代码修改为另一个响应代码:
代码语言:javascript复制error_page 404 =200 /empty.gif;
error_page 404 =403 /forbidden.gif;
另外还可以使用等号(=)指定你自己编写的错误处理程序返回相应的响应代码:
代码语言:javascript复制error_page 404 = /404.php;
如果在重定向时不需要改变URI,可以将错误页面重定向到一个命名的location字段中:
代码语言:javascript复制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" 。
代码语言:javascript复制grep 'intercept' /etc/nginx/nginx.conf
fastcgi_intercept_errors on;
2. 不要忘记重启nginx
代码语言:javascript复制nginx -t && nginx reload
3. fastcgi_intercept_errors 指令
代码语言:javascript复制语法: fastcgi_intercept_errors on|off
默认值: fastcgi_intercept_errors off
使用字段: http, server, location
功能: 这个指令指定是否传递4xx和5xx错误信息到客户端,或者允许nginx使用error_page处理错误信息。
小结
最后来总结下文章中的知识点
- 使用 error_page指令为nginx 指定404错误页面。
- 对于 php-fpm等上游服务器,需要搭配 fastcgi_intercept_errors指令使用。
参考
nginx error_page指令 http://zongming.net/read-347