20. Роутер “manualroute”

    Роутер “manualroute” назван таким образом потому что он предоставляет возможность “ручной” маршрутизации (manual routing) адреса в соответствии с его доменом. Главным образом он используется в случае, когда вы хотите маршрутизировать почту на удаленные узлы по собственным правилам, в обход обыкновенной DNS-маршрутизации, механизм которой выполняет поиск MX-записей. Однако, роутер “manualroute” также может выполнять маршрутизацию на локальные транспорты, такая возможность может оказаться полезной, если вы хотите сохранять сообщения для входящих (dial-in) узлов в локальных файлах.
   Роутер “manualroute” сравнивает список доменных шаблонов с доменной частью адреса, который он пытается маршрутизировать. Если совпадения не найдено, то роутер отклоняется. Каждый шаблон, ассоциированный с роутером представляет собой список узлов, а также другую дополнительную информацию, в которую может входить транспорт. Комбинация шаблона и других его данных называется “правилом маршрутизации”. Для шаблонов, не имеющих ассоциированного с ними транспорта, общая опция роутеров “transport” должна определять соответствующий транспорт, если только роутер не используется исключительно для проверки (verification) (см. опцию “verify_only”).
   В случае, если роутер используется для проверки, то совпадения с доменным шаблоном достаточно для того, чтобы роутер принял адрес. В действительности, при маршрутизации адреса для доставки, доменная часть которого совпала с  доменным шаблоном, адрес помещается в очередь ассоциированного с роутером транспорта. Если транспорт не является локальным, то с шаблоном должен быть ассоциирован список узлов (host list); выполняется разрешение имен в IP-адреса, которые затем передаются транспорту вместе с почтовым адресом. Для локального транспорта список узлов (host list) является опциональным. Если он присутствует, то он передается в переменной “$host” как простая текстовая строка.
   Список правил маршрутизации может быть определен как строка, включенная (inline string) в опцию “route_list”, либо как данные, полученные путем поиска домена в файле или базе данных, определенных опцией “route_data”. Только одна из них может быть определена в пределах одного экземпляра роутера manualroute. Формат правил маршрутизации описан ниже, вслед за списком частных опций
“manualroute”.




20.1 Частные опции “manualroute”

   Частные опции для “manualroute” таковы:


опция использование тип по-умолчанию host_find_failed manualroute string defer


   Смотрите “host_find_failed”.


опция использование тип по-умолчанию host_find_failed manualroute string freeze


   Эта опция управляет тем, что происходит когда “manualroute” пытается найти IP-адрес узла, а его не существует. Опции может быть дано одно из следующих значений:


decline defer fail freeze ignore pass

   Значение по умолчанию (“freeze”) предполагает, что данное состояние - серьезная конфигурационная ошибка. Разница между значениями “pass” и “decline” состоит в том, что предыдущий пункт принудительно передает адрес следующему роутеру (либо роутеру, указанному в опции “pass_router”), перекрывая опцию “no_more”, тогда как в недавнем прошлом адрес передавался следующему роутеру только в случае истинности опции “more”.
   Значение “ignore” заставляет exim полностью игнорировать хост, чей IP адрес не может быть найден. Если все хосты в списке проигнорированы, поведение контролируется опцией “host_all_ignored”. Она может принимать те же самые значения, что и “host_find_failed”, за исключением того, что эта опция не может быть установлена в “ignore”.
   Опция “host_find_failed” применяется только к состоянию “не существует”; если поиск узла выдает врeменную ошибку, то доставка откладывается, только если не установлена общая опция “pass_on_timeout”.


опция использование тип по-умолчанию hosts_randomize manualroute boolean false


   Если установлена эта опция, то порядок элементов в списке узлов внутри правила маршрутизации каждый раз выбирается случайным образом при обращении к нему, если не перекрывается опцией в самом правиле маршрутизации (см. ниже). Выбор порядка узлов в списке случайным образом может быть использован для первичного распределения нагрузки. Однако, если один и тот же роутер маршрутизирует более одного почтового адреса на один и тот же список узлов, то списки должны быть одинаковыми (даже если они расположены в случайном порядке) для решения о том, помещать ли несколько доставок в одну SMTP-транзакцию.
   В случае если опция “hosts_randomize” истинна, список узлов может быть разделен на группы, порядок которых отдельно устанавливается случайным образом. Это делает возможным установить MX-подобное поведение. Границы между группами помечаются символом “+” в списке узлов. Например,


route_list = * host1:host2:host3:+:host4:host5

   Порядок, в котором сортируются первые три узла и порядок сортировки последних двух выбирается случайным образом при каждом использовании, но первая группа всегда располагается перед второй. Если опция “hosts_randomize” не установлена, символ разделителя “+” в списке игнорируется. Если такой список узлов со случайной внутренней сортировкой, предается транспорту smtp, который также имеет подобную опцию “hosts_randomize set”, то список заново не генерируется в случайном порядке.


опция использование тип по-умолчанию route_data manualroute string† unset


   Если эта опция определена, то ее значение должно раскрываться, т.к. она определяет данные правила маршрутизации. Обычно, раскрываемая строка включает в себя поиск на основе домена. Например:


route_data = ${lookup{$domain}dbm{/etc/routes}}

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


опция использование тип по-умолчанию route_list manualroute string list unset


   Эта строка является списком правил маршрутизации в форме, определенной ниже. Обратите внимание, что в отличие от большинства списков строк, элементы здесь разделяются символом “;”. Так сделано, потому что данный список может содержать разделенные символом “:” списки узлов.


опция использование тип по-умолчанию same_domain_copy_routing manualroute boolean false


   Обычно, адреса с одинаковой доменной частью маршрутизируются роутером “manualroute” на один и тот же список узлов. Однако, это не может быть допустимо, поскольку опции и предусловия роутера могут использовать локальную часть адреса. Поэтому по умолчанию Exim маршрутизирует каждый адрес в сообщении независимо. DNS-серверы используют кэши, поэтому повторяющиеся DNS-запросы не являются помехой, и в любом случае личные сообщения редко имеют много получателей.
   Если у вас функционируют списки рассылки с большим количеством подписчиков из одного домена, и вы используете роутер “manualroute”, который не зависит от локальной части почтового адреса, то вы можете установить опцию “same_domain_copy_routing” во избежание повторяющихся DNS-запросов для одного и того же домена получателя в сообщении. В этом случае, если роутер “manualroute” маршрутизирует адрес удаленному транспорту, то все оставшиеся несмаршрутизированные адреса в сообщении, имеющие тот же домен получателя, перенаправляются автоматически без независимой обработки. Однако, это выполняется только в том случае, если не установлены опции “headers_add” и “headers_remove”.



20.2 Правила маршрутизации в опции “route_list”

   Значением опции “route_list” является строка, состоящая из последовательности правил маршрутизации, разделенных символом “;”. Если “;” указыватся внутри самого правила, то оно должно быть представлено как “;;”. Пустые правила игнорируются. Формат каждого правила - следующий:


<шаблон домена> <список узлов> <опции>

   Следующий пример состоит из двух правил, каждое из которых содержит простой доменный шаблон и не содержит опций:


route_list = \ dict.ref.example mail-1.ref.example:mail-2.ref.example ; \ thes.ref.example mail-3.ref.example:mail-4.ref.example

   Три части правила разделяются пробелами. Шаблон домена и список узлов могут быть, если это необходимо, заключены в кавычки, и если это так, то применяются обычные правила для кавычек (quoting rules). Каждое правило опции “route_list” должно начинаться с шаблона домена (domain pattern), единственного обязательного элемента в правиле. Шаблон должен быть указан в том же формате, что и элемент в доменном списке (domain list) (см. секцию 10.8), за тем исключением, что он не может быть именем включаемого файла. То есть, он может содержать просто шаблон, либо регулярное выражение, либо поиск в файле или базе данных (с двойным символом “;”, из-за использования “;” как разделителя в опции “route_list”).

Правила в “route_list” просматриваются до первого совпадения доменного шаблона
с маршрутизируемым доменом. Затем, как описано ниже, используются список узлов
и опции.  Если совпадений не найдено, то роутер пропускается. Если установлена
опция “route_list”, то не должна быть определена опция “route_data”.



20.3 Правила маршрутизации в опции “route_data”

   Использование опции “route_list” подходит в случае использования небольшого количества правил маршрутизации. Для больших объемов проще использовать файл или базу данных для хранения информации о маршрутах и вместо нее использовать опцию “route_data”. Значением опции “route_data” является список узлов со следующими за ним необязательными опциями. Чаще всего “route_data” определяется как строка, содержащая раскрываемый поиск (expansion lookup). Например, представьте что вы поместили 2 правила маршрутизации в файл:


dict.ref.example: mail-1.ref.example:mail-2.ref.example thes.ref.example: mail-3.ref.example:mail-4.ref.example

Эти данные могут быть доступными путем установки:


route_data = ${lookup{$domain}lsearch{/the/file/name}}

   Не увенчавшийся успехом поиск возвращает пустую строку, вследствие этого роутер пропускается. Однако, не стоит использовать поиск в “route_data”. Единственное требование здесь, это то, что результатом преобразования строки должен быть список узлов, возможно со следующими за ним опциями, разделенные пробелами. Если список узлов содержит пробелы, то он должен быть заключен в кавычки.



20.4 Формат списка узлов

   Список узлов, полученный либо через “route_data”, либо через “route_list”, всегда раскрыватся отдельно перед использованием. Если раскрытие завершается неудачно, то роутер пропускается. Результат преобразования должен быть списком имен и/или IP-адресов. IP-адреса в скобки не помещаются.
Если список узлов получен из опции “route_list”, то во время преобразования устанавливаются следующие переменные:


route_list = ^domain(\d+) host-$1.text.example

route_list = lsearch;;/some/file.routes $value

route_list = * "host1.tld::1225 : host2.tld::1226"
route_list = * "<+ host1.tld:1225 + host2.tld:1226"

route_list = * "</ [10.1.1.1]:1225 / [::1]:1226"

route_list = domain1  host1:host2:host3  randomize bydns;\
             domain2  host4:host5

domainlist local_domains = my.domain.example

hub_route:
    driver = "manualroute"
    transport = remote_smtp
    route_list = *.rhodes.tvs.example  $domain

save_in_file:
    driver = "manualroute"
    transport = batchsmtp_appendfile
    route_list = saved.domain.example

Маршрутизация почты прямиком на программный пакет UUCP - это особый вариант использования “manualroute” в роли шлюза в другое почтовое окружение. Вот пример способа как можно это сделать:


# Transport uucp: driver = pipe user = nobody command = /usr/local/bin/uux -r - \ ${substr_-5:$host}!rmail ${local_part} return_fail_output = true # Router uucphost: transport = uucp driver = "manualroute" route_data = \ ${lookup{$domain}lsearch{/usr/local/exim/uucphosts}}

   Файл “/usr/local/exim/uucphosts” состоит из записей вида:


darksite.ethereal.example: darksite.UUCP

   Можно описать это проще без добавления и удаления “.UUCP” но этот способ показывает различие между именем домена “darksite.ethereal.example” и именем UUCP-станции “darksite”.


=============
translated by http://exim.org.ua/mailman/listinfo/exim-doc-translation
edit, verification and actuality by lissyara
verifying by Gerk

Ссылка на обсуждение: http://forum.lissyara.su/viewforum.php?f=20.

  Этот информационный блок появился по той простой причине, что многие считают нормальным, брать чужую информацию не уведомляя автора (что не так страшно), и не оставляя линк на оригинал и автора — что более существенно. Я не против распространения информации — только за. Только условие простое — извольте подписывать автора, и оставлять линк на оригинальную страницу в виде прямой, активной, нескриптовой, незакрытой от индексирования, и не запрещенной для следования роботов ссылки.
  Если соизволите поставить автора в известность — то вообще почёт вам и уважение.

© lissyara 2006-10-24 08:47 MSK