How to add a response header on nginx when using proxy pass

Question

I want to add a custom header for the response received from the server behind nginx   While add header works for nginx-processed responses  it does nothing when the proxy pass is used

User · Answer

As oliver writes      add header works as well with proxy pass as without    However  as Shane writes  as of Nginx 1 7 5  you must pass always in order to get add header to work for error responses  like so   add header  X-Upstream   upstream addr always

User · Answer

Hide response header and then add a new custom header value  Adding a header with add header works fine with proxy pass  but if there is an existing header value in the response it will stack the values    If you want to set or replace a header value  for example replace the Access-Control-Allow-Origin header to match your client for allowing cross origin resource sharing  then you can do as follows     1  hide the Access-Control-Allow-Origin from the server response proxy hide header Access-Control-Allow-Origin    2  add a new custom header that allows all   origins instead add header Access-Control-Allow-Origin      So proxy hide header combined with add header gives you the power to set replace response header values   Similar answer can be found here on ServerFault   UPDATE   Note  proxy set header is for setting request headers before the request is sent further  not for setting response headers  these configuration attributes for headers can be a bit confusing

User · Answer

add header works as well with proxy pass as without  I just today set up a configuration where I ve used exactly that directive  I have to admit though that I ve struggled as well setting this up without exactly recalling the reason  though   Right now I have a working configuration and it contains the following  among others    server       server name   myserver com     location             proxy pass  http   mybackend          add header  X-Upstream   upstream addr            Before nginx 1 7 5 add header worked only on successful responses  in contrast to the HttpHeadersMoreModule mentioned by Sebastian Goodman in his answer   Since nginx 1 7 5 you can use the keyword always to include custom headers even in error responses  For example   add header X-Upstream  upstream addr always      Limitation  You cannot override the server header value using add header

User · Answer

You could try this solution    In your location block when you use proxy pass do something like this   location          add header yourHeaderName yourValue    proxy pass xxxx   xxx my proxy addr xxx       Now use this solution    proxy ignore headers yourHeaderName    but set by proxy      Or if above didn t work maybe this    proxy hide header yourHeaderName    but set by proxy      I m not sure would it be exactly what you need but try some manipulation of this method and maybe result will fit your problem   Also you can use this combination   proxy hide header headerSetByProxy  set  sent http header set by proxy yourValue

User · Answer

There is a module called HttpHeadersMoreModule that gives you more control over headers  It does not come with Nginx and requires additional installation  With it  you can do something like this   location         more set headers  Server  my server       That will  set the Server output header to the custom value for any status code and any content type   It will replace headers that are already set or add them if unset

[nginx] How to add a response header on nginx when using proxy_pass?

Examples related to nginx

Examples related to http-headers

Examples related to proxypass