راهنمای جامع نصب iRedMail روی لینوکس

1. مسیر نصب

• دایرکتوری اصلی: /opt/www/roundcubemail/
• این مسیر یک لینک سمبولیک به نسخهٔ واقعی (مثلاً roundcubemail-1.6.x) است.

2. فایل‌های تنظیمات

• فایل اصلی تنظیمات: /opt/www/roundcubemail/config/config.inc.php
• مهم: هرگز defaults.inc.php را مستقیم ویرایش نکنید. فقط تنظیمات موردنیاز را در config.inc.php تغییر دهید.
• در iRedMail Easy: از /opt/iredmail/custom/roundcube/custom.inc.php استفاده کنید (اگر نبود، بسازید).
• برای پلاگین‌ها: فایل‌های جداگانه مثل /opt/iredmail/custom/roundcube/config_نام‌پلاگین.inc.php.

3. لاگ‌ها

لاگ‌های Roundcube معمولاً در لاگ‌های Postfix ذخیره می‌شوند:

• /var/log/maillog
• /var/log/mail.log

4. بررسی مسیر نصب

find /opt -name "roundcubemail" -type d
ls -l /opt/www/roundcubemail/config/

5. دسته‌های اصلی تنظیمات

5.1 اتصال به IMAP و SMTP

$config['imap_host'] = 'localhost:993'; // SSL
$config['smtp_host'] = 'localhost:587'; // TLS

5.2 دیتابیس

$config['db_dsnw'] = 'mysql://roundcube:password@localhost/roundcubemail';

5.3 امنیت و ظاهر

• $config['des_key']: کلید رمزنگاری
• $config['skin_logo']: لوگوی سفارشی
• $config['force_https'] = true;: اجبار به HTTPS
• $config['enable_spellcheck'] = true;: فعال‌سازی چک املا

5.4 پلاگین‌ها

$config['plugins'] = ['password', 'managesieve', 'zipdownload'];

iRedMail پلاگین‌های password و managesieve را به‌صورت پیش‌فرض فعال می‌کند.

5.5 رفتار کاربری

$config['preview_pane'] = true;
$config['language'] = 'fa_IR'; // فارسی

5.6 لاگ و دیباگ

$config['debug_level'] = 1;
$config['imap_debug'] = true;
$config['smtp_debug'] = true;
$config['sql_debug'] = true;

5.7 امکانات دیگر

• پشتیبانی از CardDAV/CalDAV
• فیلتر اسپم، امضا، پاسخ خودکار

6. نکات مهم

• بعد از تغییر config.inc.php، در صورت نیاز وب‌سرور (Nginx/Apache) را ری‌استارت کنید.
• برای دیباگ بیشتر: debug_level = 4 و فعال‌سازی گزینه‌های SQL/IMAP/SMTP.
• تنظیمات کاربری (زبان، تم، امضا) از داخل رابط Roundcube در بخش Settings → Preferences, Identities, Folders مدیریت می‌شوند.

نتیجه‌گیری

Roundcube یک وب‌میل قدرتمند و انعطاف‌پذیر در iRedMail است. مدیران باید تنظیمات سفارشی را در config.inc.php یا فایل‌های custom اعمال کنند، اتصال به IMAP/SMTP و دیتابیس را دقیق تنظیم کنند و پلاگین‌ها و امنیت را مدیریت نمایند. با پیکربندی درست، Roundcube یک رابط کاربری مدرن و کاربرپسند برای ایمیل فراهم می‌کند.

// ---------------------------------------------------------------------
// WARNING: Do not edit this file! Copy configuration to config.inc.php.
// ---------------------------------------------------------------------
/*
 +-----------------------------------------------------------------------+
 | Default settings for all configuration options                        |
 | This file is part of the Roundcube Webmail client                      |
 | Copyright (C) The Roundcube Dev Team                                  |
 | Licensed under the GNU General Public License version 3 or later      |
 +-----------------------------------------------------------------------+
*/

$config = [];

// ----------------------------------
// SQL DATABASE
// ----------------------------------
$config['db_dsnw'] = 'mysql://roundcube:@localhost/roundcubemail';
$config['db_dsnr'] = '';
$config['db_persistent'] = false;
$config['db_prefix'] = '';

// ----------------------------------
// LOGGING/DEBUGGING
// ----------------------------------
$config['log_driver'] = 'file';
$config['log_date_format'] = 'd-M-Y H:i:s O';
$config['log_session_id'] = 8;
$config['per_user_logging'] = false;
$config['smtp_log'] = true;
$config['log_logins'] = false;
$config['sql_debug'] = false;
$config['imap_debug'] = false;
$config['smtp_debug'] = false;

// ----------------------------------
// IMAP
// ----------------------------------
$config['imap_host'] = 'localhost:143';
$config['imap_auth_type'] = null;
$config['imap_delimiter'] = null;
$config['imap_cache'] = null;
$config['messages_cache'] = false;

// ----------------------------------
// SMTP
// ----------------------------------
$config['smtp_host'] = 'localhost:587';
$config['smtp_user'] = '%u';
$config['smtp_pass'] = '%p';
$config['smtp_auth_type'] = null;

// ----------------------------------
// SYSTEM
// ----------------------------------
$config['enable_installer'] = false;
$config['auto_create_user'] = true;
$config['log_dir'] = RCUBE_INSTALL_PATH . 'logs/';
$config['temp_dir'] = RCUBE_INSTALL_PATH . 'temp/';
$config['des_key'] = 'rcmail-!24ByteDESkey*Str';
$config['cipher_method'] = 'DES-EDE3-CBC';
$config['product_name'] = 'Roundcube Webmail';
$config['skin'] = 'elastic';
$config['language'] = null;
$config['default_charset'] = 'ISO-8859-1';

// ----------------------------------
// USER INTERFACE
// ----------------------------------
$config['mail_pagesize'] = 50;
$config['addressbook_pagesize'] = 50;
$config['prefer_html'] = true;
$config['htmleditor'] = 0;
$config['draft_autosave'] = 300;
$config['refresh_interval'] = 60;
$config['check_all_folders'] = false;
$config['drafts_mbox'] = 'Drafts';
$config['junk_mbox'] = 'Junk';
$config['sent_mbox'] = 'Sent';
$config['trash_mbox'] = 'Trash';
$config['create_default_folders'] = false;
$config['protect_default_folders'] = true;

// ----------------------------------
// PLUGINS
// ----------------------------------
$config['plugins'] = [];