.TH VIRTUAL 8
.ad
.fi
.SH "نام (NAME)"
virtual \- عامل تحویل ایمیل دامنه مجازی Postfix
.SH "خلاصه دستور (SYNOPSIS)"
.na
.nf
\fBvirtual\fR [گزینه‌های عمومی دیمن Postfix]
.SH "توضیحات (DESCRIPTION)"
.ad
.fi
عامل تحویل
\fBvirtual\fR(8)
برای سرویس‌های میزبانی ایمیل مجازی طراحی شده است. این عامل که در ابتدا بر پایه عامل تحویل
\fBlocal\fR(8)
پست‌فیکس (Postfix) توسعه یافته بود، گیرندگان را با استفاده از جستجوی نگاشت برای نشانی کامل گیرنده پیدا می‌کند؛ به جای آنکه مانند گذشته از جستجوی هاردکدشده در فایل رمز عبور یونیکس تنها برای بخش محلی نشانی استفاده کند.

این عامل تحویل فقط ایمیل را تحویل می‌دهد. سایر قابلیت‌ها مانند فوروارد ایمیل، اعلان‌های خارج از دسترس بودن (out\-of\-office) و غیره باید از طریق نگاشت‌های virtual_alias یا سازوکارهای مشابه جستجو پیکربندی شوند.
.SH "مکان صندوق پستی (MAILBOX LOCATION)"
.na
.nf
.ad
.fi
مکان صندوق پستی توسط پارامترهای پیکربندی
\fBvirtual_mailbox_base\fR
و
\fBvirtual_mailbox_maps\fR
کنترل می‌شود (به بخش زیر مراجعه کنید). جدول
\fBvirtual_mailbox_maps\fR
بر اساس نشانی گیرنده به ترتیبی که در بخش «ترتیب جستجوی جدول (TABLE SEARCH ORDER)» در ادامه آمده است نمایه می‌شود.

مسیر صندوق پستی به صورت زیر ساخته می‌شود:

.nf
  \fB$virtual_mailbox_base/$virtual_mailbox_maps(\fIrecipient\fB)\fR
.fi

که در آن
\fIrecipient\fR
نشانی کامل گیرنده است.
.SH "قالب صندوق پستی یونیکس (UNIX MAILBOX FORMAT)"
.na
.nf
.ad
.fi
هنگامی که مکان صندوق پستی به
\fB/\fR
ختم نشود، پیام در قالب صندوق پستی یونیکس (UNIX mailbox) تحویل داده می‌شود. این قالب چندین پیام را در یک فایل متنی ذخیره می‌کند.

عامل تحویل
\fBvirtual\fR(8)
یک هدر پاکت‌نامه «\fBFrom \fIsender time_stamp\fR» را به ابتدای هر پیام اضافه می‌کند، یک هدر پیام
\fBDelivered\-To:\fR
حاوی نشانی گیرنده پاکت‌نامه را درج می‌نماید، یک هدر
\fBX\-Original\-To:\fR
حاوی نشانی گیرنده به همان صورتی که به Postfix داده شده بود اضافه می‌کند، یک هدر پیام
\fBReturn\-Path:\fR
با نشانی فرستنده پاکت‌نامه درج می‌کند، نویسه
\fB>\fR
را به ابتدای خطوطی که با «\fBFrom \fR» آغاز می‌شوند می‌افزاید، و یک خط خالی به انتهای آن اضافه می‌کند.

صندوق پستی در حین انجام تحویل، برای دسترسی انحصاری قفل می‌شود. در صورت بروز مشکل، تلاش می‌شود تا صندوق پستی به اندازه اولیه خود کوتاه (truncate) شود.
.SH "قالب MAILDIR کیومیل (QMAIL MAILDIR FORMAT)"
.na
.nf
.ad
.fi
هنگامی که مکان صندوق پستی به
\fB/\fR
ختم شود، پیام در قالب
\fBmaildir\fR
کیومیل (qmail) تحویل داده می‌شود. این قالب هر پیام را در یک فایل جداگانه ذخیره می‌کند.

عامل تحویل
\fBvirtual\fR(8)
یک هدر پیام
\fBDelivered\-To:\fR
حاوی نشانی نهایی گیرنده پاکت‌نامه، یک هدر
\fBX\-Original\-To:\fR
حاوی نشانی گیرنده به همان صورتی که به Postfix داده شده بود، و یک هدر پیام
\fBReturn\-Path:\fR
با نشانی فرستنده پاکت‌نامه به ابتدای پیام اضافه می‌کند.

طبق تعریف، قالب
\fBmaildir\fR
در طول تحویل یا بازیابی ایمیل نیازی به قفل‌گذاری فایل در سطح برنامه ندارد.
.SH "مالکیت صندوق پستی (MAILBOX OWNERSHIP)"
.na
.nf
.ad
.fi
مالکیت صندوق پستی توسط جدول‌های جستجوی
\fBvirtual_uid_maps\fR
و
\fBvirtual_gid_maps\fR
کنترل می‌شود که با نشانی کامل گیرنده نمایه می‌شوند. هر جدول به ترتیب رشته‌ای حاوی شناسه عددی کاربر (UID) و گروه (GID) را ارائه می‌دهد.

پارامتر
\fBvirtual_minimum_uid\fR
یک حد پایین برای مقادیر عددی شناسه کاربر (UID) که ممکن است در هر یک از
\fBvirtual_uid_maps\fR
مشخص شوند اعمال می‌کند.
.SH "تبدیل بزرگی و کوچکی حروف (CASE FOLDING)"
.na
.nf
.ad
.fi
تمام تصمیم‌گیری‌های تحویل با استفاده از نشانی کامل گیرنده که به حروف کوچک تبدیل شده است، انجام می‌شود. همچنین برای چند مورد استثنا در رابطه با پسوندهای اختیاری نشانی، به بخش بعدی مراجعه کنید.
.SH "ترتیب جستجوی جدول (TABLE SEARCH ORDER)"
.na
.nf
.ad
.fi
به طور معمول، یک جدول جستجو به عنوان یک فایل متنی مشخص می‌شود که به عنوان ورودی دستور
\fBpostmap\fR(1)
عمل می‌کند. نتیجه که یک فایل نمایه‌سازی‌شده در قالب
\fBdbm\fR
یا
\fBdb\fR
است، برای جستجوی سریع توسط سیستم ایمیل استفاده می‌شود.

ترتیب جستجو به شرح زیر است. جستجو با اولین انطباق موفقیت‌آمیز متوقف می‌شود:
.IP \(bu
هنگامی که گیرنده دارای پسوند اختیاری نشانی باشد، ابتدا نشانی
\fIuser+extension@domain.tld\fR
جستجو می‌شود.
.sp
در نسخه‌های Postfix قبل از ۲.۱، پسوند اختیاری نشانی همیشه نادیده گرفته می‌شود.
.IP \(bu
سپس نشانی
\fIuser@domain.tld\fR
(بدون پسوند نشانی) جستجو می‌شود.
.IP \(bu
در نهایت، نشانی
\fI@domain\fR
گیرنده جستجو می‌شود.
.PP
هنگامی که جدول از طریق روش‌های دیگری مانند NIS، LDAP یا SQL ارائه می‌شود، همان جستجوهایی که برای فایل‌های نمایه‌سازی‌شده معمولی انجام می‌شد، صورت می‌پذیرد.

علاوه بر این، یک جدول می‌تواند به عنوان یک نگاشت عبارات باقاعده (regular expression) ارائه شود که در آن الگوها به صورت عبارات باقاعده مشخص می‌شوند. در این حالت، فقط نشانی کامل گیرنده به نگاشت عبارات باقاعده داده می‌شود.
.SH "امنیت (SECURITY)"
.na
.nf
.ad
.fi
عامل تحویل
\fBvirtual\fR(8)
از نظر امنیتی حساس تلقی نمی‌شود، مشروط بر اینکه جدول‌های جستجوی حاوی اطلاعات شناسه کاربر/گروه گیرنده به اندازه کافی محافظت شده باشند. این برنامه برای اجرا در محیط chroot طراحی نشده است.

عامل تحویل
\fBvirtual\fR(8)
جایگزینی متغیرهای عبارات باقاعده مانند $1 و غیره را در جدول‌های جستجوی عبارات باقاعده مجاز نمی‌داند، زیرا این کار یک رخنه امنیتی ایجاد می‌کند.

عامل تحویل
\fBvirtual\fR(8)
درخواست‌های استفاده از کارگزار
\fBproxymap\fR(8)
را بدون هیچ پیامی نادیده می‌گیرد و در عوض جدول را مستقیماً باز می‌کند. پیش از نسخه ۲.۲ Postfix، عامل تحویل مجازی با یک خطای مهلک (fatal error) متوقف می‌شد.
.SH "استانداردها (STANDARDS)"
.na
.nf
RFC 822 (ARPA Internet Text Messages)
.SH "عیب‌یابی (DIAGNOSTICS)"
.ad
.fi
هنگامی که گیرنده صندوق پستی نداشته باشد یا سهمیه دیسک (disk quota) گیرنده پر شده باشد، ایمیل برگشت می‌خورد (bounce می‌شود). در تمامی موارد دیگر بروز مشکل، ایمیل گیرنده موجود به تعویق می‌افتد (deferred می‌شود) و یک هشدار در لاگ ثبت می‌گردد.

مشکلات و تراکنش‌ها در
\fBsyslogd\fR(8)
یا
\fBpostlogd\fR(8)
ثبت می‌شوند. فایل‌های پیام آسیب‌دیده علامت‌گذاری می‌شوند تا مدیر صف (queue manager) بتواند بعداً آن‌ها را به صف
\fBcorrupt\fR
منتقل کند.

بسته به مقدار تنظیم‌شده برای پارامتر
\fBnotify_classes\fR،
مدیر پست (postmaster) از برگشت‌ها و سایر مشکلات مطلع می‌شود.
.SH "اشکالات (BUGS)"
.ad
.fi
این عامل تحویل از پسوندهای نشانی در نشانی‌های ایمیل و در کلیدهای جدول جستجو پشتیبانی می‌کند، اما اطلاعات پسوند نشانی را به نتیجه جستجوی جدول انتقال نمی‌دهد.

پست‌فیکس باید دارای جدول‌های جستجویی باشد که بتوانند چندین ویژگی نتیجه را برگردانند. برای جلوگیری از زحمت نگهداری سه جدول، از یک پایگاه‌داده LDAP یا MYSQL استفاده کنید.
.SH "پارامترهای پیکربندی (CONFIGURATION PARAMETERS)"
.na
.nf
.ad
.fi
تغییرات ایجادشده در
\fBmain.cf\fR
به طور خودکار اعمال می‌شوند، زیرا فرایندهای
\fBvirtual\fR(8)
تنها برای مدت محدودی اجرا می‌شوند. برای اعمال سریع‌تر تغییرات از دستور «\fBpostfix reload\fR» استفاده کنید.

متن زیر تنها خلاصه‌ای از پارامترها را ارائه می‌دهد. برای جزئیات بیشتر به همراه مثال‌ها به
\fBpostconf\fR(5)
مراجعه کنید.
.SH "کنترل‌های تحویل صندوق پستی (MAILBOX DELIVERY CONTROLS)"
.na
.nf
.ad
.fi
.IP "\fBvirtual_mailbox_base (خالی)\fR"
پیشوندی که عامل تحویل
\fBvirtual\fR(8)
به ابتدای تمام نتایج مسیر حاصل از جستجوهای جدول $virtual_mailbox_maps اضافه می‌کند.
.IP "\fBvirtual_mailbox_maps (خالی)\fR"
جدول‌های جستجوی اختیاری شامل تمام نشانی‌های معتبر در دامنه‌هایی که با $virtual_mailbox_domains مطابقت دارند.
.IP "\fBvirtual_minimum_uid (100)\fR"
حداقل مقدار شناسه کاربر (UID) که عامل تحویل
\fBvirtual\fR(8)
به عنوان نتیجه حاصل از جستجوی جدول $virtual_uid_maps می‌پذیرد.
.IP "\fBvirtual_uid_maps (خالی)\fR"
جدول‌های جستجو حاوی شناسه کاربر (UID) به ازای هر گیرنده که عامل تحویل
\fBvirtual\fR(8)
هنگام نوشتن در صندوق پستی گیرنده از آن استفاده می‌کند.
.IP "\fBvirtual_gid_maps (خالی)\fR"
جدول‌های جستجو حاوی شناسه گروه (GID) به ازای هر گیرنده برای تحویل صندوق پستی
\fBvirtual\fR(8).
.PP
موجود در Postfix نسخه ۲.۰ و بالاتر:
.IP "\fBvirtual_mailbox_domains ($virtual_mailbox_maps)\fR"
پست‌فیکس مقصد نهایی برای فهرست مشخص‌شده دامنه‌ها است؛ ایمیل از طریق سیستم انتقال تحویل ایمیل $virtual_transport تحویل داده می‌شود.
.IP "\fBvirtual_transport (virtual)\fR"
سیستم انتقال پیش‌فرض تحویل ایمیل و مقصد گام بعدی (next\-hop) برای تحویل نهایی به دامنه‌های فهرست‌شده در $virtual_mailbox_domains.
.PP
موجود در Postfix نسخه ۲.۵.۳ و بالاتر:
.IP "\fBstrict_mailbox_ownership (yes)\fR"
به تعویق انداختن تحویل ایمیل هنگامی که مالک فایل صندوق پستی، گیرنده آن نباشد.
.SH "کنترل‌های قفل‌گذاری (LOCKING CONTROLS)"
.na
.nf
.ad
.fi
.IP "\fBvirtual_mailbox_lock (خروجی 'postconf \-d' را ببینید)\fR"
نحوه قفل‌گذاری یک صندوق پستی سبک یونیکس
\fBvirtual\fR(8)
پیش از تلاش برای تحویل.
.IP "\fBdeliver_lock_attempts (20)\fR"
حداکثر تعداد دفعات تلاش برای دریافت قفل انحصاری روی یک فایل صندوق پستی یا فایل لاگ
\fBbounce\fR(8).
.IP "\fBdeliver_lock_delay (1s)\fR"
مدت زمان بین تلاش‌ها برای دریافت قفل انحصاری روی یک فایل صندوق پستی یا فایل لاگ
\fBbounce\fR(8).
.IP "\fBstale_lock_time (500s)\fR"
مدت زمانی که پس از آن، فایل قفل انحصاری کهنه (stale) صندوق پستی حذف می‌شود.
.SH "کنترل‌های منابع و نرخ (RESOURCE AND RATE CONTROLS)"
.na
.nf
.ad
.fi
.IP "\fBvirtual_mailbox_limit (51200000)\fR"
حداکثر اندازه بر حسب بایت برای یک صندوق پستی مجزای
\fBvirtual\fR(8)
یا فایل maildir، یا صفر (بدون محدودیت).
.PP
پیاده‌سازی‌شده در دیمن qmgr(8):
.IP "\fBvirtual_destination_concurrency_limit ($default_destination_concurrency_limit)\fR"
حداکثر تعداد تحویل‌های موازی به یک مقصد یکسان از طریق سیستم انتقال تحویل پیام مجازی.
.IP "\fBvirtual_destination_recipient_limit ($default_destination_recipient_limit)\fR"
حداکثر تعداد گیرندگان در هر پیام برای سیستم انتقال تحویل پیام مجازی.
.SH "کنترل‌های گوناگون (MISCELLANEOUS CONTROLS)"
.na
.nf
.ad
.fi
.IP "\fBconfig_directory (خروجی 'postconf \-d' را ببینید)\fR"
مکان پیش‌فرض فایل‌های پیکربندی main.cf و master.cf پست‌فیکس.
.IP "\fBdaemon_timeout (18000s)\fR"
حداکثر زمانی که یک فرایند دیمن Postfix مجاز است برای رسیدگی به یک درخواست صرف کند، پیش از آنکه توسط تایمر دیده‌بان (watchdog) داخلی متوقف شود.
.IP "\fBdelay_logging_resolution_limit (2)\fR"
حداکثر تعداد ارقام بعد از ممیز اعشار هنگام ثبت مقادیر تأخیر در لاگ.
.IP "\fBipc_timeout (3600s)\fR"
محدودیت زمانی برای ارسال یا دریافت اطلاعات از طریق یک کانال ارتباطی داخلی.
.IP "\fBmax_idle (100s)\fR"
حداکثر مدت زمانی که یک فرایند بیکار دیمن Postfix پیش از پایان داوطلبانه کار، در انتظار یک اتصال ورودی می‌ماند.
.IP "\fBmax_use (100)\fR"
حداکثر تعداد اتصالات ورودی که یک فرایند دیمن Postfix پیش از پایان داوطلبانه کار سرویس‌دهی می‌کند.
.IP "\fBprocess_id (فقط‌خواندنی)\fR"
شناسه فرایند (PID) یک دستور یا فرایند دیمن Postfix.
.IP "\fBprocess_name (فقط‌خواندنی)\fR"
نام فرایند یک دستور یا فرایند دیمن Postfix.
.IP "\fBqueue_directory (خروجی 'postconf \-d' را ببینید)\fR"
مکان دایرکتوری سطح بالای صف Postfix.
.IP "\fBsyslog_facility (mail)\fR"
امکانات ثبت وقایع سیستم (syslog facility) برای لاگ‌گیری Postfix.
.IP "\fBsyslog_name (خروجی 'postconf \-d' را ببینید)\fR"
پیشوندی که به ابتدای نام فرایند در رکوردهای syslog اضافه می‌شود، به عنوان مثال "smtpd" به صورت "prefix/smtpd" ثبت می‌شود.
.PP
موجود در Postfix نسخه ۳.۰ و بالاتر:
.IP "\fBvirtual_delivery_status_filter ($default_delivery_status_filter)\fR"
فیلتر اختیاری برای عامل تحویل
\fBvirtual\fR(8)
جهت تغییر کد وضعیت تحویل یا متن توضیحی تحویل‌های موفق یا ناموفق.
.PP
موجود در Postfix نسخه ۳.۳ و بالاتر:
.IP "\fBenable_original_recipient (yes)\fR"
فعال‌سازی پشتیبانی از نشانی اصلی گیرنده پس از بازنویسی نشانی به یک نشانی دیگر (به عنوان مثال با نام مستعار یا نگاشت متعارف/canonical).
.IP "\fBservice_name (فقط‌خواندنی)\fR"
نام سرویس یک فرایند دیمن Postfix در master.cf.
.PP
موجود در Postfix نسخه ۳.۵ و بالاتر:
.IP "\fBinfo_log_address_format (external)\fR"
قالب نشانی ایمیل که در ثبت وقایع غیردیباگ (اطلاعات، هشدار و غیره) استفاده خواهد شد.
.SH "همچنین ببینید (SEE ALSO)"
.na
.nf
qmgr(8), مدیر صف
bounce(8), گزارش‌های وضعیت تحویل
postconf(5), پارامترهای پیکربندی
postlogd(8), ثبت وقایع Postfix
syslogd(8), ثبت وقایع سیستم
.SH "فایل‌های راهنما (README_FILES)"
.na
.nf
برای یافتن این اطلاعات از «\fBpostconf readme_directory\fR» یا
«\fBpostconf html_directory\fR» استفاده کنید.
VIRTUAL_README, راهنمای میزبانی دامنه
.SH "مجوز (LICENSE)"
.na
.nf
.ad
.fi
مجوز نرم‌افزار امنیتی ایمیل (Secure Mailer license) باید همراه با این نرم‌افزار توزیع شود.
.SH "تاریخچه (HISTORY)"
.ad
.fi
این عامل تحویل در ابتدا بر پایه عامل تحویل محلی Postfix توسعه یافته بود. تغییرات عمدتاً شامل حذف کدهایی بود که یا در این زمینه کاربرد نداشتند یا ایمن نبودند: نام‌های مستعار، فایل‌های ‎~user/.forward‎، تحویل به "|command" یا به ‎/file/name‎.

هدر پیام
\fBDelivered\-To:\fR
در سیستم
\fBqmail\fR
اثر Daniel Bernstein معرفی شد.

ساختار
\fBmaildir\fR
در سیستم
\fBqmail\fR
اثر Daniel Bernstein معرفی شد.
.SH "نویسندگان (AUTHORS)"
.na
.nf
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

Andrew McNamara
andrewm@connect.com.au
connect.com.au Pty. Ltd.
Level 3, 213 Miller St
North Sydney 2060, NSW, Australia