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 Частные (private) опции manualroute

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



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


decline
defer
fail
freeze
pass

   Значение по умолчанию предполагает, что данное состояние - серьезная конфигурационная ошибка. Разница между значениями “pass” и “decline” состоит в том, что предыдущий пункт принудительно передает адрес следующему роутеру (либо роутеру, указанному в опции “pass_router”), перекрывая опцию “no_more”, тогда как в недавнем прошлом адрес передавался следующему роутеру только в случае истинности опции “more”.
   Эта опция применима только к определенному состоянию “не существует” (“does not exist” state); если поиск узла выдает врeменную ошибку, то доставка откладывается, только если не установлена общая опция “pass_on_timeout”.



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


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

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



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


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

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



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



   Обычно, адреса с одинаковой доменной частью маршрутизируются роутером “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 = * "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 = *  x.y.z:p.q.r/MX:e.f.g

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

domainlist local_domains = my.domain.example

smart_route:
    driver = "manualroute"
    domains = !+local_domains
    transport = remote_smtp
    route_list = * smarthost.ref.example

smart_route:
    driver = "manualroute"
    transport = remote_smtp
    route_list = !+local_domains  smarthost.ref.example

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

through_firewall:
    driver = "manualroute"
    transport = remote_smtp
    route_data = ${lookup {$domain} cdb {/internal/host/routes}}

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

save_in_file:
    driver = "manualroute"
    route_list = \
       *.saved.domain1.example  $domain  batch_appendfile; \
       *.saved.domain2.example  \
       ${lookup{
$domain}dbm{/domain2/hosts}{$value}fail} \
       batch_pipe

# 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}}

darksite.ethereal.example:           darksite.UUCP