|
Перевод статьи. Оригинал взят отсюда:
http://www.usebox.net/jjm/bogom/
Простой milter для
sendmail, служащий интерфейсом к bogofilter.
Manual page
BOGOM(8) OpenBSD System Manager's Manual BOGOM(8)
НАЗВАНИЕ
bogom - простой milter для sendmail, служащий интерфейсом к bogofilter.
СИНТАКСИС
bogom [-R | -D] [-t] [-v] [-S] [-u user] [-s conn] [-b bogo_path] [-x
exclude_string] [-c conf_file] [-l body_limit] [-p pidfile] [-f
forward_spam] [-q quarantine_mdir] [-d]
ОПИСАНИЕ
Плагин bogom может быть использован с milter API почтового транспортного
агента sendmail(8) для электронной почты с использованием bogofilter(1) на
основе теоремы Байеса.
bogom предназначен для использования только с одной словарной базой для
всех систем.
Список доступных ключей в командной строке:
-R Отбрасывание почтового сообщения, классифицированного как спам.
-D Избавление от почтового сообщения, классифицированного как спам.
-t Обучение bogofilter с почтой, классифицированной как спам/не_спам.
-v Подробное журналирование.
-S Использование заголовка spamicity. Подробнее описано конфигурационном файле.
-u user Пользователь, под которым запускается milter.По умолчанию: bogofilter
-s conn Путь до сокета для соединения с sendmail.
По умолчанию: unix:/var/spool/bogofilter/milter.sock
-b bogo_path Путь до исполнительного файла bogofilter(1).
По умолчанию: /usr/local/bin/bogofilter
-x exclude_string Если указанная строка будет найдена в теме письма, то будет автоматически
принята без проверки фильтром.
-c conf_file Путь до конфигурационного файла. По умолчанию: /etc/bogom.conf
-l body_limit Ограничение размера тела сообщения в байтах. При
превышении, письмо будет отброшено и не проанализировано
фильтром. По умолчанию: не ограничено.
-p pidfile Путь до файла, в котором хранится идентификатор
процесса. Файл создается после того, как milter будет
запущен с соответствующими привилегиями, позволяющие
иметь доступ к файлу на запись.
По умолчанию: /var/spool/bogofilter/bogom.pid
-f forward_spam Установить получателя для пересылки любых
сообщений,классифицированных как спам. Для более
подробной информации обратитесь к соответствующую секцию
конфигурационного файла.
-q quarantine_mdir Путь до директории, в которой хранятся копии
сообщений,классифицированных как спам, в формате maildir(5).
-d Включение отладочных сообщений (подразумевается подробное журналирование)
По умолчанию сообщение пропускается и добавляется заголовок X-Bogosity
(Yes, No, Unsure). Это можно изменить с помощью ключей -R или -D, тогда
bogofilterсбудет классифицировать письмо как спам.
В настройках bogofilter системная директория с базами данных по умолчанию
находится здесь: /var/spool/bogofilter/, либо просто базу данных
непривилегированного пользователя, из-под которого запущен milter.
bogom использует временный файл для хранения каждого отдельного сообщения
и создает отдельный процесс для его сканирования с помощью bogofilter.
Этот временный файл создается по умолчанию в директории /tmp, с правами
доступа 0600 и владельцем, под которым запущен milter. Если указана
директория в параметре quarantine_mdir, то используется поддиректория в этой директории.
Ключ -t заносит почтовое сообщение в базу данных после классификации его
как спам или не спам. Этот параметр может быть опасен по причине того, что
в базе данных могут быть ошибки, поэтому вам следует внимательно почитать
руководство к bogofilter относительно этого пункта.
НАСТРОЙКА SENDMAIL
Проверить поддержку milter в sendmail можно следующим образом:
# sendmail -d0.1 -bv root | grep MILTER
Compiled with: DNSMAP LOG MAP_REGEX MATCHGECOS MILTER MIME7TO8
MIME8TO7
Нижеследующей строкой milter добавляется в mc-файл и конфигурацию sendmail:
INPUT_MAIL_FILTER(`bogom', S=unix:/var/spool/bogofilter/milter.sock, T=S:30s;R:1m')
Указано размещение сокета по умолчанию.
После этого следует перестроить cf-файл и перезапустить sendmail.
КОНФИГУРАЦИОННЫЙ ФАЙЛ
Конфигурационный файл поддерживает следующие настройки:
# комментарии
policy (pass|reject|discard)
по умолчанию: policy pass
reject "<текст для ответа SMTP>"
по умолчанию: пусто
(у sendmail по умолчанию "Command rejected")
subject_tag "<текст, добавляемый в поле письма «тема»>"
по умолчанию: пусто
verbose (0|1)
по умолчанию: verbose 0
bogofilter "<путь до исполняемого файла bogofilter>"
по умолчанию: bogofilter "/usr/local/bin/bogofilter"
training (0|1)
по умолчанию: training 0
body_limit <размер в байтах>
по умолчанию: не ограничено
user "<пользователь, под которым запускается milter>"
по умолчанию: пользователь "bogofilter"
connection "<тип>:<расположение>"
по умолчанию: connection "unix:/var/spool/bogofilter/milter.sock"
pidfile "<path to milter pidfile>"
по умолчанию: pidfile "/var/spool/bogofilter/bogom.pid"
exclude_string "<subject exclude string>"
по умолчанию: empty
forward_spam "<почтовый@ящик>"
по умолчанию: пусто
quarantine_mdir "<путь до директории maildir>"
по умолчанию: пусто
re_connection "<case insensitive extended re>"
по умолчанию: пусто
re_envfrom "<case insensitive extended re>"
по умолчанию: пусто
re_envrcpt "<case insensitive extended re>"
по умолчанию: пусто
Конфигурация посредством командной строки имеет более высокий приоритет.
По умолчанию заголовок X-Bogosity использует строки 'Yes,
tests=bogofilter', 'No, tests=bogofilter' и 'Unsure, tests=bogofilter'. При
включении параметра spamicity_header, сообщения классифицируются как 'Ham',
'Spam' или 'Unsure' плюс добавляется соответствующая пометка в теме
сообщения.
Строка subject_tag используется для пометки спама в теме сообщения при
значении policy pass.
Параметр body_limit определяет размер тела сообщения в байтах (суффикс K
– килобайты и M – мегабайты), которое подходит для обработки с помощью
bogofilter. Этот параметр может помочь серверам с большой загрузкой, но он
не совместим с quarantine_mdir
В параметре forward_spam указывается получатель, которому будет
копироваться все почтовые сообщения, классифицированные как спам, при
установке policy pass. Замечание, что оригинальное направление получателей
не изменено и разрешен общий RELAY, будет сделано.
Если указана директория quarantine_mdir, то любое сообщение,
классифицированное как спам будет передаваться туда в формате maildir. При
этом ни reject, ни discard в policy не будут действовать, а параметр
body_limit игнорируется.
После того, как сообщение было передано, будут созданы необходимые
поддиректории (только tmp и new). Замечу, что поддиректория tmp в maildir
используется как временная директория для процессов bogom, при его
активности.
Токены re_* позволяют изменять параметры соединения и белых списков
envfrom и envrcpt. Любое сообщение с клиентским соединением (как ip-адрес
так и домен, если доступен), адрес оправителя или адрес получателя,
которое попадает под регулярное выражение (описано в re_format(7)) будет
получено, фильтрация производиться не будет. Так же эти токены можно
использовать более одного раза и все регулярные выражения будут проверены.
В строках можно использовать одинарные или двойные кавычки, обратный слэш
используется для сброса обоих символов.
ЖУРНАЛИРОВАНИЕ
bogom отправляет сообщения для syslogd(8), используя facility daemon,
уровни err, notice, info и debug.
По умолчанию выводится только уровни info и, когда требуется, err. С
ключом -c дополнительная информация будет адресовываться с уровнем notice
в bogofilter.
-d включение отладочного уровня с очень подробным журналированием.
Журналирование активности bogom можно направить в разные файлы с помощью
следующих строк в syslog.conf(5):
!bogom
*.* /var/log/bogom
!bogofilter
*.* /var/log/bogom
ФАЙЛЫ
/etc/bogom.conf
СМ. ТАКЖЕ
sendmail(8), bogofilter(1), bogoutil(1), syslog.conf(5), syslogd(8),
re_format(7), maildir(5)
http://www.usebox.net/jjm/bogom/
ПРЕДУПРЕЖДЕНИЯ
Сейчас SIGHUP игнорируется.
ИСТОРИЯ
Первая версия bogom была написана в конце 2004 года.
АВТОРЫ
Хуан Х. Мартинес <jjm@usebox.net>
OpenBSD 3.6 December 25, 2004 4
Скачивание
bogom выпущен под GNU Public License.
Схема версий следующая: a.b.c (a
основная версия - b второстепенная версия,
исправление ошибок и новые возможности
- c исправление ошибокbug).
Вы можете подписаться на новые
выпуски.
Текущий выпуск
ВАЖНО:
список
исправлений bogom 2006-1:
обновитесь до 1.8.2 или более
позднией версии.
bogom-1.9.2.tar.gz
- CHANGELOG -
README —
README.solaris
(MD5 eed19c240e273ecc5037b5ac6a44d502)
Для разработчиков
Многие изменения из присланных патчей
добавляются в следующий выпуск.
Перед этим ознакомьтесь с changelog
и как их накладывать.
Пока патчей нет
Известные порты и пакеты
Почтовая рассылка поддержки
Благодаря Виктору Баллада
у нас есть почтовая рассылка для
поддержки
пользователей bogom.
Подписавшись на нее вы сможете обсуждать
программу и помочь разработке.
Обсуждение любого похожего milter
приветствуются. Практически
никаких
правил по вопросам и ответам
нет, но все же держитесь в рамках тематики.
Здесь расположен архив
рассылки.
Дополнительные ссылки
Ниже представлен список, относящегося
к bogom:
Последний раз обновлен: Wed Jun
25 23:59:31 CEST 2008
===
Перевод: vadim s. sabinich 03.12.08
23:40:36.
|
