Return custom nginx error from within named location

Question

I have a configuration where I want to return a custom error from within a named location. However, instead I receive the standard nginx error page. I can get the custom error from a non-named location though.

To reproduce the issue, I created this simple docker-based setup:

Dockerfile:

FROM nginx:1.17.9

COPY default.conf /etc/nginx/conf.d/default.conf
COPY 404.html /usr/share/nginx/html/404.html

default.conf:

server {
    listen       80;
    server_name  localhost;

    #recursive_error_pages on;

    location = /404.html {
        root   /usr/share/nginx/html;
        internal;
    }

    # redirect server error pages to the static page /50x.html
    #
    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   /usr/share/nginx/html;
    }

    location / {
        # used in a more complex setup, this is just a minimal config
        # # See http://stackoverflow.com/a/20694873
        error_page 404 = @fwd;
        return 404;
    }

    location @fwd  {
       root /usr/share/nginx;
       error_page 404 /404.html;
    }
}

The 50x errors are not interesting here, I've adapted the config from the nginx docker image.

Uing something other than 404 to redirect to the named location does not make a difference.

404.html:

<!DOCTYPE html>
<html>
  <head><title>404</title></head>
  <body>
    my 404
  </body>
</html>

Build: docker build -t mynginx . and start docker run --rm -p 8080:80 --name mynginx mynginx.

Now pointing the browser to http://localhost:8080/index.html should return the standard welcome page, while http://localhost:8080/inexistent.html will return a internal nginx 404 page, not the custom one I configured.

Is there a way to actually make this work from within the named location?

Try: try_files /404.html =404;

Richard Smith
– Richard Smith

2020-03-23 19:21:20 +00:00
Commented Mar 23, 2020 at 19:21 — Richard Smith
– Richard Smith, Commented Mar 23, 2020 at 19:21
Where do you suggest I should use this?

petre
– petre

2020-03-23 20:23:03 +00:00
Commented Mar 23, 2020 at 20:23 — petre
– petre, Commented Mar 23, 2020 at 20:23
In the named location.

Richard Smith
– Richard Smith

2020-03-23 20:24:18 +00:00
Commented Mar 23, 2020 at 20:24 — Richard Smith
– Richard Smith, Commented Mar 23, 2020 at 20:24

petre · Accepted Answer · 2020-03-24 07:45:08Z

2

While exploring the problem, I found out about recursive_error_pages on; -- but stupidly left it commented. Naturally it didn't help.

Un-commenting that directive fixes the issue!

answered Mar 24, 2020 at 7:45

petre

1,57315 silver badges25 bronze badges

Sign up to request clarification or add additional context in comments.

Collectives™ on Stack Overflow

Return custom nginx error from within named location

1 Answer 1

Comments

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

1 Answer 1

Comments

Your Answer

Sign up or log in

Post as a guest

Related