Модуль Apache mod_proxy

Директива BalancerGrowth

BalancerGrowth #

BalancerGrowth 5

Эта директива позволяет увеличить число балансировщиков, доступных для виртуального хоста, сверх количества, заданного предварительной конфигурацией. Она действует только при наличии хотя бы одного предварительно настроенного балансировщика.

Директива BalancerInherit

BalancerInherit On|Off

BalancerInherit On

Эта директива заставляет текущий сервер/виртуальный хост «наследовать» балансировщики и рабочие процессы ProxyPass, определённые в основном сервере. Это может привести к проблемам и непоследовательному поведению при использовании диспетчера балансировщика, поэтому эту директиву следует отключить, если используется данная функция.

Значение, заданное для глобального сервера, определяет значение по умолчанию для всех виртуальных хостов.

Директива BalancerMember

BalancerMember [balancerurl] url [key=value [key=value ...]]

Эта директива добавляет участника в группу балансировки нагрузки. Её можно использовать в директиве-контейнере <Proxy balancer://...>; она принимает любые параметры в виде пары «ключ-значение», доступные директивам ProxyPass.

Только для директив BalancerMember доступен ещё один параметр: loadfactor. Это коэффициент нагрузки участника — десятичное число от 1.0 (по умолчанию) до 100.0, задающее взвешенную нагрузку для соответствующего участника.

Параметр balancerurl нужен только вне директивы-контейнера <Proxy balancer://...>. Он соответствует URL-адресу балансировщика, определённого в директиве ProxyPass.

Компонент пути URL-адреса балансировщика в любой директиве-контейнере <Proxy balancer://...> игнорируется.

Как правило, завершающие косые черты следует удалять из URL-адреса BalancerMember.

Директива BalancerPersist

BalancerPersist On|Off

BalancerPersist Off

Эта директива обеспечивает сохранение общей памяти, связанной с балансировщиками и их участниками, после перезапуска. Благодаря этому локальные изменения не теряются при обычном перезапуске или плавном переходе состояний.

Директива NoProxy

NoProxy host [host] ...

Эта директива полезна только для прокси-серверов Apache httpd во внутренних сетях. Директива NoProxy задаёт список подсетей, IP-адресов, узлов и/или доменов, разделённых пробелами. Запрос к узлу, совпадающему с одним или несколькими элементами списка, всегда обслуживается напрямую, без перенаправления на настроенный прокси-сервер(ы) ProxyRemote.

ProxyRemote  "*"  "http://firewall.example.com:81"
NoProxy         ".example.com" "192.168.112.0/21"

Аргументы host директивы NoProxy должны иметь один из следующих типов:

Домен

Домен — это частично квалифицированное доменное имя DNS с точкой в начале. Оно представляет список узлов, логически принадлежащих одному домену или зоне DNS (т. е. суффиксы имён узлов заканчиваются на Domain).

Примеры

.com .example.org.

Чтобы отличать Domain от имени узла (как синтаксически, так и семантически; у домена DNS также может быть запись A DNS!), Domain всегда указывается с точкой в начале.

Примечание

При сравнении доменных имён регистр не учитывается, а Domain всегда считается привязанным к корню дерева DNS; поэтому домены .ExAmple.com и .example.com. (обратите внимание на завершающую точку) считаются равными. Поскольку при сравнении доменов поиск в DNS не выполняется, оно гораздо эффективнее сравнения подсетей.

Подсеть

Подсеть — это частично квалифицированный интернет-адрес в числовом формате (четыре числа, разделённые точками), за которым может следовать косая черта и маска сети, указанная как число значащих битов в SubNet. Она используется для представления подсети узлов, доступных через общий сетевой интерфейс. Если маска явно не указана, предполагается, что пропущенные (или нулевые) завершающие цифры задают маску. (В этом случае ширина маски сети может быть кратна только 8 битам.) Примеры:

192.168 или 192.168.0.0

подсеть 192.168.0.0 с подразумеваемой маской сети, содержащей 16 допустимых битов (иногда записывается в виде маски 255.255.0.0)

192.168.112.0/21

подсеть 192.168.112.0/21 с маской сети, содержащей 21 допустимый бит (также записывается в виде 255.255.248.0)

В частном случае SubNet с 32 допустимыми битами эквивалентна IPAddr, а SubNet с нулём допустимых битов (например, 0.0.0.0/0) эквивалентна константе _Default_, соответствующей любому IP-адресу.

IP-адрес

IP-адрес — это полностью квалифицированный интернет-адрес в числовом формате (четыре числа, разделённые точками). Обычно этот адрес обозначает узел, но с ним не обязательно должно быть связано доменное имя DNS.

Пример

192.168.123.7

Примечание

Для IPAddr не требуется разрешение имени системой DNS, поэтому его использование может повысить эффективность работы Apache.

Имя узла

Имя узла — это полностью квалифицированное доменное имя DNS, которое можно разрешить в один или несколько IP-адресов с помощью службы доменных имён DNS. Оно представляет логический узел (в отличие от доменов, см. выше) и должно разрешаться как минимум в один IP-адрес (или, как это часто бывает, в список узлов с различными IP-адресами).

Примеры

prep.ai.example.edu
www.example.org

Примечание

Во многих случаях эффективнее указывать IP-адрес вместо имени узла, поскольку это позволяет избежать поиска в DNS. Разрешение имён в Apache httpd может занять значительное время, если соединение с сервером имён установлено через медленный канал PPP.

При сравнении имён узлов регистр не учитывается, а имя узла всегда считается привязанным к корню дерева DNS; поэтому узлы WWW.ExAmple.com и www.example.com. (обратите внимание на завершающую точку) считаются равными.

См. также

• Проблемы DNS

Директива <Proxy>

<Proxy wildcard-url> ...</Proxy>

Директивы, размещённые в секциях <Proxy>, применяются только к соответствующему проксируемому содержимому. Допускаются подстановочные знаки в стиле оболочки.

Например, следующая конфигурация разрешит доступ к содержимому через ваш прокси-сервер только узлам из yournetwork.example.com:

<Proxy "*">
  Require host yournetwork.example.com
</Proxy>

Следующий пример будет обрабатывать все файлы в каталоге foo узла example.com с помощью фильтра INCLUDES при передаче через прокси-сервер:

<Proxy "http://example.com/foo/*">
  SetOutputFilter INCLUDES
</Proxy>

См. также

• <ProxyMatch>

Директива Proxy100Continue

Proxy100Continue Off|On

Proxy100Continue On

Эта директива определяет, должен ли прокси-сервер передавать ожидание 100-continue Expect: исходному серверу, позволяя ему решать, когда и следует ли читать тело HTTP-запроса, или, если Off, прокси-сервер должен самостоятельно сформировать промежуточный ответ 100 Continue перед передачей тела запроса.

Директива ProxyAddHeaders

ProxyAddHeaders Off|On

ProxyAddHeaders On

Эта директива определяет, следует ли передавать сведения, связанные с прокси-сервером, серверу серверной части в HTTP-заголовках X-Forwarded-For, X-Forwarded-Host и X-Forwarded-Server.

Директива ProxyBadHeader

ProxyBadHeader IsError|Ignore|StartBody

ProxyBadHeader IsError

Директива ProxyBadHeader определяет поведение mod_proxy при получении от исходного сервера синтаксически некорректных строк заголовков ответа (т. е. строк без двоеточия). Возможны следующие аргументы:

IsError

Прервать запрос и завершить его ответом 502 (Bad Gateway). Это поведение используется по умолчанию.

Ignore

Считать, что некорректные строки заголовков не были отправлены.

StartBody

При получении первой некорректной строки заголовка завершить чтение заголовков и считать оставшуюся часть телом ответа. Это помогает обойти ошибки серверов серверной части, которые забывают вставить пустую строку между заголовками и телом.

Директива ProxyBlock

ProxyBlock *|word|host|domain [word|host|domain] ...

Директива ProxyBlock задаёт список слов, узлов и/или доменов, разделённых пробелами. Запросы документов HTTP, HTTPS и FTP к сайтам, имена которых содержат совпавшие слова, узлы или домены, блокируются прокси-сервером. Модуль прокси также попытается определить IP-адреса элементов списка, которые могут быть именами узлов, во время запуска и закэшировать их для последующей проверки совпадений. Это может замедлить запуск сервера.

ProxyBlock "news.example.com" "auctions.example.com" "friends.example.com"

Обратите внимание, что для соответствия любому из этих сайтов достаточно было бы указать example.

Совпадение с узлами также будет найдено, если они указаны по IP-адресу.

Также обратите внимание, что

ProxyBlock "*"

блокирует подключения ко всем сайтам.

Директива ProxyDomain

ProxyDomain Domain

Эта директива полезна только для прокси-серверов Apache httpd во внутренних сетях. Директива ProxyDomain задаёт домен по умолчанию, к которому будет относиться прокси-сервер apache. Если встречается запрос к хосту без имени домена, будет сформирован ответ перенаправления на тот же хост с добавленным настроенным значением Domain.

ProxyRemote  "*"  "http://firewall.example.com:81"
NoProxy         ".example.com" "192.168.112.0/21"
ProxyDomain     ".example.com"

Директива ProxyErrorOverride

ProxyErrorOverride Off|On [code ...]

ProxyErrorOverride Off

Эта директива полезна в конфигурациях обратного прокси, где требуется единообразное оформление страниц ошибок, отображаемых конечному пользователю. Она также позволяет включённым файлам (через SSI mod_include) получать код ошибки и действовать соответствующим образом. (При поведении по умолчанию отображается страница ошибки проксируемого сервера. При включении этой директивы отображается сообщение об ошибке SSI.)

Эта директива не влияет на обработку информационных ответов (1xx), обычных успешных ответов (2xx) и ответов перенаправления (3xx).

По умолчанию ProxyErrorOverride применяется ко всем ответам с кодами от 400 (включительно) до 600 (не включительно).

ProxyErrorOverride  On

Чтобы изменить поведение по умолчанию, можно указать через пробел коды состояния, которые следует учитывать. В этом случае все остальные коды состояния будут игнорироваться. Можно указывать только коды состояния, считающиеся кодами ошибок: от 400 (включительно) до 600 (не включительно).

ProxyErrorOverride  On 403 405 500 501 502 503 504

Директива ProxyIOBufferSize

ProxyIOBufferSize bytes

ProxyIOBufferSize 8192

Директива ProxyIOBufferSize изменяет размер внутреннего буфера, используемого для временного хранения данных между вводом и выводом. Размер должен быть не менее 512.

Почти во всех случаях менять это значение не требуется.

При использовании с AJP эта директива задаёт максимальный размер пакета AJP в байтах. Значения больше 65536 устанавливаются равными 65536. Если изменить значение по сравнению со значением по умолчанию, необходимо также изменить атрибут packetSize коннектора AJP на стороне Tomcat! Атрибут packetSize доступен только в Tomcat 5.5.20+ и 6.0.2+

Обычно изменять максимальный размер пакета не требуется. О проблемах со значением по умолчанию сообщалось при отправке сертификатов или цепочек сертификатов.

Директива <ProxyMatch>

<ProxyMatch regex> ...</ProxyMatch>

Директива <ProxyMatch> идентична директиве <Proxy>, за исключением того, что она сопоставляет URL с помощью регулярных выражений.

Начиная с версии 2.4.8 именованные группы и обратные ссылки захватываются и записываются в окружение с соответствующим именем, которому предшествует префикс "MATCH_", а само имя приводится к верхнему регистру. Это позволяет ссылаться на части URL из выражений и таких модулей, как mod_rewrite. Чтобы избежать путаницы, нумерованные (безымянные) обратные ссылки игнорируются. Вместо них используйте именованные группы.

<ProxyMatch "^http://(?<sitename>[^/]+)">
    Require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example
</ProxyMatch>

См. также

• <Proxy>

Директива ProxyMaxForwards

ProxyMaxForwards number

ProxyMaxForwards -1

Директива ProxyMaxForwards задаёт максимальное число прокси-серверов, через которые может пройти запрос, если в запросе не передан заголовок Max-Forwards. Это значение можно установить, чтобы предотвратить бесконечные циклы проксирования или DoS-атаку.

ProxyMaxForwards 15

Обратите внимание, что установка значения ProxyMaxForwards нарушает протокол HTTP/1.1 (RFC2616), запрещающий прокси устанавливать Max-Forwards, если клиент его не установил. Более ранние версии Apache httpd всегда устанавливали его. Отрицательное значение ProxyMaxForwards, включая значение по умолчанию -1, обеспечивает соответствие протоколу, но может оставить возможность возникновения циклов.

Директива ProxyPass

ProxyPass [path] !|url [key=value [key=value ...]] [nocanon] [interpolate] [noquery]

Эта директива позволяет отображать удалённые серверы в пространстве локального сервера. Локальный сервер не действует как прокси в обычном смысле, а выглядит как зеркало удалённого сервера. Локальный сервер часто называют обратным прокси или шлюзом. path — это имя локального виртуального пути; url — частичный URL удалённого сервера, который не может содержать строку запроса.

Начиная с версии 2.4.7, доступна поддержка сокетов домена Unix: для этого используется целевой адрес с префиксом unix:/path/lis.sock|. Например, чтобы проксировать HTTP-запросы и направлять их в UDS по адресу /home/www.socket, следует использовать unix:/home/www.socket|http://localhost/whatever/.

При использовании внутри секции <Location> первый аргумент опускается, а локальный каталог определяется из <Location>. То же произойдёт внутри секции <LocationMatch>; однако ProxyPass не интерпретирует регулярное выражение как таковое, поэтому в этом случае необходимо использовать ProxyPassMatch.

Предположим, что адрес локального сервера — http://example.com/; тогда

<Location "/mirror/foo/">
    ProxyPass "http://backend.example.com/"
</Location>

локальный запрос к http://example.com/mirror/foo/bar будет внутренне преобразован в прокси-запрос к http://backend.example.com/bar.

Если требуется более гибкая конфигурация обратного прокси, см. директиву RewriteRule с флагом [P].

Возможен следующий альтернативный синтаксис; однако при большом количестве таких записей он может снизить производительность. Преимущество приведённого ниже синтаксиса заключается в том, что он позволяет динамически управлять настройками через интерфейс менеджера балансировщика:

ProxyPass "/mirror/foo/" "http://backend.example.com/"

Директива ! полезна в ситуациях, когда не нужно проксировать подкаталог, например:

<Location "/mirror/foo/">
    ProxyPass "http://backend.example.com/"
</Location>
<Location "/mirror/foo/i">
    ProxyPass "!"
</Location>

ProxyPass "/mirror/foo/i" "!"
ProxyPass "/mirror/foo" "http://backend.example.com"

будет проксировать все запросы к /mirror/foo на backend.example.com, кроме запросов к /mirror/foo/i.

Сочетание настроек ProxyPass в разных контекстах не работает:

ProxyPass "/mirror/foo/i" "!"
<Location "/mirror/foo/">
    ProxyPass "http://backend.example.com/"
</Location>

В этом случае запрос к /mirror/foo/i будет проксирован, поскольку директива ProxyPass в блоке Location обрабатывается первой. Тот факт, что ProxyPass поддерживает как контексты сервера, так и контексты каталогов, не означает, что область действия и положение в файле конфигурации гарантируют порядок обработки или переопределение.

Параметры ProxyPass key=value

Начиная с Apache HTTP Server 2.1, mod_proxy поддерживает пулы соединений с сервером приложений. Созданные по запросу соединения могут сохраняться в пуле для дальнейшего использования. Ограничения на размер пула и другие параметры можно задать в директиве ProxyPass с помощью параметров key=value, описанных в таблицах ниже.

Используйте параметр ttl, чтобы задать необязательное время жизни: соединения, которые не использовались не менее ttl секунд, будут закрыты. ttl можно использовать, чтобы избежать повторного использования соединения, которое может закрыться из-за тайм-аута keep-alive сервера приложений.

ProxyPass "/example" "http://backend.example.com" max=20 ttl=120 retry=300

ProxyPass "/special%3Fsegment" "https://example.com/special%3Fsegment" mapping=encoded

<Location "/special%3Fsegment">
  Require ip 172.17.2.0/24
</Location>

ProxyPass "/some/path" "https://servlet.example.com/some/path" mapping=servlet

<Location "/some/path">
  Require valid-user
</Location>

Если схема директивы Proxy начинается с balancer:// (например, balancer://cluster; информация о пути игнорируется), будет создан виртуальный рабочий процесс, который фактически не взаимодействует с сервером приложений. Вместо этого он отвечает за управление несколькими «реальными» рабочими процессами. В этом случае для виртуального рабочего процесса можно задать специальный набор параметров. Дополнительные сведения о работе балансировщика см. в mod_proxy_balancer.

Пример настройки балансировщика:

ProxyPass "/special-area" "http://special.example.com" smax=5 max=10
ProxyPass "/" "balancer://mycluster/" stickysession=JSESSIONID|jsessionid nofailover=On
<Proxy "balancer://mycluster">
    BalancerMember "ajp://1.2.3.4:8009"
    BalancerMember "ajp://1.2.3.5:8009" loadfactor=20
    # Less powerful server, don't send as many requests there,
    BalancerMember "ajp://1.2.3.6:8009" loadfactor=5
</Proxy>

Настройка горячих резервов помогает обеспечить постоянную доступность заданного количества рабочих процессов для каждого набора балансировщика нагрузки:

ProxyPass "/" "balancer://sparecluster/"
<Proxy balancer://sparecluster>
    BalancerMember ajp://1.2.3.4:8009
    BalancerMember ajp://1.2.3.5:8009
    # The servers below are hot spares. For each server above that is unusable
    # (draining, stopped, unreachable, in error state, etc.), one of these spares
    # will be used in its place. Two servers will always be available for a request
    # unless one or more of the spares is also unusable.
    BalancerMember ajp://1.2.3.6:8009 status=+R
    BalancerMember ajp://1.2.3.7:8009 status=+R
</Proxy>

Настройка горячего резерва, который будет использоваться, только если в наборе балансировщика нагрузки нет других доступных элементов или резервов:

ProxyPass "/" "balancer://hotcluster/"
<Proxy "balancer://hotcluster">
    BalancerMember "ajp://1.2.3.4:8009" loadfactor=1
    BalancerMember "ajp://1.2.3.5:8009" loadfactor=2.25
    # The server below is on hot standby
    BalancerMember "ajp://1.2.3.6:8009" status=+H
    ProxySet lbmethod=bytraffic
</Proxy>

Дополнительные ключевые слова ProxyPass

Обычно mod_proxy приводит URL-адреса ProxyPass к каноническому виду. Однако это может быть несовместимо с некоторыми серверами приложений, особенно использующими PATH_INFO. Необязательное ключевое слово nocanon отключает это преобразование и передаёт путь URL серверу приложений в исходном виде. Обратите внимание, что это ключевое слово может повлиять на безопасность сервера приложений, поскольку оно отключает обычную ограниченную защиту прокси от атак через URL.

Обычно mod_proxy включает строку запроса при формировании переменной окружения SCRIPT_FILENAME. Необязательное ключевое слово noquery (доступно начиная с httpd 2.4.1) предотвращает это.

Необязательное ключевое слово interpolate в сочетании с ProxyPassInterpolateEnv заставляет ProxyPass подставлять значения переменных окружения, используя синтаксис ${VARNAME}. Обратите внимание, что многие стандартные переменные окружения, происходящие из CGI, в момент такой подстановки ещё не существуют, поэтому для сложных правил может по-прежнему понадобиться mod_rewrite. Кроме того, подстановка в части URL со схемой/именем хоста/портом поддерживается только для переменных, доступных при разборе директивы (например, Define). Динамически определять эти поля можно с помощью mod_rewrite. В следующем примере показано, как использовать mod_rewrite для динамического выбора схемы http или https:

RewriteEngine On

RewriteCond "%{HTTPS}" =off
RewriteRule "." "-" [E=protocol:http]
RewriteCond "%{HTTPS}" =on
RewriteRule "." "-" [E=protocol:https]

RewriteRule "^/mirror/foo/(.*)" "%{ENV:protocol}://backend.example.com/$1" [P]
ProxyPassReverse  "/mirror/foo/" "http://backend.example.com/"
ProxyPassReverse  "/mirror/foo/" "https://backend.example.com/"

Директива ProxyPassInherit

ProxyPassInherit On|Off

ProxyPassInherit On

Эта директива заставляет текущий сервер или виртуальный хост «наследовать» директивы ProxyPass, заданные для основного сервера. Это может привести к проблемам и непоследовательному поведению при использовании менеджера балансировщика для динамического изменения настроек, поэтому эту возможность следует отключить, если используется такая функция.

Настройка глобального сервера определяет значение по умолчанию для всех виртуальных хостов.

Отключение ProxyPassInherit также отключает BalancerInherit.

Директива ProxyPassInterpolateEnv

ProxyPassInterpolateEnv On|Off

ProxyPassInterpolateEnv Off

Эта директива вместе с аргументом interpolate для директив ProxyPass, ProxyPassReverse, ProxyPassReverseCookieDomain и ProxyPassReverseCookiePath позволяет динамически настраивать обратные прокси с помощью переменных окружения, которые могут задаваться другим модулем, например mod_rewrite. Она влияет на директивы ProxyPass, ProxyPassReverse, ProxyPassReverseCookieDomain и ProxyPassReverseCookiePath и заставляет их подставлять значение переменной окружения varname вместо строки ${varname} в директивах конфигурации, если задан параметр interpolate.

Часть ProxyPass, содержащая схему/имя хоста/порт, может включать переменные, но только те, которые доступны при разборе директивы (например, с помощью Define). Во всех остальных случаях рекомендуется использовать mod_rewrite.

Директива ProxyPassMatch

ProxyPassMatch [regex] !|url [key=value [key=value ...]]

Эта директива эквивалентна ProxyPass, но использует регулярные выражения вместо простого сопоставления префиксов. Указанное регулярное выражение сопоставляется с url; если совпадение найдено, сервер подставляет все совпадения в круглых скобках в указанную строку и использует её как новый url.

Предположим, что адрес локального сервера — http://example.com/; тогда

ProxyPassMatch "^/(.*\.gif)$" "http://backend.example.com/$1"

локальный запрос к http://example.com/foo/bar.gif будет внутренне преобразован в прокси-запрос к http://backend.example.com/foo/bar.gif.

Директива ! полезна в ситуациях, когда не требуется проксировать подкаталог в обратном направлении.

При использовании внутри секции <LocationMatch> первый аргумент опускается, а регулярное выражение берётся из <LocationMatch>.

Если требуется более гибкая конфигурация обратного прокси, см. директиву RewriteRule с флагом [P].

Директива ProxyPassReverse

ProxyPassReverse [path] url [interpolate]

Эта директива позволяет Apache httpd корректировать URL в заголовках Location, Content-Location и URI ответов HTTP-перенаправления. Это необходимо, когда Apache httpd используется в качестве обратного прокси (или шлюза), чтобы избежать обхода обратного прокси из-за HTTP-перенаправлений серверов backend, расположенных за ним.

Перезаписываются только указанные выше заголовки HTTP-ответов. Apache httpd не перезаписывает другие заголовки ответа и по умолчанию не изменяет ссылки на URL внутри HTML-страниц. Это означает, что абсолютные ссылки на URL в проксируемом содержимом будут обходить прокси. Чтобы изменить HTML-содержимое и привести его в соответствие с прокси, необходимо загрузить и включить mod_proxy_html.

path — имя локального виртуального пути; url — частичный URL удалённого сервера. Эти параметры используются так же, как и в директиве ProxyPass.

Например, предположим, что адрес локального сервера — http://example.com/; тогда

ProxyPass         "/mirror/foo/" "http://backend.example.com/"
ProxyPassReverse  "/mirror/foo/" "http://backend.example.com/"
ProxyPassReverseCookieDomain  "backend.example.com"  "public.example.com"
ProxyPassReverseCookiePath  "/"  "/mirror/foo/"

не только приведёт к внутреннему преобразованию локального запроса к http://example.com/mirror/foo/bar в прокси-запрос к http://backend.example.com/bar (эту функциональность здесь обеспечивает ProxyPass), но и обработает перенаправления, которые сервер backend.example.com отправляет при перенаправлении http://backend.example.com/bar на http://backend.example.com/quux. Перед отправкой клиенту ответа HTTP-перенаправления Apache httpd изменит этот адрес на http://example.com/mirror/foo/quux. Обратите внимание, что имя хоста, используемое для построения URL, выбирается с учётом настройки директивы UseCanonicalName.

Обратите внимание, что эту директиву ProxyPassReverse также можно использовать совместно с функцией прокси (RewriteRule ... [P]) из mod_rewrite, поскольку она не зависит от соответствующей директивы ProxyPass.

Необязательное ключевое слово interpolate, используемое вместе с ProxyPassInterpolateEnv, включает подстановку переменных окружения, заданных в формате ${VARNAME}. Обратите внимание, что подстановка не поддерживается в части URL, содержащей схему.

При использовании внутри секции <Location> первый аргумент опускается, а локальный каталог берётся из <Location>. То же происходит внутри секции <LocationMatch>, однако, вероятно, это не даст ожидаемого результата, поскольку ProxyPassReverse интерпретирует регулярное выражение буквально как путь; если в такой ситуации это необходимо, укажите ProxyPassReverse вне секции или в отдельной секции <Location>.

Эта директива не поддерживается в секциях <Directory> или <Files>.

Директива ProxyPassReverseCookieDomain

ProxyPassReverseCookieDomain internal-domain public-domain [interpolate]

Используется практически так же, как ProxyPassReverse, но вместо перезаписи заголовков, содержащих URL, эта директива перезаписывает строку domain в заголовках Set-Cookie.

Директива ProxyPassReverseCookiePath

ProxyPassReverseCookiePath internal-path public-path [interpolate]

Полезна совместно с ProxyPassReverse в ситуациях, когда пути URL сервера backend сопоставляются с общедоступными путями на обратном прокси. Эта директива перезаписывает строку path в заголовках Set-Cookie. Если начало пути cookie совпадает с internal-path, путь cookie будет заменён на public-path.

В примере с ProxyPassReverse директива:

ProxyPassReverseCookiePath  "/"  "/mirror/foo/"

перепишет cookie с путём backend / (или /example или, по сути, любым другим) на /mirror/foo/.

Директива ProxyPreserveHost

ProxyPreserveHost On|Off

ProxyPreserveHost Off

Если этот параметр включён, строка Host: из входящего запроса будет передана проксируемому хосту вместо имени хоста, указанного в строке ProxyPass.

Обычно этот параметр следует отключать: Off. Он полезен главным образом в особых конфигурациях, например при массовом размещении виртуальных хостов на основе имён за прокси, когда серверу backend необходимо анализировать исходный заголовок Host.

Директива ProxyReceiveBufferSize

ProxyReceiveBufferSize bytes

ProxyReceiveBufferSize 0

Директива ProxyReceiveBufferSize задаёт явный размер сетевого буфера (TCP/IP) для проксируемых соединений HTTP и FTP, повышая пропускную способность. Значение должно быть больше 512 или равно 0, чтобы использовать размер буфера системы по умолчанию.

ProxyReceiveBufferSize 2048

Директива ProxyRemote

ProxyRemote match remote-server [username:password]

Эта директива задаёт удалённые прокси для данного прокси. match — это либо имя схемы URL, поддерживаемой удалённым сервером, либо частичный URL, для которого следует использовать удалённый сервер, либо *, указывающее, что к серверу следует обращаться для всех запросов. remote-server — частичный URL удалённого сервера. Синтаксис:

remote-server = scheme://hostname[:port]

scheme фактически задаёт протокол, который следует использовать для связи с удалённым сервером; этот модуль поддерживает только http и https. При использовании https запросы пересылаются через удалённый прокси с помощью метода HTTP CONNECT.

ProxyRemote "http://goodguys.example.com/" "http://mirrorguys.example.com:8000"
ProxyRemote "*" "http://cleverproxy.localdomain"
ProxyRemote "ftp" "http://ftpproxy.mydomain:8080"

В последнем примере прокси будет пересылать запросы FTP, инкапсулированные в ещё один запрос HTTP-прокси, другому прокси, который умеет их обрабатывать.

Этот параметр также поддерживает конфигурацию обратного прокси: веб-сервер backend можно встроить в пространство URL виртуального хоста, даже если этот сервер скрыт за другим прямым прокси.

Можно указать необязательный третий аргумент username:password, задающий учётные данные базовой аутентификации для передачи настроенному удалённому прокси. Учётные данные всегда отправляются без предварительного ожидания запроса базовой аутентификации от удалённого прокси. Переменная окружения Proxy-Chain-Auth не действует, если используется этот аргумент.

Директива ProxyRemoteMatch

ProxyRemoteMatch regex remote-server [username:password]

Директива ProxyRemoteMatch идентична директиве ProxyRemote, за исключением того, что первый аргумент представляет собой регулярное выражение, сопоставляемое с запрошенным URL.

Директива ProxyRequests

ProxyRequests On|Off

ProxyRequests Off

Этот параметр разрешает или запрещает Apache httpd работать в качестве прямого прокси-сервера. (Установка для ProxyRequests значения Off не отключает использование директивы ProxyPass.)

В типичной конфигурации обратного прокси или шлюза для этого параметра следует задать Off.

Чтобы включить проксирование сайтов HTTP или FTP, на сервере также необходимо наличие mod_proxy_http или mod_proxy_ftp (либо обоих модулей).

Чтобы включить прямое проксирование сайтов HTTPS, на сервере необходимо включить mod_proxy_connect.

См. также

• Прямые и обратные прокси/шлюзы

Директива ProxySet

ProxySet url key=value [key=value ...]

Эта директива служит альтернативным способом задания любых параметров, доступных для балансировщиков нагрузки Proxy и рабочих процессов; обычно это делается с помощью директивы ProxyPass. Если она используется внутри контейнера <Proxy balancer url|worker url>, аргумент url не требуется. При этом соответствующий балансировщик или рабочий процесс создаётся автоматически. Это может быть полезно при настройке обратного прокси с помощью RewriteRule вместо директивы ProxyPass.

<Proxy "balancer://hotcluster">
    BalancerMember "http://www2.example.com:8080" loadfactor=1
    BalancerMember "http://www3.example.com:8080" loadfactor=2
    ProxySet lbmethod=bytraffic
</Proxy>

<Proxy "http://backend">
    ProxySet keepalive=On
</Proxy>

ProxySet "balancer://foo" lbmethod=bytraffic timeout=15

ProxySet "ajp://backend:7001" timeout=15

Директива ProxySourceAddress

ProxySourceAddress address

Эта директива позволяет задать конкретный локальный адрес, который будет привязан при подключении к серверу backend.

Директива ProxyStatus

ProxyStatus Off|On|Full

ProxyStatus Off

Эта директива определяет, будут ли данные о состоянии балансировщика нагрузки прокси отображаться на странице mod_status server-status.

Директива ProxyTimeout

ProxyTimeout seconds

Value of Timeout

Эта директива позволяет задать тайм-аут для прокси-запросов. Это полезно при работе с медленным или нестабильным сервером приложений, который зависает: вместо того чтобы неопределённо долго ждать ответа сервера, можно просто вернуть сообщение о тайм-ауте и корректно завершить запрос.

Директива ProxyVia

ProxyVia On|Off|Full|Block

ProxyVia Off

Эта директива управляет использованием прокси заголовка HTTP Via:. Она предназначена для управления потоком прокси-запросов в цепочке прокси-серверов. Объяснение строк заголовка Via: см. в разделе 14.45 документа RFC 2616 (HTTP/1.1).

• Если задано значение Off, используемое по умолчанию, специальная обработка не выполняется. Если запрос или ответ содержит заголовок Via:, он передаётся без изменений.
• Если задано значение On, в каждый запрос и ответ добавляется строка заголовка Via: с указанием текущего хоста.
• Если задано значение Full, в каждую созданную строку заголовка Via: дополнительно включается версия сервера Apache httpd в виде поля комментария Via:.
• Если задано значение Block, из каждого прокси-запроса удаляются все строки заголовка Via:. Новые заголовки Via: не создаются.