فایل تنظیمات آمارگیری (stats.conf)، حذف Ruby قدیمی، آشنایی با Domain TLS، مکانیزم License Callback و فایل cpanelsync.exclude در cPanel & WHM

این مقاله چند بخش مهم و پیشرفته از سیستم cPanel & WHM را توضیح می‌دهد: ۱) فایل تنظیمات آمارگیری stats.conf ۲) نحوه حذف Ruby قدیمی ۳) عملکرد Domain TLS و مدیریت گواهینامه‌ها ۴) مکانیزم License Callback و پورت‌های موردنیاز ۵) فایل cpanelsync.exclude برای جلوگیری از بروزرسانی برخی فایل‌ها این راهنما برای مدیران سرور بسیار کاربردی است.

stats.conf cPaneluninstall Ruby WHMDomain TLS cPanellicense callback mechanismcpanelsync.exclude

~3 min read • Updated Feb 18, 2026

1. فایل تنظیمات Statistics Software (stats.conf)


فایل /etc/stats.conf تنظیماتی را ذخیره می‌کند که از مسیر زیر در WHM اعمال می‌کنید:

WHM » Server Configuration » Statistics Software Configuration

نکته مهم: این فایل را به‌صورت دستی ویرایش نکنید.


1.1 گزینه‌های موجود در فایل

نامتوضیحمثال
ALLOWALLاجازه به همه کاربران برای انتخاب نرم‌افزار آمارگیریno
BLACKHOURSساعت‌هایی که پردازش آمارگیری انجام نمی‌شود10,11
DEFAULTGENSنرم‌افزارهای پیش‌فرض آمارگیریANALOG,WEBALIZER
allow_awstats_includeاجازه به کاربران برای تعریف فایل include در AWStats0

1.2 نمونه فایل

ALLOWALL=no
BLACKHOURS=10,11
DEFAULTGENS=ANALOG,WEBALIZER
allow_awstats_include=0

2. حذف Ruby قدیمی (Legacy Ruby)


هشدار: Ruby قدیمی از نسخه 66 به بعد منسوخ شده و دیگر پشتیبانی نمی‌شود. این شامل موارد زیر است:

  • cPanel » Software » Ruby on Rails
  • cPanel » Software » RubyGems
  • WHM » Software » Module Installers (Ruby Gems)

برای نصب Ruby در نسخه‌های جدید، باید از مستندات How to Create Ruby Web Applications استفاده کنید.


2.1 حذف Ruby کامپایل‌شده دستی

اگر Ruby را دستی کامپایل کرده‌اید:

make uninstall

سپس فایل‌های باقی‌مانده را آرشیو کنید:

mv /usr/bin/ruby /usr/bin/ruby.bak`date +%F`
mv /usr/lib/ruby /usr/lib/ruby.bak`date +%F`
mv /usr/bin/gem /usr/bin/gem.bak`date +%F`
mv /usr/bin/rails /usr/bin/rails.bak`date +%F`

2.2 حذف با rpm

برای مشاهده بسته‌های Ruby:

rpm -qa | grep -i ruby

برای حذف بسته:

rpm -e --nodeps packagename

2.3 حذف با yum

برای یافتن بسته Ruby:

yum provides ruby

برای حذف:

yum erase packagename

3. Domain TLS چیست؟


Domain TLS سیستمی است که گواهینامه‌های معتبر سرور را در یک مخزن مبتنی بر دامنه ذخیره و مدیریت می‌کند. این سیستم باعث بهبود سرعت و کارایی SNI می‌شود.


3.1 نسخه‌های TLS پشتیبانی‌شده

  • پشتیبانی از TLS 1.2 و TLS 1.3
  • TLS 1.3 نیازمند OpenSSL 1.1.1 یا بالاتر است

3.2 نحوه عملکرد Domain TLS

هنگام نصب SSL برای Apache، گواهینامه برای هر دامنه موجود در VirtualHost در Domain TLS ذخیره می‌شود.

Domain TLS مسئول SNI برای سرویس‌های زیر است:

  • cpsrvd — ورود به cPanel، WHM، Webmail
  • cpdavd — تقویم، مخاطبین، Web Disk
  • exim — ارسال و دریافت ایمیل
  • dovecot — سرویس Mailbox

3.3 تفاوت با ذخیره‌سازی SSL در Apache

  • Apache دامنه‌ها را در VirtualHost گروه‌بندی می‌کند
  • Domain TLS هر دامنه را جداگانه ذخیره می‌کند
  • www.example.com و example.com جدا ذخیره می‌شوند
  • گواهینامه‌های منقضی یا نامعتبر ذخیره نمی‌شوند


4. مکانیزم License Callback


این مکانیزم به‌محض تغییر لایسنس در Manage2 یا cPanel Store، سرور را مطلع می‌کند. این مکانیزم هیچ تغییری روی سرور اعمال نمی‌کند.


4.1 پورت‌های موردنیاز

حداقل یکی از پورت‌های زیر باید باز باشد:

سرویسپورت
cPanel2082
cPanel SSL2083
WHM2086
WHM SSL2087
Webmail SSL2096

4.2 IPهای مورد استفاده

208.74.121.0/24
208.74.123.0/24

5. فایل cpanelsync.exclude


فایل /etc/cpanelsync.exclude برای جلوگیری از بروزرسانی برخی فایل‌های توزیع‌شده توسط cPanel استفاده می‌شود.

نکات مهم:

  • فقط بروزرسانی‌های cpanelsync را مسدود می‌کند
  • تغییرات زمان اجرا را مسدود نمی‌کند
  • فایل‌های مدیریت‌شده توسط بسته‌ها را نمی‌توان مسدود کرد

5.1 بررسی اینکه فایل توسط بسته مدیریت می‌شود یا نه

در Red Hat:

rpm -qf /path/to/file

در Ubuntu:

dpkg -S /path/to/file

5.2 افزودن مسیرها به فایل

هر مسیر باید مطلق و در یک خط جدا باشد.

مثال:

/usr/local/cpanel/scripts/pkgacct
/usr/local/cpanel/Cpanel/Logd.pm

افزودن مسیرها:

echo "/usr/local/cpanel/scripts/pkgacct" >> /etc/cpanelsync.exclude
echo "/usr/local/cpanel/Cpanel/Logd.pm" >> /etc/cpanelsync.exclude

نتیجه‌گیری


این مقاله بخش‌های مهمی از زیرساخت cPanel & WHM را توضیح داد: فایل stats.conf، حذف Ruby قدیمی، سیستم Domain TLS، مکانیزم License Callback و فایل cpanelsync.exclude. آشنایی با این بخش‌ها به مدیران سرور کمک می‌کند محیطی پایدار، امن و قابل پیش‌بینی داشته باشند.


Written & researched by Dr. Shahin Siami