Як додати заголовок відповіді на nginx при використанні proxy_pass?

Я хочу додати власний заголовок для відповіді, отриманої від сервера позаду nginx.

Хоча add_headerпрацює для відповідей, оброблених nginx, він нічого не робить, коли proxy_passвикористовується.

Існує модуль HttpHeadersMoreModule, який надає вам більше контролю над заголовками. Він не постачається з Nginx і вимагає додаткового встановлення. З його допомогою ви можете зробити щось подібне:

location ... {
  more_set_headers "Server: my_server";
}

Це "встановить для заголовка виводу сервера спеціальне значення для будь-якого коду стану та будь-якого типу вмісту". Він замінить вже встановлені заголовки або додасть їх, якщо не встановлено.

add_headerпрацює як з, proxy_passтак і без. Я щойно встановив конфігурацію, де використовував саме цю директиву. Але я повинен визнати, що я теж намагався налаштувати це, не згадуючи точно причину.

Зараз у мене є робоча конфігурація, і вона містить наступне (серед іншого):

server {
    server_name  .myserver.com
    location / {
        proxy_pass  http://mybackend;
        add_header  X-Upstream  $upstream_addr;
    }
}

До nginx 1.7.5 add_header працював лише над успішними відповідями, на відміну від HttpHeadersMoreModule, про який згадував Себастьян Гудман у своїй відповіді .

З nginx 1.7.5ви можете використовувати ключове слово alwaysдля включення користувацьких заголовків навіть у відповідях на помилки. Наприклад:

add_header X-Upstream $upstream_addr always;

Обмеження: Ви не можете замінити serverзначення заголовка за допомогою add_header.

Як пише Олівер:

add_headerпрацює як з, proxy_passтак і без.

Однак, як пише Шейн, станом на Nginx 1.7.5, ви повинні пройти always, щоб почати add_headerпрацювати з відповідями на помилки, наприклад:

add_header  X-Upstream  $upstream_addr always;

Сховати заголовок відповіді, а потім додати нове власне значення заголовка

Додавання заголовка з add_headerвідмінно працює з пропуском проксі, але якщо у відповіді є наявне значення заголовка, він буде стекувати ці значення.

Якщо ви хочете встановити або замінити значення заголовка (наприклад, замінити Access-Control-Allow-Originзаголовок, щоб він відповідав вашому клієнту, щоб дозволити спільний доступ до ресурсів), ви можете зробити наступне:

# 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 *;

Таким чином, proxy_hide_headerпоєднане з add_headerдає вам можливість встановлювати / замінювати значення заголовків відповіді.

Подібну відповідь можна знайти тут на ServerFault

ОНОВЛЕННЯ:

Примітка: proxy_set_header призначений для встановлення заголовків запитів перед подальшим надсиланням запиту, а не для встановлення заголовків відповідей (ці атрибути конфігурації заголовків можуть трохи заплутати).

Ви можете спробувати це рішення:

У вашому locationблоці, коли ви використовуєте, proxy_passзробіть щось подібне:

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

}

Я не впевнений, що це саме те, що вам потрібно, але спробуйте деякі маніпуляції з цим методом, і, можливо, результат відповідатиме вашій проблемі.

Також ви можете використовувати цю комбінацію:

proxy_hide_header headerSetByProxy;
set $sent_http_header_set_by_proxy yourValue;