如何在NGINX中设置自定义503错误页面?

时间:2011-04-08 20:29:33

标签: nginx

我学会了如何让NGINX返回503客户错误页面, 但我无法找到如何做到以下几点:

示例配置文件:

    location / {
        root   www;
        index  index.php;
        try_files /503.html =503;
    }

    error_page 503 /503.html;
    location = /503.html {
        root   www;
    }

如您所见,根据上面的代码,如果在我的根目录中找到名为503.html的页面,该站点将向用户返回此页面。

似乎虽然上面的代码可以在有人只是访问我的网站时输入

它不会捕获像:

这样的请求

使用我的代码,用户仍然可以看到个人资料页面或index.php以外的任何其他页面。

问题:

如果我的根文件夹中存在503.html,我如何将请求捕获到我网站中的所有网页并将其转发到503.html

4 个答案:

答案 0 :(得分:7)

以下配置适用于接近最新的稳定nginx 1.2.4。 我找不到使用if启用维护页面的方法,但显然根据IfIsEvil它是正常的if

  • 启用维护touch /srv/sites/blah/public/maintenance.enable。您可以rm要禁用该文件。
  • 错误502将映射到503,这是大多数人想要的。您不希望向Google提供502
  • 自定义502503页面。您的应用将生成其他错误页面。

网络上还有其他配置,但它们似乎不适用于最新的nginx。

server {
    listen       80;
    server_name blah.com;

    access_log  /srv/sites/blah/logs/access.log;
    error_log  /srv/sites/blah/logs/error.log;

    root   /srv/sites/blah/public/;
    index  index.html;

    location / {
        if (-f $document_root/maintenance.enable) {
            return 503;
        }
        try_files /override.html @tomcat;
    }

    location = /502.html {
    }

    location @maintenance {
       rewrite ^(.*)$ /maintenance.html break;
    }

    error_page 503 @maintenance;
    error_page 502 =503 /502.html;

    location @tomcat {
         client_max_body_size 50M;

         proxy_set_header  X-Real-IP  $remote_addr;
         proxy_set_header  X-Forwarded-For $proxy_add_x_forwarded_for;
         proxy_set_header  Host $http_host;
         proxy_set_header  Referer $http_referer;
         proxy_set_header  X-Forwarded-Proto http;
         proxy_pass http://tomcat;
         proxy_redirect off;
    }
}

答案 1 :(得分:6)

已更新:将“if -f”更改为“try_files”。

试试这个:

server {
    listen      80;
    server_name mysite.com;
    root    /var/www/mysite.com/;

    location / {
        try_files /maintenance.html $uri $uri/ @maintenance;

        # When maintenance ends, just mv maintenance.html from $root
        ... # the rest of your config goes here
     }

    location @maintenance {
      return 503;
    }

}

更多信息:

https://serverfault.com/questions/18994/nginx-best-practices

http://wiki.nginx.org/HttpCoreModule#try_files

答案 2 :(得分:4)

其他答案都是正确的,但只是要补充一点,如果您使用内部代理,则还需要在其中一个代理服务器上添加proxy_intercept_errors on;

所以例如......

    proxy_intercept_errors on;
    root /var/www/site.com/public;
    error_page 503 @503;
    location @503 {
       rewrite ^(.*)$ /scripts/503.html break;
    }

答案 3 :(得分:0)

几年后,这是我目前用于完全自定义错误消息的内容。

HTML错误页面存储在站点根目录中的/ http-error目录中。

我在here处创建了NGINX PHP-FPM快速设置指南,您可以在其中学习如何启动服务器,下载准备使用的错误页面模板等。

list