POSTFIX(1) General Commands Manual POSTFIX(1)

postfix - برنامه واپایش Postfix

postfix [-Dv] [-c config_dir] command


این دستور برای مدیر سیستم (superuser) رزرو شده است. برای ارسال ایمیل، از دستور sendmail(1) مربوط به Postfix استفاده کنید.

دستور postfix(1) عملکرد سامانه ایمیل Postfix را واپایش می‌کند: راه‌اندازی یا متوقف کردن دیمن master(8)، انجام بررسی سلامت، و سایر امور نگهداری.

به‌طور پیش‌فرض، دستور postfix(1) یک محیط استاندارد را آماده‌سازی کرده و برای انجام کار اصلی، اسکریپت شل postfix-script را اجرا می‌کند.

با این حال، هنگامی که پشتیبانی از نمونه‌های چندگانه Postfix پیکربندی شده باشد، postfix(1) دستور مشخص‌شده در پارامتر پیکربندی multi_instance_wrapper را اجرا می‌کند. این دستور، command را برای هر نمونه قابل‌اعمال Postfix اجرا خواهد کرد.

دستورهای زیر پیاده‌سازی شده‌اند:

درباره مالکیت یا مجوزهای نادرست فایل‌ها/دایرکتوری‌ها هشدار می‌دهد، و دایرکتوری‌های ناموجود را ایجاد می‌کند.
سامانه ایمیل Postfix را راه‌اندازی می‌کند. این کار همچنین بررسی پیکربندی توضیح داده شده در بالا را اجرا می‌کند.
مانند start، اما دیمن master(8) را در پیش‌زمینه در حال اجرا نگه می‌دارد، و در صورت اجرا با PID 1، حالت "init" دیمن master(8) را فعال می‌کند. این دستور مستلزم این است که پشتیبانی از چند نمونه‌ای غیرفعال باشد (یعنی مقدار پارامتر multi_instance_directories باید خالی باشد).

هنگام اجرای Postfix درون یک کانتینر، برای ثبت گزارش در خروجی استاندارد (stdout) به MAILLOG_README مراجعه کنید. Postfix به‌طور پیش‌فرض گزارش‌ها را در syslog ثبت می‌کند، که مستلزم الف) اجرای یک پردازش syslogd درون کانتینر، یا ب) متصل کردن (mount) سوکت /dev/log میزبان کانتینر به داخل کانتینر (برای نمونه: "docker run -v /dev/log:/dev/log ...")، و ج) یک پیشوند متمایز "syslog_name" برای Postfix است که گزارش‌های مربوط به این نمونه Postfix را مشخص کند.

سامانه ایمیل Postfix را به‌صورت منظم متوقف می‌کند. در صورت امکان، به پردازش‌های در حال اجرا اجازه داده می‌شود در اولین فرصت ممکن خاتمه یابند.

نکته: به‌منظور نوسازی سامانه ایمیل Postfix پس از تغییر پیکربندی، از دستورهای start و stop به‌صورت پیاپی استفاده نکنید. به جای آن از دستور reload استفاده نمایید.

سامانه ایمیل Postfix را ناگهانی متوقف می‌کند. به پردازش‌های در حال اجرا سیگنال داده می‌شود که فوراً متوقف شوند.
تحویل اجباری: برای تحویل تمامی پیام‌های موجود در صف ایمیل‌های به تعویق افتاده تلاش می‌کند. در حالت عادی، تلاش‌ها برای تحویل ایمیل‌های با تأخیر در فواصل زمانی منظم انجام می‌شود و پس از هر تلاش ناموفق، این فاصله دو برابر می‌گردد.

هشدار: ارسال اجباری (flush) مکرر ایمیل‌های غیرقابل‌تحویل منجر به افت کارایی در تحویل سایر ایمیل‌ها خواهد شد.

فایل‌های پیکربندی را مجدداً می‌خواند. پردازش‌های در حال اجرا در اولین فرصت ممکن خاتمه می‌یابند.
نشان می‌دهد که آیا سامانه ایمیل Postfix در حال حاضر در حال اجرا است (وضعیت خروج صفر) یا متوقف شده است (وضعیت خروج غیرصفر).
مالکیت و مجوزهای فایل‌ها و دایرکتوری‌های مربوط به Postfix را، مطابق با آنچه در فایل postfix-files مشخص شده، تنظیم می‌کند.

برای بازنویسی و به‌روزرسانی پارامترهای پیکربندی خاص main.cf، از name=value استفاده کنید. برای نمونه، از این قابلیت برای تغییر تنظیمات mail_owner یا setgid_group در سامانه Postfix از پیش نصب‌شده استفاده نمایید.

این ویژگی در Postfix نسخه 2.1 و بالاتر در دسترس است. با Postfix نسخه 2.0 و پیش‌تر، از "$config_directory/post-install set-permissions" استفاده کنید.

فایل گزارش مشخص‌شده با $maillog_file را با الصاق یک پسوند مهر زمانی که مطابق با $maillog_file_rotate_suffix قالب‌بندی شده، و با فشرده‌سازی فایل توسط دستور مشخص‌شده با $maillog_file_compressor بازچرخانی می‌کند. این دستور فایل‌های /dev/* را بازچرخانی نخواهد کرد.
مهاجرت دادن یک پیکربندی Postfix که از جدول‌های Berkeley DB یعنی hash: یا btree: استفاده می‌کند، به پیکربندی‌ای که از lmdb: یا ترکیبی از cdb: و lmdb: استفاده می‌نماید. این کار به این دلیل لازم است که برخی از توزیع‌های (لینوکس) پشتیبانی از Berkeley DB را حذف کرده‌اند. برای مستندات به postfix-nbdb(1) مراجعه کنید.

این ویژگی در Postfix نسخه 3.11 و بالاتر موجود است.

فعال‌سازی TLS فرصت‌طلبانه (opportunistic) در کلاینت یا سرور Postfix SMTP، و مدیریت کلیدهای خصوصی و گواهی‌های TLS در سرور Postfix SMTP. برای مستندات به postfix-tls(1) مراجعه کنید.

این ویژگی در Postfix نسخه 3.1 و بالاتر موجود است.

فایل‌های main.cf و master.cf را با اطلاعاتی که Postfix برای اجرا به آن‌ها نیاز دارد به‌روزرسانی می‌کند: افزودن یا به‌روزرسانی سرویس‌ها، و افزودن یا به‌روزرسانی تنظیمات پارامترهای پیکربندی.

برای بازنویسی و به‌روزرسانی پارامترهای پیکربندی خاص در main.cf، مقدار name=value را مشخص کنید.

این ویژگی در Postfix نسخه 2.1 و بالاتر موجود است. با Postfix نسخه 2.0 و پیش‌تر، از "$config_directory/post-install upgrade-configuration" استفاده کنید.

گزینه‌های زیر پیاده‌سازی شده‌اند:

فایل‌های پیکربندی main.cf و master.cf را به جای دایرکتوری پیش‌فرض پیکربندی، از دایرکتوری نام‌برده می‌خواند. از این گزینه برای تمایز میان چندین نمونه Postfix روی یک میزبان یکسان استفاده کنید.

در Postfix نسخه 2.6 و بالاتر، این گزینه دستور postfix(1) را وادار می‌کند تنها روی نمونه Postfix مشخص‌شده عمل کند. این رفتار توسط دستورهای postfix(1) که به‌عنوان فرزند پردازش فعلی اجرا می‌شوند نیز به ارث برده می‌شود.

اجرای هر دیمن Postfix تحت کنترل یک اشکال‌زدا (debugger) همان‌طور که توسط پارامتر پیکربندی debugger_command مشخص شده است.
فعال‌سازی گزارش‌دهی پرگو (verbose) برای اهداف اشکال‌زدایی. استفاده از چندین گزینه -v پرگویی نرم‌افزار را افزایش می‌دهد..SH "محیط (ENVIRONMENT)" دستور postfix(1) پیش از اجرای فایل postfix-script، متغیرهای محیطی زیر را صادر (export) می‌کند:
این متغیر زمانی که گزینه خط فرمان -c مشخص شده باشد، مقداردهی می‌شود.

در Postfix نسخه 2.6 و بالاتر، این متغیر محیطی دستور postfix(1) را وادار می‌کند تا تنها بر روی نمونه مشخص‌شدهٔ Postfix عمل کند. این رفتار به دستورهای postfix(1) که به عنوان فرزند فرایند جاری اجرا می‌شوند نیز به ارث می‌رسد.

این متغیر زمانی که گزینه خط فرمان -v مشخص شده باشد، مقداردهی می‌شود.
این متغیر زمانی که گزینه خط فرمان -D مشخص شده باشد، مقداردهی می‌شود.

هنگامی که سرویس گزارش‌گیری داخلی فعال باشد (با تنظیم مقداری غیرخالی برای پارامتر maillog_file)، دستور postfix(1) تنظیماتی را صادر می‌کند که توسط فرایندهای فرزند، پیش از آن‌که main.cf یا تنظیمات خط فرمان را پردازش کرده باشند، استفاده می‌شود.

نام نقطه پایانی (endpoint) عمومی سرویس postlog.
نام میزبان (hostname) که باید به ابتدای گزارش‌های داخلی اضافه شود.

پارامترهای پیکربندی main.cf زیر به عنوان متغیرهای محیطی با همان نام‌ها صادر می‌شوند:

مکان پیش‌فرض فایل‌های پیکربندی main.cf و master.cf در Postfix.
مکان تمام دستورهای مدیریتی postfix.
دایرکتوری شامل برنامه‌های پشتیبان و برنامه‌های دیمن Postfix.
مکان فایل‌های HTML مربوط به Postfix که نحوه ساخت، پیکربندی یا به‌کارگیری یک زیرسیستم یا ویژگی خاص Postfix را شرح می‌دهند.
حساب کاربری سیستم UNIX که مالک صف Postfix و بیشتر فرایندهای دیمن Postfix است.
قابلیت سازگاری با Sendmail که مشخص می‌کند دستور mailq(1) مربوط به Postfix در کجا نصب شده است.
مکانی که صفحات راهنمای (man pages) مربوط به Postfix در آن نصب شده‌اند.
قابلیت سازگاری با Sendmail که مکان دستور newaliases(1) را مشخص می‌کند.
مکان بالاترین سطح دایرکتوری صف Postfix.
مکان فایل‌های README مربوط به Postfix که نحوه ساخت، پیکربندی یا به‌کارگیری یک زیرسیستم یا ویژگی خاص Postfix را شرح می‌دهند.
قابلیت سازگاری با Sendmail که مکان دستور sendmail(1) مربوط به Postfix را مشخص می‌کند.
مالکیت گروهی دستورهای set-gid در Postfix و دایرکتوری‌های قابل نوشتن توسط گروه در Postfix.

در Postfix نسخه 2.5 و بالاتر موجود است:

دایرکتوری فایل‌های داده قابل نوشتن توسط Postfix (برای مثال: حافظه‌های موقت/کَش‌ها، اعداد شبه‌تصادفی).

در Postfix نسخه 3.0 و بالاتر موجود است:

یک سازوکار امنیتی که باعث می‌شود Postfix پس از ارتقا به نسخه‌ای جدیدتر، با تنظیمات پیش‌فرض سازگار با نسخه‌های قبلی (backwards-compatible) اجرا شود.
مکان فایل‌های غیرقابل‌اجرایی که بین چند نمونه Postfix به اشتراک گذاشته می‌شوند؛ مانند postfix-files، dynamicmaps.cf، و فایل‌های الگوی چندنمونه‌ای main.cf.proto و master.cf.proto.
مکان کتابخانه‌های پیوندیافتهٔ پویا در Postfix‏ (libpostfix-*.so)، و مکان پیش‌فرض پلاگین‌های پایگاه‌داده Postfix‏ (postfix-*.so) که دارای مسیر نسبی در فایل dynamicmaps.cf هستند.

در Postfix نسخه 3.1 و بالاتر موجود است:

مکان برنامه خط فرمانی OpenSSL به نام openssl(1).

سایر پارامترهای پیکربندی:

فهرستی از متغیرهای محیطی که یک فرایند ممتاز (privileged) در Postfix از فرایند والد غیر Postfix وارد می‌کند، یا بازنویسی‌های متغیرهای محیطی به صورت name=value.
تسهیلات syslog برای گزارش‌گیری Postfix.
پیشوندی که در رکوردهای syslog به ابتدای نام فرایند اضافه می‌شود، به طوری که برای نمونه «smtpd» به «prefix/smtpd» تبدیل می‌شود.

در Postfix نسخه 2.6 و بالاتر موجود است:

فهرستی اختیاری از دایرکتوری‌های پیکربندی غیرپیش‌فرض Postfix؛ این دایرکتوری‌ها متعلق به نمونه‌های اضافی Postfix هستند که فایل‌های اجرایی و مستندات را با نمونه پیش‌فرض Postfix به اشتراک می‌گذارند و همراه با نمونه پیش‌فرض Postfix راه‌اندازی، متوقف و غیره می‌شوند.
مسیر دستور مدیر چندنمونه‌ای که در صورت خالی نبودن مقدار پارامتر multi_instance_directories، توسط دستور postfix(1) فراخوانی می‌شود.
نام اختیاری گروه نمونه برای این نمونه Postfix.
نام اختیاری نمونه برای این نمونه Postfix.
مجاز کردن این نمونه Postfix برای راه‌اندازی، توقف و غیره توسط یک مدیر چندنمونه‌ای.

در Postfix نسخه 3.4 و بالاتر موجود است:

نام یک فایل لاگ اختیاری که توسط سرویس postlogd(8) در Postfix نوشته می‌شود.
برنامه‌ای که پس از چرخش (rotate) فایل $maillog_file با دستور «postfix logrotate» اجرا می‌شود.
فهرستی از پیشوندهای مجاز برای مقدار maillog_file.
قالب پسوندی که در هنگام چرخش فایل با دستور «postfix logrotate» به انتهای $maillog_file افزوده می‌شود.
نام مدخل سرویس postlogd(8) در master.cf..SH "فایل‌ها (FILES)" پیش از نسخه ۲.۶ پست‌فیکس (Postfix)، تمام فایل‌های زیر در $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-non-bdb(1)، مهاجرت به Non-Berkeley-DB در 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)، واسط چندنمونه‌ای 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)، کلاینت LDAP در Postfix
lmdb_table(5)، درایور پایگاه‌داده LMDB در Postfix
memcache_table(5)، کلاینت memcache در Postfix
mongodb_table(5)، کلاینت MongoDB در Postfix
mysql_table(5)، کلاینت MYSQL در Postfix
nisplus_table(5)، کلاینت NIS+ در Postfix
pcre_table(5)، پیوند دادن الگوی PCRE با مقدار
pgsql_table(5)، کلاینت PostgreSQL در Postfix
regexp_table(5)، پیوند دادن الگوی عبارت باقاعده POSIX با مقدار
socketmap_table(5)، کلاینت socketmap در Postfix
sqlite_table(5)، درایور پایگاه‌داده SQLite در Postfix
tcp_table(5)، جستجوی جدول کلاینت-سرور در Postfix
فرایندهای دیمن:
anvil(8)، محدودسازی نرخ/اتصال در Postfix
bounce(8), defer(8), trace(8)، گزارش‌های وضعیت تحویل
cleanup(8)، متعارف‌سازی و صف‌بندی پیام
discard(8)، عامل تحویل نادیده‌گیر در Postfix
dnsblog(8)، ثبت‌کننده فهرست‌های مجاز/مسدود DNS
error(8)، عامل تحویل خطای Postfix
flush(8)، سرویس سریع ETRN در Postfix
local(8)، عامل تحویل محلی Postfix
master(8)، دیمن اصلی Postfix
oqmgr(8)، مدیر صف قدیمی Postfix
pickup(8)، دریافت محلی نامه‌ها در Postfix
pipe(8)، تحویل نامه به دستور غیر Postfix
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)، اجرای سرور غیر Postfix
tlsmgr(8)، مدیر حافظه نهان و تصادفی‌سازی TLS در Postfix
tlsproxy(8)، سرور پروکسی TLS در Postfix
trivial-rewrite(8)، بازنویسی نشانی در Postfix
verify(8)، بررسی صحت نشانی در Postfix
virtual(8)، عامل تحویل مجازی Postfix
موارد دیگر:
syslogd(8)، ثبت وقایع سیستم.SH "فایل‌های راهنما (README FILES)"

برای یافتن مکان این اطلاعات از "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 باید همراه با این نرم‌افزار توزیع شود.

Wietse Venema
IBM T.J. Watson Research
P.O. Box 704
Yorktown Heights, NY 10598, USA
Wietse Venema
Google, Inc.
111 8th Avenue
New York, NY 10011, USA
پشتیبانی از TLS توسط:
Lutz Jaenicke
Brandenburg University of Technology
Cottbus, Germany
Victor Duchovni
Morgan Stanley
پشتیبانی اولیه از SASL توسط:
Till Franke
SuSE Rhein/Main AG
65760 Eschborn, Germany
پشتیبانی اولیه از LMTP توسط:
Philip A. Prindeville
Mirapoint, Inc.
USA.
Amos Gouaux
University of Texas at Dallas
P.O. Box 830688, MC34
Richardson, TX 75083, USA
پشتیبانی اولیه از IPv6 توسط:
Mark Huizer, Eindhoven University, The Netherlands
Jun-ichiro 'itojun' Hagino, KAME project, Japan
The Linux PLD project
Dean Strik, Eindhoven University, The Netherlands