postfix - программа управления Postfix
СИНТАКСИС
postfix [-Dv] [-c config_dir] команда
ОПИСАНИЕ
Эта команда предназначена только для суперпользователя. Для отправки почты используйте команду sendmail(1) Postfix.
Команда postfix(1) управляет работой почтовой системы Postfix: запускает или останавливает демон master(8), выполняет проверку работоспособности и другие операции обслуживания.
По умолчанию команда postfix(1) настраивает стандартную среду и выполняет скрипт postfix-script, чтобы выполнить фактическую работу.
Однако, когда настроена поддержка нескольких экземпляров Postfix, postfix(1) выполняет команду, указанную параметром конфигурации multi_instance_wrapper. Эта команда будет выполнять команду для каждого применимого экземпляра Postfix.
Реализованы следующие команды:
check Предупреждает об ошибках в правах доступа к каталогам/файлам или разрешениях и создает отсутствующие каталоги.
start Запускает почтовую систему Postfix. Эта команда также выполняет проверку конфигурации, описанную выше.
start-fg
Как start, но оставляет демон master(8) работающим в фоновом режиме и включает режим "init" для master(8), когда он работает как PID 1. Эта команда требует, чтобы поддержка нескольких экземпляров была отключена (т. е. значение параметра multi_instance_directories должно быть пустым).
При запуске Postfix внутри контейнера см. MAILLOG_README для регистрации в stdout. Postfix по умолчанию записывает данные в syslog, что требует a) запуска процесса syslogd внутри контейнера или b) монтирования сокета /dev/log хост-контейнера внутри контейнера (например: "docker run -v /dev/log:/dev/log ...") и c) отдельного префикса "syslog_name" Postfix, который идентифицирует данные, записываемые экземпляром Postfix.
stop Останавливает почтовую систему Postfix в порядке, предусмотренном системой. Если возможно, работающие процессы завершают работу при первой же возможности.
Примечание: чтобы обновить почтовую систему Postfix после изменения конфигурации, не используйте команды start и stop последовательно. Вместо этого используйте команду reload.
abort Принудительно останавливает почтовую систему Postfix. Работающие процессы получают сигнал о немедленной остановке.
flush Принудительная доставка: попытка доставить каждое сообщение из очереди отложенной почты. Обычно попытки доставки отложенной почты выполняются через регулярные промежутки времени, при этом интервал удваивается после каждой неудачной попытки.
Предупреждение: частая принудительная доставка недоставленной почты приведет к снижению производительности доставки всей остальной почты.
reload Перечитывает файлы конфигурации. Работающие процессы завершают работу при первой же возможности.
status Указывает, запущена ли почтовая система Postfix в данный момент (код выхода 0) или остановлена (код выхода, отличный от нуля).
set-permissions [name=value ...]
Устанавливает права владения и разрешения для файлов и каталогов, связанных с Postfix, как указано в файле postfix-files.
Укажите name=value, чтобы переопределить и обновить определенные параметры конфигурации main.cf. Например, это можно использовать для изменения параметра mail_owner или установки параметра setgid_group для уже установленной системы Postfix.
Эта функция доступна в Postfix 2.1 и более поздних версиях. В Postfix 2.0 и более ранних версиях используйте "$config_directory/post-install set-permissions".
logrotate
Выполняет ротацию файла журнала, указанного в $maillog_file, путем добавления суффикса с меткой времени, отформатированного в соответствии с $maillog_file_rotate_suffix, и сжатия файла с помощью команды, указанной в $maillog_file_compressor. Это не будет выполнять ротацию файлов /dev/*
Эта функция доступна в Postfix 3.4 и более поздних версиях.
tls subcommand
Включает опциональное TLS в клиенте или сервере SMTP Postfix и управляет закрытыми ключами и сертификатами сервера SMTP Postfix. См. postfix-tls(1) для документации.
Эта функция доступна в Postfix 3.1 и более поздних версиях.
upgrade-configuration [name=value ...]
Обновляет файлы main.cf и master.cf информацией, необходимой Postfix для работы: добавляет или обновляет службы и добавляет или обновляет параметры конфигурации.
Укажите name=value, чтобы переопределить и обновить определенные параметры конфигурации main.cf.
Эта функция доступна в Postfix 2.1 и более поздних версиях. В Postfix 2.0 и более ранних версиях используйте "$config_directory/post-install upgrade-configuration".
Следующие опции реализованы:
-c config_dir
Считывает файлы конфигурации main.cf и master.cf в указанном каталоге вместо каталога конфигурации по умолчанию. Это можно использовать для разграничения нескольких экземпляров Postfix на одном хосте.
В Postfix 2.6 и более поздних версиях эта опция принуждает команду postfix(1) работать только с указанным экземпляром Postfix. Это поведение наследуется командами postfix(1), которые выполняются как дочерний процесс текущего процесса.
-D (только с запуском Postfix)
Запускает каждый демон Postfix под управлением отладчика, указанного с помощью параметра конфигурации debugger_command.
-v Включает подробное ведение журнала для отладки. Несколько опций -v делают программу все более и более многословной.
ОКРУЖАЮЩАЯ СРЕДА
Команда postfix(1) экспортирует следующие переменные среды перед выполнением файла postfix-script:
MAIL_CONFIG
Эта переменная устанавливается, когда присутствует опция командной строки -c.
В Postfix 2.6 и более поздних версиях эта переменная среды принуждает команду postfix(1) работать только с указанным экземпляром Postfix. Это поведение наследуется командами postfix(1), которые выполняются как дочерний процесс текущего процесса.
MAIL_VERBOSE
Эта переменная устанавливается, когда присутствует опция командной строки -v.
MAIL_DEBUG
Эта переменная устанавливается, когда присутствует опция командной строки -D.
Когда включена внутренняя служба ведения журналов (путем установки непустого значения параметра maillog_file), команда postfix(1) экспортирует настройки, которые используются дочерними процессами, прежде чем они обрабатывают main.cf или параметры командной строки.
POSTLOG_SERVICE
Имя общедоступной конечной точки службы postlog.
POSTLOG_HOSTNAME
Имя хоста, которое нужно добавить к внутренним сообщениям журнала.
ПАРАМЕТРЫ КОНФИГУРАЦИИ
Следующие параметры конфигурации main.cf экспортируются в виде переменных среды с теми же именами:
config_directory (см. вывод команды 'postconf -d')
Расположение по умолчанию для файлов конфигурации main.cf и master.cf Postfix.
command_directory (см. вывод команды 'postconf -d')
Расположение всех административных команд Postfix.
daemon_directory (см. вывод команды 'postconf -d')
Каталог с программами поддержки Postfix и программами демонов.
html_directory (см. вывод команды 'postconf -d')
Расположение HTML-файлов Postfix, в которых описывается, как создавать, настраивать или управлять определенной подсистемой или функцией Postfix.
mail_owner (postfix)
Учетная запись UNIX-системы, которой принадлежат очередь Postfix и большинство процессов-демонов Postfix.
mailq_path (см. вывод команды 'postconf -d')
Функция совместимости с Sendmail, которая указывает, где установлена команда Postfix mailq(1).
manpage_directory (см. вывод команды 'postconf -d')
Где установлены страницы руководства Postfix.
newaliases_path (см. вывод команды 'postconf -d')
Функция совместимости с Sendmail, которая указывает расположение команды newaliases(1).
queue_directory (см. вывод команды 'postconf -d')
Расположение каталога верхнего уровня очереди Postfix.
readme_directory (см. вывод команды 'postconf -d')
Расположение файлов README Postfix, в которых описывается, как создавать, настраивать или управлять определенной подсистемой или функцией Postfix.
sendmail_path (см. вывод команды 'postconf -d')
Функция совместимости с Sendmail, которая указывает расположение команды Postfix sendmail(1).
setgid_group (postdrop)
Групповая принадлежность команд Postfix, использующих set-gid, и групповых каталогов, доступных для записи.
Доступно в Postfix версии 2.5 и более поздних:
data_directory (см. вывод команды 'postconf -d')
Каталог с файлами данных, доступными для записи Postfix (например, кэши, псевдослучайные числа).
Доступно в Postfix версии 3.0 и более поздних:
compatibility_level (0)
Предохранитель, который заставляет Postfix работать с совместимыми настройками по умолчанию после обновления до более новой версии Postfix.
meta_directory (см. вывод команды 'postconf -d')
Расположение неисполняемых файлов, которые совместно используются несколькими экземплярами Postfix, таких как postfix-files, dynamicmaps.cf и файлы шаблонов для нескольких экземпляров main.cf.proto и master.cf.proto.
shlib_directory (см. вывод команды 'postconf -d')
Расположение динамически связанных библиотек Postfix (libpostfix-\*.so) и расположение по умолчанию для плагинов базы данных Postfix (postfix-\*.so), имеющих относительный путь в файле dynamicmaps.cf.
Доступно в Postfix версии 3.1 и более поздних:
openssl_path (openssl)
Расположение командной строки OpenSSL [openssl]({filename}../../openssl)(1).
Другие параметры конфигурации:
import_environment (см. вывод команды 'postconf -d')
Список переменных окружения, которые привилегированный процесс Postfix импортирует из родительского процесса, не относящегося к Postfix, или переопределения переменных окружения в формате имя=значение.
syslog_facility (mail)
Системный журнал, используемый Postfix для регистрации событий.
syslog_name (см. вывод команды 'postconf -d')
Префикс, который добавляется к имени процесса в записях системного журнала, например, "smtpd" становится "prefix/smtpd".
Доступно в Postfix версии 2.6 и более поздних:
multi_instance_directories (пусто)
Необязательный список неиспользуемых по умолчанию каталогов конфигурации Postfix; эти каталоги принадлежат дополнительным экземплярам Postfix, которые совместно используют исполняемые файлы и документацию Postfix с основным экземпляром Postfix, и которые запускаются, останавливаются и т. д. вместе с основным экземпляром Postfix.
multi_instance_wrapper (пусто)
Путь к команде многоэкземплярного менеджера, которую команда postfix(1) вызывает, когда значение параметра multi_instance_directories не пусто.
multi_instance_group (пусто)
Необязательное имя группы этого экземпляра Postfix.
multi_instance_name (пусто)
Необязательное имя этого экземпляра Postfix.
multi_instance_enable (no)
Разрешить этому экземпляру Postfix запускаться, останавливаться и т. д. с помощью многоэкземплярного менеджера.
Доступно в Postfix версии 3.4 и более поздних:
maillog_file (пусто)
Имя необязательного файла журнала, в который записывает сервис postlogd(8) Postfix.
maillog_file_compressor (gzip)
Программа, которая запускается после ротации файла $maillog_file с помощью "postfix logrotate".
maillog_file_prefixes (/var, /dev/stdout)
Список разрешенных префиксов для значения maillog_file.
maillog_file_rotate_suffix (%Y%m%d-%H%M%S)
Формат суффикса, который добавляется к $maillog_file при ротации файла с помощью "postfix logrotate".
postlog_service_name (postlog)
Имя записи службы postlogd(8) в master.cf.
ФАЙЛЫ
До версии Postfix 2.6 все следующие файлы находились в $config_directory. Некоторые файлы теперь находятся в $daemon_directory или $meta_directory, чтобы их можно было совместно использовать между несколькими экземплярами, использующими одну и ту же версию Postfix.
Используйте команду "postconf config_directory" или "postconf daemon_directory", чтобы получить фактические значения.
$config_directory/main.cf, параметры конфигурации Postfix
$config_directory/master.cf, процессы-демоны Postfix
$daemon_directory/postfix-script, административные команды
$daemon_directory/post-install, конфигурация после установки
$meta_directory/dynamicmaps.cf, клиенты плагинов баз данных
$meta_directory/postfix-files, разрешения файлов/каталогов
ССЫЛКИ
Команды:
postalias(1), создание/обновление/запрос базы данных псевдонимов
postcat(1), просмотр файла очереди Postfix
postconf(1), утилита конфигурации Postfix
postdrop(1), утилита отправки почты Postfix
postfix(1), программа управления Postfix
postfix-tls(1), управление TLS Postfix
postkick(1), запуск демона Postfix
postlock(1), блокировка, совместимая с Postfix
postlog(1), регистрация, совместимая с Postfix
postmap(1), менеджер таблиц поиска Postfix
postmulti(1), многоэкземплярный менеджер Postfix
postqueue(1), управление очередью почты Postfix
postsuper(1), обслуживание Postfix
mailq(1), интерфейс совместимости с Sendmail
newaliases(1), интерфейс совместимости с Sendmail
sendmail(1), интерфейс совместимости с Sendmail
Конфигурация Postfix: bounce(5), шаблоны сообщений Postfix для ответа на ошибки доставки master(5), синтаксис файла master.cf Postfix postconf(5), синтаксис файла main.cf Postfix postfix-wrapper(5), API Postfix для многоэкземплярного режима
Механизмы, основанные на таблицах: access(5), таблица управления доступом SMTP Postfix aliases(5), локальные псевдонимы Postfix canonical(5), перезапись входных адресов Postfix generic(5), перезапись выходных адресов Postfix header_checks(5), body_checks(5), проверка содержимого Postfix relocated(5), пользователи, для которых изменен адрес transport(5), таблица маршрутизации Postfix virtual(5), виртуальные псевдонимы Postfix
Механизмы поиска в таблицах: cidr_table(5), сопоставление шаблона CIDR со значением ldap_table(5), клиент Postfix LDAP lmdb_table(5), драйвер базы данных LMDB для Postfix memcache_table(5), клиент Postfix memcache mongodb_table(5), клиент Postfix MongoDB mysql_table(5), клиент Postfix MYSQL nisplus_table(5), клиент Postfix NIS+ pcre_table(5), сопоставление шаблона PCRE со значением pgsql_table(5), клиент Postfix PostgreSQL regexp_table(5), сопоставление шаблона POSIX regexp со значением socketmap_table(5), клиент Postfix socketmap sqlite_table(5), драйвер базы данных SQLite для Postfix tcp_table(5), таблица поиска Postfix на основе протокола TCP
Демон-процессы: anvil(8), ограничение скорости и числа соединений Postfix bounce(8), defer(8), trace(8), генерация отчетов о статусе доставки cleanup(8), канонизация и постановка сообщений в очередь discard(8), агент доставки Postfix, отбрасывающий сообщения dnsblog(8), регистратор DNS для списков разрешенных/запрещенных IP-адресов error(8), агент доставки ошибок Postfix flush(8), быстрая служба ETRN для Postfix local(8), локальный агент доставки Postfix master(8), главный демон Postfix oqmgr(8), устаревший менеджер очередей Postfix pickup(8), локальный сборщик почты Postfix pipe(8), доставка почты внешней команде postlogd(8), внутренняя служба журналирования Postfix postscreen(8), блокировщик "зомби"-сообщений Postfix proxymap(8), прокси-сервер таблиц поиска Postfix qmgr(8), менеджер очередей Postfix qmqpd(8), сервер QMQP Postfix scache(8), менеджер кэша соединений Postfix showq(8), просмотр почтовой очереди Postfix smtp(8), lmtp(8), клиент SMTP+LMTP Postfix smtpd(8), сервер SMTP Postfix spawn(8), запуск внешнего сервера tlsmgr(8), менеджер кэша TLS и случайных чисел Postfix tlsproxy(8), прокси-сервер TLS Postfix trivial-rewrite(8), перезапись адресов Postfix verify(8), проверка адресов Postfix virtual(8), виртуальный агент доставки Postfix
Прочее:
syslogd(8), системное журналирование
ФАЙЛЫ README
Используйте "postconf readme_directory" или "postconf html_directory", чтобы найти эту информацию. OVERVIEW, обзор команд и процессов Postfix BASIC_CONFIGURATION_README, базовая конфигурация Postfix ADDRESS_REWRITING_README, перезапись адресов Postfix SMTPD_ACCESS_README, релейная/контроль доступа SMTP CONTENT_INSPECTION_README, проверка содержимого Postfix QSHAPE_README, анализ очереди Postfix
ЛИЦЕНЗИЯ
Лицензия Secure Mailer должна распространяться вместе с этим программным обеспечением.
АВТОР(Ы)
Витсе Венема IBM T.J. Watson Research P.O. Box 704 Йорктаун-Хайтс, Нью-Йорк 10598, США
Витсе Венема Google, Inc. 1118-я авеню Нью-Йорк, Нью-Йорк 10011, США
Поддержка TLS: Луц Яенике Бранденбургский технический университет Коттбус, Германия
Виктор Духовни Morgan Stanley
Поддержка SASL изначально разработана: Тилль Франке SuSE Rhein/Main AG 65760 Эшборн, Германия
Поддержка LMTP изначально разработана: Филип А. Приндевилл Mirapoint, Inc. США.
Амос Гуо Университет Техаса в Далласе P.O. Box 830688, MC34 Ричардсон, Техас 75083, США
Поддержка IPv6 изначально разработана: Марк Хуйзер, Эйндховенский университет, Нидерланды Дзюн-итиро 'itojun' Хагино, проект KAME, Япония Проект Linux PLD Дин Стрик, Эйндховенский университет, Нидерланды