.TH TRANSPORT 5
.ad
.fi
.SH "نام (NAME)"
transport \- قالب جدول انتقال (transport) در Postfix
.SH "خلاصه دستور (SYNOPSIS)"
.na
.nf
\fBpostmap /etc/postfix/transport\fR

\fBpostmap \-q "\fIstring\fB" /etc/postfix/transport\fR

\fBpostmap \-q \- /etc/postfix/transport <\fIinputfile\fR
.SH "توضیحات (DESCRIPTION)"
.ad
.fi
جدول اختیاری \fBtransport\fR(5) یک نگاشت از نشانی‌های ایمیل به سازوکارهای انتقال تحویل پیام و مقصدهای گام بعدی (next\-hop) را مشخص می‌کند.
سازوکارهای انتقال تحویل پیام مانند \fBlocal\fR یا \fBsmtp\fR در فایل \fBmaster.cf\fR تعریف می‌شوند، و مقصدهای گام بعدی معمولاً نام میزبان یا نام دامنه هستند.
این جدول توسط دیمن \fBtrivial\-rewrite\fR(8) جستجو می‌شود.

این نگاشت، انتخاب پیش‌فرض \fItransport\fR:\fInexthop\fR را که درون Postfix تعبیه شده است لغو می‌کند (بازنویسی می‌کند):
.IP "\fBlocal_transport (پیش‌فرض: local:$myhostname)\fR"
این مقدار پیش‌فرض برای تحویل نهایی به دامنه‌های فهرست‌شده با \fBmydestination\fR، و برای مقصدهای [\fIipaddress\fR] که با \fB$inet_interfaces\fR یا \fB$proxy_interfaces\fR مطابقت دارند، است.

به ترتیب اولویت نزولی، مقصد \fInexthop\fR از \fBtransport_maps\fR، \fBlocal_transport\fR، یا از دامنه گیرنده گرفته می‌شود.
.IP "\fBvirtual_transport (پیش‌فرض: virtual:)\fR"
این مقدار پیش‌فرض برای تحویل نهایی به دامنه‌های فهرست‌شده با \fBvirtual_mailbox_domains\fR است.

به ترتیب اولویت نزولی، مقصد \fInexthop\fR از \fBtransport_maps\fR، \fBvirtual_transport\fR، یا از دامنه گیرنده گرفته می‌شود.
.IP "\fBrelay_transport (پیش‌فرض: relay:)\fR"
این مقدار پیش‌فرض برای تحویل از راه دور به دامنه‌های فهرست‌شده با \fBrelay_domains\fR است.

به ترتیب اولویت نزولی، مقصد \fInexthop\fR از \fBtransport_maps\fR، \fBrelay_transport\fR، \fBsender_dependent_relayhost_maps\fR، \fBrelayhost\fR، یا از دامنه گیرنده گرفته می‌شود.
.IP "\fBdefault_transport (پیش‌فرض: smtp:)\fR"
این مقدار پیش‌فرض برای تحویل از راه دور به سایر مقصدها است.

به ترتیب اولویت نزولی، مقصد \fInexthop\fR از \fBtransport_maps\fR، \fBsender_dependent_default_transport_maps\fR، \fBdefault_transport\fR، \fBsender_dependent_relayhost_maps\fR، \fBrelayhost\fR، یا از دامنه گیرنده گرفته می‌شود.
.PP
به‌طور معمول، جدول \fBtransport\fR(5) به عنوان یک فایل متنی مشخص می‌شود که به عنوان ورودی دستور \fBpostmap\fR(1) برای ایجاد یک فایل نمایه‌سازی‌شده جهت جستجوی سریع به کار می‌رود.

دستور «\fBpostmap /etc/postfix/transport\fR» را برای بازسازی فایل نمایه‌سازی‌شده از نوع پیش‌فرض پس از تغییر فایل متنی اجرا کنید، یا «\fBpostmap \fItype\fB:/etc/postfix/transport\fR» را برای تعیین صریح یک نوع اجرا نمایید.

نوع پیش‌فرض فایل نمایه‌سازی‌شده با پارامتر default_database_type پیکربندی می‌شود. بسته به پلتفرم، این مقدار ممکن است یکی از موارد lmdb:، cdb:، hash: یا dbm: (بدون «:» پایانی) باشد.

هنگامی که جدول از روش‌های دیگر مانند NIS، LDAP یا SQL ارائه می‌شود، همان جستجوهایی که برای فایل‌های نمایه‌سازی‌شده معمولی انجام می‌شود، صورت می‌گیرد. مدیریت چنین پایگاه‌های داده‌ای خارج از حیطه کاری Postfix است.

از طرف دیگر، جدول می‌تواند به عنوان یک نگاشت عبارت منظم ارائه شود که الگوها به صورت عبارات منظم داده می‌شوند، یا جستجوها می‌توانند به یک سرور مبتنی بر TCP هدایت شوند. در این موارد، جستجوها به روشی اندکی متفاوت انجام می‌شوند که در ادامه در بخش‌های «جدول‌های عبارات منظم» یا «جدول‌های مبتنی بر TCP» شرح داده شده است.
.SH "تبدیل بزرگی و کوچکی حروف (CASE FOLDING)"
.na
.nf
.ad
.fi
رشته جستجو قبل از جستجو در پایگاه‌داده به حروف کوچک تبدیل می‌شود. از نسخه 2.3 در Postfix، رشته جستجو در پایگاه‌های داده‌ای از نوع regexp: یا pcre: که فیلدهای جستجوی آن‌ها می‌توانند هم با حروف بزرگ و هم با حروف کوچک مطابقت داشته باشند، تبدیل به حروف کوچک نمی‌شود.
.SH "قالب جدول (TABLE FORMAT)"
.na
.nf
.ad
.fi
قالب ورودی برای دستور \fBpostmap\fR(1) به شرح زیر است:
.IP "\fIpattern result\fR"
هنگامی که \fIpattern\fR با نشانی یا دامنه گیرنده تطابق داشته باشد، از \fIresult\fR متناظر استفاده می‌شود.
.IP "خطوط خالی و توضیحات"
خطوط خالی و خطوطی که تنها حاوی فاصله‌اند نادیده گرفته می‌شوند، همچنین خطوطی که اولین نویسه غیرفاصله‌ای آن‌ها یک «#» است.
.IP "متن چندخطی"
یک خط منطقی با متنی غیر از نویسه‌های فاصله آغاز می‌شود. خطی که با فاصله آغاز شود، ادامه یک خط منطقی به شمار می‌آید.
.PP
مؤلفه \fIpattern\fR یک نشانی ایمیل، یک نام دامنه، یا سلسله‌مراتبی از نام دامنه را مشخص می‌کند، همان‌گونه که در بخش «ترتیب جستجو در جدول» شرح داده شده است.

مقدار \fIresult\fR به شکل \fItransport:nexthop\fR است و نحوه یا مکان تحویل ایمیل را مشخص می‌کند. این موضوع در بخش «قالب نتیجه» توضیح داده شده است.
.SH "ترتیب جستجو در جدول (TABLE SEARCH ORDER)"
.na
.nf
.ad
.fi
در جستجو از فایل‌های نمایه‌سازی‌شده مانند DB یا DBM، یا از جدول‌های تحت شبکه مانند NIS، LDAP یا SQL، الگوها به ترتیبی که در زیر آمده است بررسی و آزمایش می‌شوند:
.IP "\fIuser+extension@domain transport\fR:\fInexthop\fR"
تحویل ایمیل مربوط به \fIuser+extension@domain\fR از طریق \fItransport\fR به \fInexthop\fR.
.IP "\fIuser@domain transport\fR:\fInexthop\fR"
تحویل ایمیل مربوط به \fIuser@domain\fR از طریق \fItransport\fR به \fInexthop\fR.
.IP "\fIdomain transport\fR:\fInexthop\fR"
تحویل ایمیل مربوط به \fIdomain\fR از طریق \fItransport\fR به \fInexthop\fR.
.IP "\fI.domain transport\fR:\fInexthop\fR"
تحویل ایمیل مربوط به هر زیردامنه‌ای از \fIdomain\fR از طریق \fItransport\fR به \fInexthop\fR. این مورد تنها زمانی اعمال می‌شود که رشته \fBtransport_maps\fR در تنظیمات پیکربندی \fBparent_domain_matches_subdomains\fR فهرست نشده باشد. در غیر این صورت، یک نام دامنه هم با خودش و هم با زیردامنه‌هایش تطابق می‌یابد.
.IP "\fB*\fI transport\fR:\fInexthop\fR"
الگوی ویژه \fB*\fR نشان‌دهنده هر نشانی دلخواهی است (یعنی به عنوان الگوی عام عمل می‌کند و مختص جدول‌های انتقال Postfix است).
.PP
یادداشت ۱: نشانی گیرنده تهی (null) به صورت \fB$empty_address_recipient\fR@\fB$myhostname\fR جستجو می‌شود (پیش‌فرض: mailer\-daemon@hostname).

یادداشت ۲: جستجوی \fIuser@domain\fR یا \fIuser+extension@domain\fR در نسخه 2.0 و بالاتر Postfix در دسترس است.
.SH "قالب نتیجه (RESULT FORMAT)"
.na
.nf
.ad
.fi
نتیجه جستجو به شکل \fItransport\fB:\fInexthop\fR است. فیلد \fItransport\fR سازوکار انتقال تحویل ایمیل مانند \fBsmtp\fR یا \fBlocal\fR را مشخص می‌کند. فیلد \fInexthop\fR مشخص می‌سازد که ایمیل در کجا و چگونه تحویل داده شود.

فیلد transport نام یک سازوکار انتقال تحویل ایمیل را مشخص می‌کند (اولین نام از ورودی یک سرویس تحویل ایمیل در فایل \fBmaster.cf\fR در Postfix).

فیلد nexthop معمولاً یک دامنه گیرنده یا نام میزبان را مشخص می‌کند. در مورد کلاینت SMTP/LMTP در Postfix، فیلد nexthop می‌تواند شامل فهرستی از مقصدهای nexthop باشد که با کاما یا نویسه فاصله از هم جدا شده‌اند (Postfix نسخه 3.5 و بالاتر).

ساختار نوشتاری یک مقصد nexthop وابسته به سازوکار انتقال (transport) است. در SMTP، سرویس روی یک درگاه غیرپیش‌فرض را به صورت \fIhost\fR:\fIservice\fR مشخص کنید، و جستجوهای DNS برای رکورد MX (مبادله‌گر ایمیل) را با [\fIhost\fR] یا [\fIhost\fR]:\fIport\fR غیرفعال نمایید. هنگامی که به جای نام میزبان از نشانی IP استفاده می‌کنید، شکل [] الزامی است.

یک فیلد تهی (null) برای \fItransport\fR و فیلد تهی برای \fInexthop\fR به معنای «تغییر نده» است: از همان سازوکار تحویل و اطلاعات nexthop استفاده کن که در صورت عدم وجود کل جدول انتقال استفاده می‌شدند.

یک فیلد غیرتهی برای \fItransport\fR همراه با فیلد تهی برای \fInexthop\fR، اطلاعات nexthop را به دامنه گیرنده بازنشانی می‌کند.

یک فیلد تهی برای \fItransport\fR همراه با فیلد غیرتهی برای \fInexthop\fR، اطلاعات transport را تغییر نمی‌دهد.
.SH "مثال‌ها (EXAMPLES)"
.na
.nf
.ad
.fi
برای تحویل مستقیم ایمیل‌های داخلی، در حالی که برای تمام ایمیل‌های دیگر از یک رله ایمیل (mail relay) استفاده می‌شود، یک مدخل تهی برای مقصدهای داخلی تعیین کنید (سازوکار تحویل یا اطلاعات nexthop را تغییر ندهید) و برای تمام مقصدهای دیگر از یک الگوی عام (wildcard) استفاده کنید.

.nf
     \fB\&my.domain    :\fR
     \fB\&.my.domain   :\fR
     \fB*            smtp:outbound\-relay.my.domain\fR
.fi

برای ارسال ایمیل‌های مربوط به \fBexample.com\fR و زیردامنه‌های آن از طریق انتقال \fBuucp\fR به میزبان UUCP با نام \fBexample\fR:

.nf
     \fBexample.com      uucp:example\fR
     \fB\&.example.com     uucp:example\fR
.fi

هنگامی که هیچ مقصد nexthop مشخص نشده باشد، Postfix از موارد زیر استفاده می‌کند (به ترتیب اولویت از کم به زیاد): دامنه گیرنده، مقصد nexthop مشخص‌شده با relayhost، با sender_dependent_relayhost_maps (تنها برای تحویل‌های راه دور)، با سازوکار انتقال مربوط به رده دامنه نشانی (بخش توضیحات در بالا را ببینید)، یا با sender_dependent_default_transport_maps (تنها برای تحویل‌های راه دور). برای نمونه، مثال زیر ایمیل برای \fIuser\fR@\fBexample.com\fR را از طریق انتقال \fBslow\fR به یک مبادله‌گر ایمیل برای \fBexample.com\fR هدایت می‌کند. سازوکار انتقال \fBslow\fR می‌تواند طوری پیکربندی شود که در هر لحظه حداکثر یک فرآیند تحویل را اجرا کند:

.nf
     \fBexample.com      slow:\fR
.fi

هنگامی که هیچ سازوکار انتقالی مشخص نشده باشد، Postfix از سازوکار انتقالی استفاده می‌کند که با رده دامنه نشانی تطابق دارد (بخش توضیحات در بالا را ببینید)، یا از سازوکار انتقال مشخص‌شده با sender_dependent_default_transport_maps (تنها برای تحویل‌های راه دور). نمونه زیر تمام ایمیل‌های مربوط به \fBexample.com\fR و زیردامنه‌های آن را به میزبان \fBgateway.example.com\fR ارسال می‌کند:

.nf
     \fBexample.com      :[gateway.example.com]\fR
     \fB\&.example.com     :[gateway.example.com]\fR
.fi

در مثال بالا، علامت [] مانع از جستجوهای MX می‌شود. این کار از ایجاد حلقه‌های مسیریابی ایمیل در زمانی که دستگاه شما میزبان MX اصلی برای \fBexample.com\fR است جلوگیری می‌کند.

در مورد تحویل از طریق SMTP یا LMTP، می‌توان به جای نام میزبان صرف، \fIhost\fR:\fIservice\fR را مشخص کرد:

.nf
     \fBexample.com      smtp:bar.example:2025\fR
.fi

این پیکربندی، ایمیل‌های \fIuser\fR@\fBexample.com\fR را به میزبان \fBbar.example\fR روی درگاه \fB2025\fR هدایت می‌کند. به جای شماره درگاه عددی می‌توان از یک نام نمادین استفاده کرد. اگر جستجوهای MX باید غیرفعال شوند، علامت [] را دور نام میزبان مشخص کنید.

تحویل‌ها از طریق SMTP یا LMTP از چندین مقصد پشتیبانی می‌کنند (Postfix نسخه 3.5 و بالاتر):

.nf
     \fBexample.com      smtp:bar.example, foo.example\fR
.fi

این پیکربندی پیش از تلاش برای تحویل به \fBfoo.example\fR، برای تحویل به \fBbar.example\fR تلاش می‌کند.

از ارسال‌کننده خطا (error mailer) می‌توان برای برگشت زدن (bounce) ایمیل استفاده کرد:

.nf
     \fB\&.example.com     error:mail for *.example.com is not deliverable\fR
.fi

این کار باعث می‌شود تمام ایمیل‌های ارسال‌شده به \fIuser\fR@\fIanything\fB.example.com\fR برگشت بخورند.
.SH "جدول‌های عبارات منظم (REGULAR EXPRESSION TABLES)"
.na
.nf
.ad
.fi
این بخش چگونگی تغییر در جستجوهای جدول را در حالتی که جدول در قالب عبارات منظم ارائه شود شرح می‌دهد. برای مشاهده شرح ساختار نوشتاری جدول جستجوی عبارت منظم، \fBregexp_table\fR(5) یا \fBpcre_table\fR(5) را ببینید.

هر الگو یک عبارت منظم است که روی کل نشانی در حال جستجو اعمال می‌شود. بنابراین، \fIsome.domain.hierarchy\fR از طریق دامنه‌های والد خود جستجو نمی‌شود، و همچنین \fIuser+foo@domain\fR به صورت \fIuser@domain\fR جستجو نخواهد شد.

الگوها به همان ترتیبی که در جدول مشخص شده‌اند اعمال می‌شوند تا زمانی که الگویی منطبق بر رشته جستجو پیدا شود.

سرور \fBtrivial\-rewrite\fR(8) جایگزینی عبارات منظم مانند $1 و غیره را در جدول‌های جستجوی عبارت منظم مجاز نمی‌داند، زیرا این کار ممکن است یک رخنه امنیتی ایجاد کند (Postfix نسخه 2.3 و بالاتر).
.SH "جدول‌های مبتنی بر TCP (TCP-BASED TABLES)"
.na
.nf
.ad
.fi
این بخش چگونگی تغییر در جستجوهای جدول را در حالتی که جستجوها به یک سرور مبتنی بر TCP هدایت شوند شرح می‌دهد. برای مشاهده شرح پروتکل جستجوی کلاینت/سرور TCP، به \fBtcp_table\fR(5) مراجعه کنید. این قابلیت تا نسخه 2.4 در Postfix (شامل خود آن) در دسترس نیست.

هر عملیات جستجو از کل نشانی گیرنده به طور یکباره استفاده می‌کند. بنابراین، \fIsome.domain.hierarchy\fR از طریق دامنه‌های والد خود جستجو نمی‌شود، و همچنین \fIuser+foo@domain\fR به صورت \fIuser@domain\fR جستجو نخواهد شد.

نتایج مشابه جستجو در فایل‌های نمایه‌سازی‌شده هستند.
.SH "پارامترهای پیکربندی (CONFIGURATION PARAMETERS)"
.na
.nf
.ad
.fi
پارامترهای زیر در \fBmain.cf\fR ارتباط ویژه‌ای با این موضوع دارند. متن زیر تنها خلاصه‌ای از پارامترها را ارائه می‌دهد. برای جزئیات بیشتر به همراه مثال‌ها، \fBpostconf\fR(5) را ببینید.
.IP "\fBempty_address_recipient (MAILER\-DAEMON)\fR"
گیرنده ایمیل‌هایی که به نشانی تهی (null) ارسال شده‌اند.
.IP "\fBparent_domain_matches_subdomains (خروجی 'postconf -d' را ببینید)\fR"
فهرستی از ویژگی‌های Postfix که در آن‌ها الگوی «example.com» بدون نیاز به الگوی صریح «.example.com»، با زیردامنه‌های example.com نیز تطابق دارد.
.IP "\fBtransport_maps (خالی)\fR"
جدول‌های جستجوی اختیاری با نگاشت‌هایی از نشانی گیرنده به (سازوکار انتقال تحویل پیام، مقصد گام بعدی).
.SH "همچنین ببینید (SEE ALSO)"
.na
.nf
trivial\-rewrite(8), بازنویسی و حل و فصل نشانی‌ها
master(5), قالب فایل master.cf
postconf(5), پارامترهای پیکربندی
postmap(1), مدیریت جدول‌های جستجوی Postfix
.SH "فایل‌های راهنما (README FILES)"
.na
.nf
.ad
.fi
از دستور «\fBpostconf readme_directory\fR» یا «\fBpostconf html_directory\fR» برای پیدا کردن این اطلاعات استفاده کنید.
.na
.nf
ADDRESS_REWRITING_README, راهنمای بازنویسی نشانی
DATABASE_README, بررسی کلی جدول‌های جستجوی Postfix
FILTER_README, فیلتر محتوای خارجی
.SH "مجوز (LICENSE)"
.na
.nf
.ad
.fi
مجوز نرم‌افزار Secure Mailer باید همراه با این نرم‌افزار توزیع شود.
.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