راهنمای جامع مهاجرت از cPanel به DirectAdmin

مقدمه

انتقال هاست‌ها و حساب‌های کاربری از cPanel به DirectAdmin یکی از نیازهای متداول مدیران سرور است. به دلیل تفاوت‌های ساختاری و امکانات این دو کنترل‌پنل، لازم است پیش از شروع فرآیند، با نکات کلیدی، محدودیت‌ها و مشکلات احتمالی آشنا باشید. این مقاله تمام مراحل، دستورات و هشدارهای مربوط به این فرآیند را به صورت کامل و آموزشی توضیح می‌دهد.

ملاحظات هنگام مهاجرت (cPanel to DA considerations)

مشکلات شناخته‌شده (Known issues)

• Mailman در cPanel به صورت خودکار به Majordomo در DirectAdmin تبدیل نمی‌شود. بنابراین اگر از لیست‌های پستی استفاده می‌کنید، باید آن‌ها را دستی منتقل یا بازسازی کنید.
• هنگام استفاده از فایل‌های بکاپ cpmove-user.tar.gz، برای امنیت باید مطمئن باشید خودتان این فایل‌ها را ایجاد کرده‌اید. در حال حاضر DirectAdmin کاملاً به محتوای این فایل اعتماد می‌کند و تنها در سطح Admin قابل استفاده است. ممکن است این سیاست در آینده تغییر کند.

قالب نام‌گذاری دیتابیس‌ها و یوزرها

• در DirectAdmin، فرمت نام‌ها همیشه به شکل زیر است: username_database username_user
• cPanel نیز از همین فرمت استفاده می‌کند، اما به دلیل محدودیت طول نام، ممکن است بخش username را کوتاه کند.
• در cPanel ممکن است myusername_ تبدیل شود به myuserna_ در یوزرنیم دیتابیس. در DirectAdmin همیشه کامل استفاده می‌شود و تغییر این ساختار می‌تواند باعث تداخل شود.
• مثال:
  • کاربر myuserna ممکن است مالک دیتابیس myuserna_db1 باشد.
  • کاربر myusername ممکن است مالک دیتابیس myserna_db2 شود.

برای جلوگیری از این مشکل، اسکریپت مهاجرت نام‌ها را به فرمت درست تبدیل می‌کند. در بعضی موارد ممکن است نیاز باشد فایل‌های پیکربندی مثل wp-config.php یا سایر فایل‌های CMS را اصلاح کنید.

• نمونه خروجی اسکریپت در این حالت:
  

WARNING! us_wordpress cannot be owned by user, renaming database user to user_wordpress

توصیه‌ها و نکات دیگر

1. بهتر است فایل‌های cpmove-user.tar.gz را بعد از ریستور روی سرور نگه دارید. اگر مشکلی پیش بیاید، امکان بازیابی وجود دارد.
2. مانند هر نرم‌افزاری، احتمال وجود باگ هست. اگر مشکلی دیدید، باید گزارش دهید تا اصلاح شود.
3. امکانات DirectAdmin با cPanel تفاوت دارد:
   • DirectAdmin از Nginx/OpenLiteSpeed، MySQL8، rspamd پشتیبانی می‌کند.
   • اما PostgreSQL و Ruby را پشتیبانی نمی‌کند.
   • اگر سایت‌هایی دارید که از این تکنولوژی‌ها استفاده می‌کنند، باید به صورت دستی منتقل شوند.

محدودیت طول نام کاربری

• حداکثر طول یوزرنیم در MySQL: ۱۶ کاراکتر
• حداکثر طول یوزرنیم در سیستم (system user): ۱۰ کاراکتر
• امکان افزایش این مقدار در DirectAdmin وجود دارد. تنظیمات در فایل زیر انجام می‌شود:

/usr/local/directadmin/conf/directadmin.conf

• بررسی بیشترین طول یوزرنیم در cPanel:

ls /var/cpanel/users | awk '{print length, $0}' | sort -nr | head -n1

• افزایش طول یوزرنیم در DirectAdmin (مثلاً تا ۱۶ کاراکتر):

/usr/local/directadmin/directadmin set max_username_length 16
service directadmin restart

• برای اطمینان از اینکه نام دیتابیس‌ها و یوزرها مشکلی نخواهند داشت، پیشنهاد می‌شود MySQL/MariaDB را به نسخه‌های جدیدتر (MySQL 5.7+ یا MariaDB 10.x) ارتقا دهید.

تست اولیه پیش از انتقال همه حساب‌ها

پیشنهاد می‌شود ابتدا یک حساب (ترجیحاً حسابی با طولانی‌ترین دیتابیس/یوزرنیم) منتقل کنید تا مطمئن شوید محدودیتی در nameserver و سایر بخش‌ها وجود ندارد.

نکات درباره فایل‌های بکاپ

اگر فایل شما به شکل user.tar.gz باشد (و نه cpmove-user.tar.gz)، کار نخواهد کرد.

دستور اصلاح نام:

for i in `ls *.tar.gz | grep '^[A-Za-z0-9]*.tar.gz'`; do { mv -vf ${i} cpmove-${i}; }; done

اگر فایل شما به شکل backup-...._user.tar.gz باشد، باز هم کار نخواهد کرد.

دستور تغییر نام دسته‌ای:

for i in `ls backup-[0-9]*.*.tar.gz`; do { USERNAME=`echo $i | cut -d_ -f3 | cut -d'.' -f1`; mv -v $i cpmove-${USERNAME}.tar.gz; }; done

مشکلات در لیست کاربران و ریسلرها

• اگر کاربر در لیست Move users between resellers دیده نمی‌شود، باید فایل‌های users.list مربوط به همه ریسلرها بازسازی شوند.
• اگر ریسلرها را قبل از کاربران ریستور نکرده باشید، همه کاربران به admin اختصاص داده می‌شوند.
  • برای انتقال آن‌ها به ریسلر درست:

cd /home/admin/all_backups for i in `ls user*.tar.gz`; do
 { RESELLER=`echo $i | cut -d. -f2`; USER=`echo $i | cut -d'.' -f3`; /usr/local/directadmin/scripts/move_user_to_reseller.sh $USER admin $RESELLER; }; done echo "action=cache&value=showallusers" >> /usr/local/directadmin/data/task.queue /usr/local/directadmin/dataskq d

انتقال همه حساب‌ها از cPanel به DirectAdmin

مراحل روی سرور (cPanel)

ایجاد بکاپ از همه حساب‌ها:

mkdir -p /home/all_backups for user in `ls /var/cpanel/users/`; do { /scripts/pkgacct ${user} /home/all_backups; }; done

انتقال بکاپ‌ها به سرور:

DirectAdmin: rsync -avt --delete /home/all_backups/ root@your_directadmin_server.com:/home/admin/all_backups/

مراحل روی سرور (DirectAdmin)

تغییر مالکیت بکاپ‌ها به کاربر

 admin: chown -R admin. /home/admin/all_backups

وارد بخش Admin Backup/Transfer شوید و همه بکاپ‌ها را از مسیر /home/admin/all_backups ریستور کنید.

توصیه می‌شود فایل‌های بکاپ را چند هفته یا ماه نگه دارید تا در صورت بروز مشکل بتوانید به آن‌ها دسترسی داشته باشید.

اگر فضای کافی روی سرور cPanel ندارید

می‌توانید به جای گرفتن بکاپ همه حساب‌ها، هر حساب را به صورت مستقیم به سرور DirectAdmin منتقل کنید.

1. ایجاد کلید SSH روی cPanel: ssh-keygen کلید عمومی در مسیر /root/.ssh/id_rsa.pub قرار می‌گیرد. آن را در فایل /root/.ssh/authorized_keys روی سرور DirectAdmin کپی کنید.
2. انتقال مستقیم هر حساب:

for user in `ls /var/cpanel/users/`; do { /scripts/pkgacct ${user} /home/all_backups; rsync -avt /home/all_backups/cpmove-${user}.tar.gz root@your_directadmin_server.com:/home/admin/all_backups/cpmove-${user}.tar.gz; rm -f /home/all_backups/cpmove-${user}.tar.gz ; }; done

انتقال یک حساب تکی از cPanel به DirectAdmin

مراحل روی سرور( cPanel)

گرفتن بکاپ از یک کاربر (USERNAME را با نام واقعی جایگزین کنید):

/scripts/pkgacct USERNAME /home/user_backups;

انتقال بکاپ به سرورDirectAdmin:

rsync -avt /home/user_backups/cpmove-USERNAME.tar.gz root@your_directadmin_server.com:/home/admin/

مراحل روی سرور (DirectAdmin)

تبدیل بکاپ به فرمت (DirectAdmin)

rsync -avt /home/user_backups/cpmove-USERNAME.tar.gz root@your_directadmin_server.com:/home/admin/

تغییر مالکیت بکاپ:

chown -R admin:admin /home/admin/converted_user_backup

وارد بخش Admin Backup/Transfer شوید و مسیر /home/admin/converted_user_backup را انتخاب کنید تا بکاپ شناسایی شود و ریستور انجام شود.

جمع‌بندی

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