راهنمای کامل فایل تنظیمات cPanel & WHM: فایل /var/cpanel/cpanel.config (نسخه‌های ۱۱۰ تا ۱۳۰)

این مقاله فایل /var/cpanel/cpanel.config را که مهم‌ترین فایل تنظیمات WHM و cPanel است، به‌صورت کامل توضیح می‌دهد. تمام گزینه‌های موجود در Tweak Settings در نهایت در این فایل ذخیره می‌شوند. مقاله شامل توضیح کلیدها، مقدار پیش‌فرض، محل قرارگیری در WHM و نکات مهم درباره مقادیر پویا، کش و نحوه ویرایش امن فایل است.

cpanel.configWHM configurationTweak Settings file

~3 دقیقه مطالعه · آخرین به‌روزرسانی ۲۸ بهمن ۱۴۰۴

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توضیحات / مقدار پیش‌فرضنکات مهم
enginecpanelتغییر ندهید.
engineroot/usr/local/cpanelتغییر ندهید.
engineplcpanel.plتغییر ندهید.
root/usr/local/cpanelتغییر ندهید.
conserve_memory0پویا — فقط از WHM تغییر دهید.
maxmem4096حداکثر حافظه برای پردازش‌های cPanel (MB).
maxcpsrvdconnections200حداکثر اتصال همزمان به cpsrvd.

Security / Login & Authentication


کلیدبخش Tweak Settingsتوضیحات / مقدار پیش‌فرضنکات مهم
cgihidepassSecurity → Hide login password0مخفی کردن رمز از CGI.
cookieipvalidationSecurity → Cookie IP validationstrictحالت‌های strict / loose / off.
domainowner_mail_passMail → Mail authentication0پویا — اجازه ارسال ایمیل با رمز مالک دامنه.
resetpass1اجازه ریست پسورد cPanel.
resetpass_sub1اجازه ریست پسورد ساب‌اکانت.
requiresslSecurity → Require SSL1اجبار SSL برای WHM/cPanel/Webmail.

Email / Mail Settings


کلیدبخش Tweak Settingsتوضیحات / مقدار پیش‌فرضنکات مهم
exim_retention_daysStats and Logs10مدت نگه‌داری آمار Exim.
exim-retrytimeMail → Retry time15زمان retry ارسال ایمیل (دقیقه).
eximmailtrapMail → Track email origin1فعال‌سازی X-Source header.
mailbox_storage_formatMail → Mailbox formatmaildirmaildir یا mbox.
popbeforesmtpMail → POP-before-SMTP0اجازه relay پس از POP login.
smtpmailgidonlyMail → Restrict outgoing SMTP1فقط root، exim و mailman اجازه ارسال SMTP دارند.

DNS / Domains


کلیدبخش Tweak Settingsتوضیحات / مقدار پیش‌فرضنکات مهم
autocreateaentriesDomains → Auto A entries1افزودن رکورد A برای nameserverها.
autodiscover_hostDomains → SRV hostcpanelemaildiscovery.cpanel.netبرای autodiscover.
proxysubdomainsDomains → Service subdomains1پویا — فعال‌سازی cpanel., webmail., whm.
proxysubdomainsoverrideDomains → Override1اجازه override رکوردهای A.

PHP & Apache


کلیدبخش Tweak Settingsتوضیحات / مقدار پیش‌فرضنکات مهم
php_max_execution_timePHP → Max execution time90ثانیه.
php_memory_limitPHP → Memory limit128MB.
php_post_max_sizePHP → Max POST size55MB.
php_upload_max_filesizePHP → Max upload size50MB.

Stats & Logs


کلیدبخش Tweak Settingsتوضیحات / مقدار پیش‌فرضنکات مهم
cycle_hoursStatistics Software24به نزدیک‌ترین ۱۵ دقیقه رُند می‌شود.
dumplogsStats and Logs1حذف لاگ‌های دسترسی پس از پردازش.
keepftplogsStats and Logs0نگه‌داری لاگ اصلی FTP.
keeplogsStats and Logs0نگه‌داری لاگ‌های ماه قبل.

Notifications & User Alerts


کلیدبخش Tweak Settingsتوضیحات / مقدار پیش‌فرضنکات مهم
emailusers_diskusage_critical_percentNotifications90هشدار بحرانی مصرف دیسک.
emailusers_diskusage_full

نوشته و پژوهش‌شده توسط دکتر شاهین صیامی

مقالات مرتبط

راهنمای کامل بازیابی اکانت cPanel و انتقال حساب‌ها و تنظیمات برای مدیران سیستم تازه‌کار

این مقاله یک راهنمای جامع برای مدیران سیستم تازه‌کار است که می‌خواهند اکانت‌های cPanel را بازیابی کنند، حساب‌ها و تنظیمات را بین سرورها منتقل کنند، و از ابزارهای تشخیصی برای بررسی مشکلات انتقال و بازیابی استفاده کنند. این راهنما شامل نحوه استفاده از WHM، نحوه آپلود بکاپ‌ها، روش‌های انتقال، و فعال‌سازی لاگ‌های پیشرفته است.

ادامه

How to Move All cPanel Accounts from One Server to Another

This guide explains how to migrate all cPanel accounts, service configurations, SSL certificates, and the main server IP address from an old source server to a new target server. It covers installation requirements, configuration transfers, account migration, IP reassignment, DNS adjustments, and SSL restoration.

ادامه

آموزش کامل مهاجرت یک وب‌سایت وردپرس از macOS به سرور cPanel & WHM

این مقاله نحوه انتقال یک وب‌سایت وردپرس که روی macOS میزبانی شده است را به یک سرور cPanel & WHM توضیح می‌دهد. شامل خروجی گرفتن از دیتابیس، آپلود فایل‌ها، ایجاد دیتابیس جدید، تنظیم wp-config.php، تغییر URL سایت، و رفع لینک‌ها و تصاویر خراب است.

ادامه

آموزش کامل انتقال دستی یک اکانت بین سرورها در cPanel & WHM

این مقاله نحوه انتقال دستی یک اکانت بین دو سرور را زمانی که حجم اکانت برای ابزارهای انتقال WHM بسیار بزرگ است توضیح می‌دهد. شامل ایجاد دایرکتوری موقت، فشرده‌سازی public_html و لاگ‌ها، انتقال امن با scp، و بازیابی فایل‌ها در سرور جدید است.

ادامه

آموزش کامل مهاجرت دستی داده‌های Horde به Roundcube در cPanel & WHM

این مقاله نحوه مهاجرت دستی تقویم‌ها و مخاطبین Horde به Roundcube را در نسخه‌های 108 تا 118 cPanel & WHM توضیح می‌دهد. شامل مراحل خروجی گرفتن از Horde، انتقال فایل‌ها به مسیرهای صحیح، و وارد کردن داده‌ها در Roundcube با استفاده از افزونه‌های داخلی یا ابزارهای واردسازی است.

ادامه

آموزش کامل مهاجرت دستی اکانت‌ها از کنترل‌پنل‌های غیرپشتیبانی‌شده به cPanel & WHM

این مقاله نحوه مهاجرت دستی اکانت‌ها از کنترل‌پنل‌های غیرپشتیبانی‌شده به cPanel & WHM را توضیح می‌دهد. شامل اقدامات قبل از مهاجرت، نصب سرور جدید، انتقال فایل‌ها و دایرکتوری‌ها، بازیابی دیتابیس‌ها، انتقال SSL، و اقدامات پس از مهاجرت است.

ادامه