نام (NAME)

mysql_table - پیکربندی کارخواه MySQL/MariaDB در Postfix

خلاصه دستور (SYNOPSIS)

?Bpostmap -q "?Istring?B" mysql:/etc/postfix/?Ifilename?R
?Bpostmap -q - mysql:/etc/postfix/?Ifilename?B <?Iinputfile?R

توضیحات (DESCRIPTION)

سیستم ایمیل Postfix از جدول‌های اختیاری برای بازنویسی نشانی یا مسیریابی ایمیل استفاده می‌کند. این جدول‌ها معمولاً در قالب‌های ?Blmdb:?R، ?Bcdb:?R، ?Bhash:?R یا ?Bdbm:?R هستند.

به عنوان یک جایگزین، جدول‌های جستجو می‌توانند به عنوان پایگاه‌های داده MySQL مشخص شوند. برای اطلاع از اینکه سیستم Postfix شما از چه انواع جدول‌های جستجویی پشتیبانی می‌کند، از دستور «?Bpostconf -m?R» استفاده کنید.

برای استفاده از جستجوهای MySQL، یک منبع MySQL را به عنوان جدول جستجو در main.cf تعریف کنید؛ برای نمونه:

alias_maps = mysql:/etc/postfix/mysql-aliases.cf

فایل etc/postfix/mysql-aliases.cf/ قالبی مشابه فایل main.cf پست‌فیکس دارد، و می‌تواند پارامترهای شرح‌داده‌شده در زیر را مشخص کند.

اگرچه نام مؤلفه در Postfix برابر با 'mysql' است، کارخواه‌ها و کارسازهای MariaDB/MySQL می‌توانند به جای یکدیگر استفاده شوند زیرا عملکردی که Postfix به آن وابسته است در هر دو موجود است. با این حال، پایگاه کد آن‌ها ممکن است در آینده از هم فاصله بگیرد.

عضویت در فهرست (LIST MEMBERSHIP)

هنگام استفاده از SQL برای ذخیره فهرست‌هایی مانند mynetworks$، mydestination$، relay_domains$، local_recipient_maps$ و غیره، درک این نکته مهم است که جدول باید هر عضو فهرست را به عنوان یک کلید جداگانه ذخیره کند. جستجوی جدول *وجود داشتن* کلید را بررسی می‌کند. برای توضیحات بیشتر، بخش "Postfix lists versus tables" را در سند DATABASE_README ببینید.

جدول‌هایی ایجاد نکنید که کل فهرست دامنه‌ها در mydestination$ یا relay_domains$ یا نشانی‌های IP در mynetworks$ را بازگردانند.

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

پارامترهای MYSQL (MYSQL PARAMETERS)

?Bhosts?R

میزبان‌هایی که Postfix برای اتصال و پرس‌وجو به آن‌ها تلاش خواهد کرد. برای سوکت‌های دامنه یونیکس ?Iunix:?R و برای اتصالات TCP عبارت ?Iinet:?R (پیش‌فرض) را مشخص کنید. مثال‌ها:

hosts = inet:host1.some.domain inet:host2.some.domain:port
hosts = host1.some.domain host2.some.domain:port
hosts = unix:/file/name

میزبان‌ها به ترتیب تصادفی بررسی می‌شوند و تمام اتصالات روی سوکت‌های دامنه یونیکس پیش از اتصالات روی TCP بررسی خواهند شد. اتصالات پس از حدود ۱ دقیقه بیکاری به طور خودکار بسته می‌شوند و در صورت نیاز مجدداً باز خواهند شد. نسخه‌های 2.0 و پیشین پست‌فیکس ترتیب میزبان‌ها را تصادفی نمی‌کردند.

نکته: اگر localhost را به عنوان نام میزبان مشخص کنید (حتی با پیشوند ?Iinet:?R)، MySQL به سوکت دامنه یونیکس پیش‌فرض متصل خواهد شد. برای دستور به MySQL جهت اتصال به localhost از طریق TCP باید مشخص کنید:

hosts = 127.0.0.1

نکته: اگر تنظیم ?Bhosts?R تنها یک سرور را مشخص کند، این کارخواه فرض می‌کند که مقصد یک متعادل‌کننده بار (load balancer) است و بلافاصله پس از یک شکست مجدداً متصل می‌شود. در نسخه‌های 3.9 و پیشین پست‌فیکس، همان سرور را دو بار مشخص کنید.

?Buser?R

?Bpassword?R

نام کاربری و گذرواژه برای ورود به سرور MySQL. مثال:

user = someone
password = some_password

?Bdbname?R

نام پایگاه داده روی سرورها. مثال:

dbname = customer_database

?Bcharset (پیش‌فرض: utf8mb4)?R

مجموعه نویسه‌های پیش‌فرض کارخواه MySQL؛ این مورد ترتیب تطبیق (collation) را نیز در بر می‌گیرد.

این پارامتر در نسخه 3.9 و بالاتر Postfix در دسترس است. در نسخه‌های پیشین، مقدار پیش‌فرض توسط پیاده‌سازی MySQL انتخاب می‌شد (?Butf8mb4?R در MySQL 8.0 به بعد، و از نظر تاریخی ?Blatin1?R).

?Bidle_interval (پیش‌فرض: 60)?R

تعداد ثانیه‌هایی که پس از آن یک اتصال پایگاه داده بیکار بسته خواهد شد.

این قابلیت در نسخه 3.9 و بالاتر Postfix در دسترس است.

?Bretry_interval (پیش‌فرض: 60)?R

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

نکته: اگر ?Bhosts?R تنها یک سرور را مشخص کند، این کارخواه فرض می‌کند که مقصد یک متعادل‌کننده بار است و بلافاصله پس از یک شکست مجدداً متصل می‌شود. در نسخه‌های 3.9 و پیشین همان سرور را دو بار مشخص کنید.

این قابلیت در نسخه 3.9 و بالاتر Postfix در دسترس است.

?Bquery?R

الگوی پرس‌وجوی SQL مورد استفاده برای جستجو در پایگاه داده، که در آن ?B%s?R جایگزینی برای نشانی‌ای است که Postfix در تلاش برای تحلیل آن است، به عنوان نمونه:

query = SELECT replacement FROM aliases WHERE mailbox = '%s'

به طور پیش‌فرض، هر پرس‌وجو باید یک مجموعه نتیجه بازگرداند (به جای ذخیره نتایج در جدول)؛ با «?Brequire_result_set = no?R» (در Postfix 3.2 و بالاتر)، نبود مجموعه نتیجه به عنوان «یافت نشد» تلقی می‌شود.

این پارامتر از بسط‌های '%' زیر پشتیبانی می‌کند:

پارامتر ?Bdomain?R که در ادامه شرح داده شده است، کلیدهای ورودی را به نشانی‌های موجود در دامنه‌های منطبق محدود می‌کند. هنگامی که پارامتر ?Bdomain?R غیرخالی باشد، پرس‌وجوهای SQL برای نشانی‌های نامعتبر یا نشانی‌های موجود در دامنه‌های غیرمنطبق متوقف می‌شوند و نتیجه‌ای برنمی‌گردانند.

این پارامتر در نسخه 2.2 Postfix موجود است. در نسخه‌های قبلی پرس‌وجوی SQL از پارامترهای جداگانه ساخته می‌شد: ?Bselect_field?R، ?Btable?R، ?Bwhere_field?R و ?Badditional_conditions?R. نگاشت از پارامترهای قدیمی به پرس‌وجوی معادل چنین است:

SELECT [?Bselect_field?R]
FROM [?Btable?R]
WHERE [?Bwhere_field?R] = '%s'
      [?Badditional_conditions?R]

مقدار '%s' در بند ?BWHERE?R به رشته جستجوی اسکیپ‌شده بسط می‌یابد. در نسخه 2.2 پست‌فیکس اگر پارامتر ?Bquery?R مشخص نشده باشد از این پارامترهای موروثی استفاده می‌شود.

نکته: اطراف پارامتر query نقل‌قول قرار ندهید.

?Bresult_format (پیش‌فرض: ?B%s?R)?R

الگوی قالب اعمال‌شده بر ویژگی‌های نتیجه. معمولاً برای افزودن متن به انتها (یا ابتدا) نتیجه استفاده می‌شود. این پارامتر از بسط‌های '%' زیر پشتیبانی می‌کند:

برای نمونه، استفاده از "result_format = smtp:[%s]" اجازه می‌دهد تا از یک ویژگی mailHost به عنوان پایه یک جدول transport(5) استفاده شود. پس از اعمال قالب نتیجه، مقادیر چندگانه به عنوان رشته‌های جدا شده با کاما به هم متصل می‌شوند. پارامتر expansion_limit که در ادامه توضیح داده شده اجازه می‌دهد تعداد مقادیر نتیجه را محدود کنید.

مقدار پیش‌فرض ?B%s?R مشخص می‌کند که هر مقدار نتیجه همان‌طور که هست استفاده شود.

این پارامتر در نسخه 2.2 و بالاتر Postfix در دسترس است.

نکته: اطراف قالب نتیجه (result_format) نقل‌قول قرار ندهید!

?Bdomain (پیش‌فرض: بدون فهرست دامنه)?R

این یک فهرست از نام‌های دامنه، مسیر فایل‌ها یا پایگاه‌های داده "type:table" است. در صورت مشخص شدن، تنها کلیدهای جستجوی کامل با یک بخش محلی *غیرخالی* و یک دامنه منطبق واجد شرایط جستجو هستند: جستجوهای 'user'، جستجوهای دامنه تنها و جستجوهای "domain@" انجام نمی‌شوند. این امر می‌تواند بار پرس‌وجو روی سرور MySQL را به طور چشمگیری کاهش دهد.

domain = postfix.org, hash:/etc/postfix/searchdomains

بهتر است از SQL برای ذخیره دامنه‌های واجد شرایط جستجوهای SQL استفاده نکنید.

این پارامتر در نسخه 2.2 و بالاتر Postfix در دسترس است.

نکته: این پارامتر را برای نام‌های مستعار local(8) تعریف نکنید، زیرا کلیدهای ورودی همیشه بدون دامنه هستند.

?Bexpansion_limit (پیش‌فرض: 0)?R

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

?Boption_file?R

خواندن گزینه‌ها از فایل مشخص‌شده به جای مکان پیش‌فرض my.cnf. این گزینه گزینه‌ها را از گروه گزینه ?B[client]?R می‌خواند، که به صورت اختیاری گزینه‌های گروه مشخص‌شده با ?Boption_group?R به دنبال آن می‌آیند.

این پارامتر در نسخه 2.11 و بالاتر Postfix در دسترس است.

?Boption_group (پیش‌فرض: در Postfix >=3.2 برابر client، در <= 3.1 خالی)?R

خواندن گزینه‌ها از گروه مشخص‌شده در فایل گزینه‌های mysql، پس از خواندن گزینه‌ها از گروه ?B[client]?R.

پست‌فیکس 3.2 و بالاتر تنظیمات گروه ?B[client]?R را به صورت پیش‌فرض می‌خوانند. برای غیرفعال کردن این مورد هیچ ?Boption_file?R را مشخص نکنید و مقدار "?Boption_group =?R" (مقدار خالی) را تعیین کنید.

این پارامتر در نسخه 2.11 و بالاتر Postfix در دسترس است.

?Brequire_result_set (پیش‌فرض: yes)?R

در صورت تنظیم روی "?Byes?R"، الزام به اینکه هر پرس‌وجو یک مجموعه نتیجه بازگرداند. اگر "?Bno?R" باشد، نبود مجموعه نتیجه به عنوان «یافت نشد» تلقی می‌شود.

این پارامتر در نسخه 3.2 و بالاتر Postfix در دسترس است.

تنظیمات مربوط به TLS (TLS-RELATED SETTINGS)

برای جزئیات قابلیت‌های زمینه‌ای MYSQL_OPT_SSL_* به نشانی‌های https://dev.mysql.com/doc/c-api/en/mysql-options.html یا https://mariadb.com/kb/en/mysql_optionsv مراجعه فرمایید.

?Btls_cert_file?R

فایل حاوی گواهی X509 کارخواه.

این پارامتر در نسخه 2.11 و بالاتر Postfix در دسترس است.

?Btls_key_file?R

فایل حاوی کلید خصوصی متناظر با ?Btls_cert_file?R.

این پارامتر در نسخه 2.11 و بالاتر Postfix در دسترس است.

?Btls_CAfile?R

فایل حاوی گواهی‌های X509 برای تمامی مراجع صدور گواهی که کارخواه شناسایی می‌کند. بر ?Btls_CApath?R تقدم دارد.

این پارامتر در نسخه 2.11 و بالاتر Postfix در دسترس است.

?Btls_CApath?R

دایرکتوری حاوی گواهی‌های مرجع صدور گواهی X509 در فایل‌های مجزای جداگانه.

این پارامتر در نسخه 2.11 و بالاتر Postfix در دسترس است.

?Btls_ciphers?R

فهرست رمزهای مجاز برای رمزنگاری SSL.

این پارامتر در نسخه 2.11 و بالاتر Postfix در دسترس است.

?Btls_verify_cert (پیش‌فرض: no)?R

اعتبارسنجی اینکه نام سرور با نام مشترک (CN) در گواهی مطابقت دارد یا خیر.

این پارامتر در نسخه 2.11 و بالاتر Postfix در دسترس است.

استفاده از روال‌های ذخیره‌شده MYSQL (USING MYSQL STORED PROCEDURES)

پست‌فیکس 3.2 و بالاتر از فراخوانی یک روال ذخیره‌شده (stored procedure) به جای استفاده از دستور SELECT در query پشتیبانی می‌کنند؛ برای نمونه:

?Bquery?R = CALL lookup('%s')

بسط‌های '%' که پیش‌تر شرح داده شدند می‌توانند در پارامترهای ارسالی به روال ذخیره‌شده استفاده شوند.

به طور پیش‌فرض، هر فراخوانی روال ذخیره‌شده باید یک مجموعه نتیجه بازگرداند، یعنی هر مسیر کد باید یک دستور SELECT را اجرا کند که مجموعه نتیجه بازمی‌گرداند. با «?Brequire_result_set = no?R»، نبود مجموعه نتیجه به عنوان «یافت نشد» تلقی می‌شود.

یک روال ذخیره‌شده نباید چندین مجموعه نتیجه بازگرداند.

نمونه زیر یک روال ذخیره‌شده را نشان می‌دهد که یک مجموعه نتیجه منفرد بازمی‌گرداند:

CREATE [DEFINER=`user`@`host`] PROCEDURE
`lookup`(IN `param` VARCHAR(255))
    READS SQL DATA
    SQL SECURITY INVOKER
    BEGIN
        select goto from alias where address=param;
    END

پارامترهای منسوخ MAIN.CF (OBSOLETE MAIN.CF PARAMETERS)

برای سازگاری با سایر جدول‌های جستجوی Postfix، پارامترهای MySQL می‌توانند در main.cf نیز تعریف شوند. برای انجام این کار، به عنوان منبع MySQL نامی را مشخص کنید که با اسلش یا نقطه آغاز نمی‌شود. پارامترهای MySQL به عنوان نامی که در تعریف به منبع داده‌اید، یک خط زیرین (_) و نام پارامتر در دسترس خواهند بود. برای نمونه، اگر جدول به صورت "mysql:?Imysqlname?R" مشخص شود، پارامتر "hosts" در main.cf به صورت "?Imysqlname?R_hosts" تعریف می‌شود.

نکته: در این روش، گذرواژه‌ها برای منابع MySQL در main.cf نوشته می‌شوند که معمولاً برای همه کاربران قابل خواندن است. پشتیبانی از این فرم در نسخه‌های آینده حذف خواهد شد.

رابط پرس‌وجوی منسوخ (OBSOLETE QUERY INTERFACE)

این بخش رابطی را توصیف می‌کند که از نسخه 2.2 Postfix منسوخ شده است. این رابط با رابط عمومی‌تر ?Bquery?R که در بالا شرح داده شد جایگزین گردیده است. اگر پارامتر ?Bquery?R تعریف شده باشد، پارامترهای موروثی شرح‌داده‌شده در اینجا نادیده گرفته می‌شوند. لطفاً به رابط جدید مهاجرت فرمایید زیرا رابط قدیمی در نسخه‌های آینده حذف خواهد شد.

پارامترهای زیر می‌توانند برای پر کردن یک الگوی دستور SELECT استفاده شوند:

SELECT [?Bselect_field?R]
FROM [?Btable?R]
WHERE [?Bwhere_field?R] = '%s'
      [?Badditional_conditions?R]

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

?Bselect_field?R

پارامتر "select" در SQL. مثال:

?Bselect_field?R = forw_addr

?Btable?R

نام جدول "select .. from" در SQL. مثال:

?Btable?R = mxaliases

?Bwhere_field?R

پارامتر "select .. where" در SQL. مثال:

?Bwhere_field?R = alias

?Badditional_conditions?R

شرایط اضافی برای پرس‌وجوی SQL. مثال:

?Badditional_conditions?R = AND status = 'paid'

همچنین ببینید (SEE ALSO)

postmap(1), نگهداری جدول جستجوی Postfix
postconf(5), پارامترهای پیکربندی
ldap_table(5), جدول‌های جستجوی LDAP
pgsql_table(5), جدول‌های جستجوی PostgreSQL
sqlite_table(5), جدول‌های جستجوی SQLite

فایل‌های راهنما (README FILES)

از دستور «?Bpostconf readme_directory?R» یا «?Bpostconf html_directory?R» برای مکان‌یابی این اطلاعات استفاده کنید.

DATABASE_README, بررسی اجمالی جدول جستجوی Postfix
MYSQL_README, راهنمای کارخواه MYSQL در Postfix

مجوز (LICENSE)

مجوز Secure Mailer باید همراه با این نرم‌افزار توزیع شود.

تاریخچه (HISTORY)

پشتیبانی از MySQL با نسخه 1.0 پست‌فیکس معرفی شد.

نویسندگان (AUTHORS)

پیاده‌سازی اولیه توسط:
Scott Cotton, Joshua Marcus
IC Group, Inc.
بهبودهای بیشتر توسط:
Liviu Daia
Institute of Mathematics of the Romanian Academy
P.O. BOX 1-764
RO-014700 Bucharest, ROMANIA
پشتیبانی از روال ذخیره‌شده توسط John Fawcett.
Wietse Venema
Google, Inc.
111 8th Avenue
New York, NY 10011, USA