Handling OPTIONS request in nginx

Question

We're using HAProxy as a load balancer at the moment, and it regularly makes requests to the downstream boxes to make sure they're alive using an OPTIONS request:

OPTIONS /index.html HTTP/1.0

I'm working with getting nginx set up as a reverse proxy with caching (using ncache). For some reason, nginx is returning a 405 when an OPTIONS request comes in:

192.168.1.10 - - [22/Oct/2008:16:36:21 -0700] "OPTIONS /index.html HTTP/1.0" 405 325 "-" "-" 192.168.1.10

When hitting the downstream webserver directly, I get a proper 200 response. My question is: how to you make nginx pass that response along to HAProxy, or, how can I set the response in the nginx.conf?

Is this module available yet by any chance?

user318576
– user318576

2010-04-16 14:29:54 +00:00
Commented Apr 16, 2010 at 14:29 — user318576
– user318576, Commented Apr 16, 2010 at 14:29

sbrajchuk · Accepted Answer · 2023-11-01 18:18:31Z

55

I'm probably late, but I had the same problem, and found two solutions to it.

First is tricking Nginx that a 405 status is actually a 200 OK and then proxy_pass it to your HAProxy like this:

error_page 405 =200 @405;
location @405 {
    root /;
    proxy_pass http://yourproxy:8080;
}

The second solution is just to catch the OPTIONS request and build a response for those requests:

location / {
    if ($request_method = OPTIONS ) {
        add_header Content-Length 0;
        add_header Content-Type text/plain;
        return 200;
    }
}

Just choose which one suits you better.

I wrote this in a blog post where you can find more details.

edited Nov 1, 2023 at 18:18

sbrajchuk

3514 silver badges11 bronze badges

answered Feb 8, 2012 at 16:14

rogeriopvl

54.7k8 gold badges58 silver badges58 bronze badges

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

2 Comments

wal Over a year ago

suppose you have proxy_pass already set up - is there a reason why nginx doesn't just forward the OPTIONS request without having to do the first trick? basically a way of saying 'don't you go interpreting the HTTP verb just forward it like i already said'

Diana Over a year ago

I'm trying this but if ($request_method = OPTIONS) does not seem to be working, the request is sent to my backend. Is there a new syntax?

Mark Rose · Accepted Answer · 2011-01-11 21:27:12Z

2

In the httpchk option, you can specify the HTTP method like this:

httpchk GET http://example.com/check.php

You can also use POST, or a plain URI like /. I have it check PHP, since PHP runs external to Nginx.

answered Jan 11, 2011 at 21:27

Mark Rose

9819 silver badges15 bronze badges

Collectives™ on Stack Overflow

Handling OPTIONS request in nginx

2 Answers 2

2 Comments

Comments

Your Answer

Linked

Hot Network Questions

Collectives™ on Stack Overflow

2 Answers 2

2 Comments

Comments

Your Answer

Sign up or log in

Post as a guest

Linked

Related