Модуль 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 или зоне (т.е., суффиксы имён хостов заканчиваются на Домен).

Примеры

.com .example.org.

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

Примечание

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

Подсеть

Подсеть — это частично квалифицированный интернет-адрес в числовом (точечный квад) формате, необязательно с косой чертой и маской подсети, указанной как количество значимых битов в Подсети. Она используется для представления подсети хостов, доступ к которым можно получить через общий сетевой интерфейс. При отсутствии явной маски подсети предполагается, что пропущенные (или нулевые) конечные цифры указывают маску. (В этом случае маска подсети может быть кратна 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).

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

IPAddr

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

Пример

192.168.123.7

Примечание

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

Имя хоста

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

Примеры

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

Примечание

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

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

См. также

• Проблемы DNS

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

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

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

Например, следующее позволит только хостам в 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, именованные группы и ссылки на обратные совпадения (backreferences) записываются в среду с соответствующим именем, префиксным «MATCH_» и заглавными буквами. Это позволяет ссылаться на элементы URL-адресов из выражений и модулей, таких как mod_rewrite. Для предотвращения путаницы, пронумерованные (безымянные) backreferences игнорируются. Используйте именованные группы.

<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), который запрещает установку Proxy Max-Forwards, если клиент его не установил. Более ранние версии Apache httpd всегда его устанавливали. Отрицательное значение ProxyMaxForwards, включая значение по умолчанию -1, обеспечивает соответствие протоколу, но может оставить вас открытыми для циклов.

Директива ProxyPassInherit

ProxyPassInherit On|Off

ProxyPassInherit On

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

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

Отключение 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.

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

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

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

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

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

Директива ProxyPassReverse

ProxyPassReverse [path] url [interpolate]

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

Будут переписаны только заголовки 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 . Apache httpd настраивает это на http://example.com/mirror/foo/quux перед отправкой ответа на HTTP-перенаправление клиенту. Обратите внимание, что имя хоста, используемое для построения URL, выбирается с учетом настроек директивы UseCanonicalName.

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

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

При использовании внутри раздела <Location>, первый аргумент опускается, и локальная директория извлекается из <Location>. То же самое происходит внутри раздела <LocationMatch>, но, вероятно, не будет работать как ожидалось, так как ProxyPassReverse будет интерпретировать regexp буквально как путь; если это необходимо в такой ситуации, укажите 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 на сервере-обработчике сопоставляются с общедоступными путями на обратном прокси. Эта директива переписывает строку path в заголовках Set-Cookie. Если начало пути cookie совпадает с internal-path, путь cookie заменится на public-path.

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

ProxyPassReverseCookiePath  "/"  "/mirror/foo/"

перепишет cookie с путем на сервере-обработчике / (или /example или, фактически, с любым) на /mirror/foo/.

Директива ProxyPreserveHost

ProxyPreserveHost On|Off

ProxyPreserveHost Off

При включении этот параметр передаст строку Host из входящего запроса на проксируемый хост вместо имени хоста, указанного в строке ProxyPass.

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

Директива ProxyReceiveBufferSize

ProxyReceiveBufferSize bytes

ProxyReceiveBufferSize 0

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

ProxyReceiveBufferSize 2048

Директива ProxyRemote

ProxyRemote match remote-server

Определяет удалённые прокси для этого прокси. 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-запрос прокси, другому прокси, который может их обработать.

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

Директива ProxyRemoteMatch

ProxyRemoteMatch regex remote-server

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

Директива ProxyRequests

ProxyRequests On|Off

ProxyRequests Off

Это позволяет или запрещает Apache httpd функционировать как сервер forward-прокси. (Установка ProxyRequests на Off не отключает использование директивы ProxyPass.)

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

Для получения возможности проксирования HTTP или FTP-сайтов также необходимы mod_proxy_http или mod_proxy_ftp (или оба) в сервере.

Для получения возможности проксирования HTTPS-сайтов (вперед) необходима активация mod_proxy_connect в сервере.

См. также

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

Директива ProxySet

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

Эта директива используется в качестве альтернативного способа установки любого параметра, доступного балансировщикам и рабочим процессам прокси, обычно выполняемого с помощью директивы 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

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

Директива ProxyStatus

ProxyStatus Off|On|Full

ProxyStatus Off

Данная директива определяет, отображается ли информация о статусе прокси-балансировщика на странице сервера mod_status.

Директива ProxyTimeout

ProxyTimeout seconds

Value of Timeout

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

Директива ProxyVia

ProxyVia On|Off|Full|Block

ProxyVia Off

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

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