~2 min read • Updated Feb 17, 2026
1. مقدمه
فایل /var/cpanel/cpanel.config قلب تنظیمات WHM و cPanel است. هر تغییری که در WHM → Tweak Settings انجام میدهید، در نهایت در این فایل ذخیره میشود.
اگر این فایل وجود نداشته باشد، cPanel آن را از فایل پیشفرض زیر بازسازی میکند:
/usr/local/cpanel/etc/cpanel.configنکات مهم:
- کلیدهای پویا (dynamic) را هرگز دستی تغییر ندهید؛ فقط از WHM تغییر دهید.
- فایل کش
/var/cpanel/cpanel.config.cacheبرای افزایش سرعت استفاده میشود و پس از هر تغییر، خودکار بهروزرسانی میشود.
2. کلیدهای مهم و توضیحات (بر اساس گروه)
General / System Settings
| کلید | بخش Tweak Settings | توضیحات / مقدار پیشفرض | نکات مهم |
|---|---|---|---|
| engine | — | cpanel | تغییر ندهید. |
| engineroot | — | /usr/local/cpanel | تغییر ندهید. |
| enginepl | — | cpanel.pl | تغییر ندهید. |
| root | — | /usr/local/cpanel | تغییر ندهید. |
| conserve_memory | — | 0 | پویا — فقط از WHM تغییر دهید. |
| maxmem | — | 4096 | حداکثر حافظه برای پردازشهای cPanel (MB). |
| maxcpsrvdconnections | — | 200 | حداکثر اتصال همزمان به cpsrvd. |
Security / Login & Authentication
| کلید | بخش Tweak Settings | توضیحات / مقدار پیشفرض | نکات مهم |
|---|---|---|---|
| cgihidepass | Security → Hide login password | 0 | مخفی کردن رمز از CGI. |
| cookieipvalidation | Security → Cookie IP validation | strict | حالتهای strict / loose / off. |
| domainowner_mail_pass | Mail → Mail authentication | 0 | پویا — اجازه ارسال ایمیل با رمز مالک دامنه. |
| resetpass | — | 1 | اجازه ریست پسورد cPanel. |
| resetpass_sub | — | 1 | اجازه ریست پسورد ساباکانت. |
| requiressl | Security → Require SSL | 1 | اجبار SSL برای WHM/cPanel/Webmail. |
Email / Mail Settings
| کلید | بخش Tweak Settings | توضیحات / مقدار پیشفرض | نکات مهم |
|---|---|---|---|
| exim_retention_days | Stats and Logs | 10 | مدت نگهداری آمار Exim. |
| exim-retrytime | Mail → Retry time | 15 | زمان retry ارسال ایمیل (دقیقه). |
| eximmailtrap | Mail → Track email origin | 1 | فعالسازی X-Source header. |
| mailbox_storage_format | Mail → Mailbox format | maildir | maildir یا mbox. |
| popbeforesmtp | Mail → POP-before-SMTP | 0 | اجازه relay پس از POP login. |
| smtpmailgidonly | Mail → Restrict outgoing SMTP | 1 | فقط root، exim و mailman اجازه ارسال SMTP دارند. |
DNS / Domains
| کلید | بخش Tweak Settings | توضیحات / مقدار پیشفرض | نکات مهم |
|---|---|---|---|
| autocreateaentries | Domains → Auto A entries | 1 | افزودن رکورد A برای nameserverها. |
| autodiscover_host | Domains → SRV host | cpanelemaildiscovery.cpanel.net | برای autodiscover. |
| proxysubdomains | Domains → Service subdomains | 1 | پویا — فعالسازی cpanel., webmail., whm. |
| proxysubdomainsoverride | Domains → Override | 1 | اجازه override رکوردهای A. |
PHP & Apache
| کلید | بخش Tweak Settings | توضیحات / مقدار پیشفرض | نکات مهم |
|---|---|---|---|
| php_max_execution_time | PHP → Max execution time | 90 | ثانیه. |
| php_memory_limit | PHP → Memory limit | 128 | MB. |
| php_post_max_size | PHP → Max POST size | 55 | MB. |
| php_upload_max_filesize | PHP → Max upload size | 50 | MB. |
Stats & Logs
| کلید | بخش Tweak Settings | توضیحات / مقدار پیشفرض | نکات مهم |
|---|---|---|---|
| cycle_hours | Statistics Software | 24 | به نزدیکترین ۱۵ دقیقه رُند میشود. |
| dumplogs | Stats and Logs | 1 | حذف لاگهای دسترسی پس از پردازش. |
| keepftplogs | Stats and Logs | 0 | نگهداری لاگ اصلی FTP. |
| keeplogs | Stats and Logs | 0 | نگهداری لاگهای ماه قبل. |
Notifications & User Alerts
| کلید | بخش Tweak Settings | توضیحات / مقدار پیشفرض | نکات مهم |
|---|---|---|---|
| emailusers_diskusage_critical_percent | Notifications | 90 | هشدار بحرانی مصرف دیسک. |
| emailusers_diskusage_full Written & researched by Dr. Shahin Siami |