Django به‌عنوان یک فریم‌ورک قدرتمند و محبوب در توسعه وب، انعطاف‌پذیری زیادی در پیکربندی و مدیریت پایگاه داده‌ها ارائه می‌دهد. بااین‌حال، برای استقرار آن در محیط‌های میزبانی مانند cPanel که محدودیت‌ها و تنظیمات خاص خود را دارند، باید برخی مراحل را با دقت طی کنید.
در این مقاله، گام‌به‌گام مراحل استقرار Django روی cPanel و اتصال آن به MySQL را بررسی خواهیم کرد تا بتوانید اپلیکیشن خود را به‌راحتی در محیط عملیاتی قرار دهید.
راه اندازی Django در سی‌پنل
🔧 آماده‌سازی پروژه
پس از آماده‌سازی پروژه، آن را به‌صورت یک فایل فشرده (ZIP) ذخیره کنید.
در لینوکس
- به دایرکتوری که پروژه شما در آن قرار دارد بروید.
- دستور زیر را اجرا کنید(به‌جای archive.zip و your_project_folder، نام فایل فشرده و پوشه پروژه خود را وارد کنید.):
zip -r archive.zip your_project_folderدر ویندوز
- به دایرکتوری پروژه بروید.
- روی پوشه کلیک راست کنید و گزینه “Add to archive” را انتخاب کنید. یک فایل .zip ایجاد خواهد شد.
آپلود فایل‌ها در cPanel
- با نام کاربری و رمز عبوری که از سرویس میزبانی دریافت کرده‌اید وارد cPanel شوید.
- در داشبورد cPanel به بخش “File Manager” بروید و پوشه public_html را انتخاب کنید.
نکته: اگر اپلیکیشن برای دامنه اصلی است، فایل‌ها را در این پوشه آپلود کنید. برای دامنه‌های فرعی یا Add-on، از پوشه‌های مربوطه استفاده کنید.
- روی دکمه “Upload” کلیک کنید و فایل zip پروژه را انتخاب کنید.
- پس از اتمام آپلود، فایل را انتخاب کرده و گزینه “Extract” را انتخاب کنید تا فایل‌ها استخراج شوند.
تنظیم دیتابیس MySQL برای نصب جنگو
مراحل ایجاد دیتابیس
- در داشبورد cPanel به بخش “Databases” بروید و گزینه “MySQL Databases” را انتخاب کنید.
- در فیلد “Create New Database” نامی برای دیتابیس وارد کنید و آن را ایجاد کنید.
- در بخش “Create New User”، یک نام کاربری و رمز عبور تعریف کنید. رمز عبور را برای استفاده در مراحل بعدی ذخیره کنید.
- در قسمت “User Privileges”، گزینه “All Privileges” را انتخاب کنید.
- برای اطمینان، روی “phpMyAdmin” کلیک کنید و بررسی کنید که دیتابیس به درستی ایجاد شده باشد.
پیکربندی تنظیمات دیتابیس در فایل settings.py
در مرحله توسعه، احتمالاً از دیتابیس SQLite استفاده کرده‌اید. اکنون باید تنظیمات مربوط به MySQL را جایگزین کنید:
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.mysql',
'NAME': 'mysql_db_name',
'HOST': 'localhost',
'PORT': 3306,
'USER': 'my_sql_user',
'PASSWORD': 'password',
}
}مقدارهای mysql_db_name، my_sql_user و password را با اطلاعات واقعی جایگزین کنید. سپس فایل را ذخیره کنید.
| پیشنهاد مطالعه: آموزش ساخت دیتابیس در سی پنل |
راه‌اندازی اپلیکیشن جنگو
ایجاد اپلیکیشن
- در داشبورد cPanel به بخش “Software” بروید و گزینه “Setup Python App” را انتخاب کنید.
- روی “Create Application” کلیک کنید.
- نسخه Python مورد نظر را انتخاب کنید (نسخه‌های جدیدتر توصیه می‌شوند).
- دایرکتوری ریشه پروژه خود را وارد کنید (مثلاً اگر پروژه در public_html/Django-project است، همین مسیر را وارد کنید).
- نام دامنه مورد نظر را انتخاب کنید.
- روی دکمه “CREATE” کلیک کنید.
ویرایش فایل passenger_wsgi.py
به دایرکتوری ریشه پروژه بروید و فایل passenger_wsgi.py را ویرایش کنید. تمامی محتویات را پاک کرده و به شکل زیر تغییر دهید:
import os
import sys
from wsgi_directory.wsgi import applicationنام wsgi_directory را با نام واقعی پوشه پروژه جایگزین کنید. فایل را ذخیره کنید.
فعال‌سازی محیط مجازی و نصب وابستگی‌ها
اگر به ترمینال دسترسی دارید:
- مسیر محیط مجازی که در cPanel ایجاد شده است را کپی کرده و در ترمینال وارد کنید.
- دستورات زیر را اجرا کنید:
pip install -r requirements.txt
python manage.py makemigrations
python manage.py migrateاگر به ترمینال دسترسی ندارید:
- در بخش “Setup Python App”، اپلیکیشن خود را پیدا کرده و روی آیکون ویرایش کلیک کنید.
- فایل requirements.txt را اضافه کرده و دکمه “Run Pip Install” را کلیک کنید.
- در قسمت “Execute python scripts”، دستورات زیر را وارد کنید:
manage.py makemigrations
manage.py migrateتنظیم متغیرهای محیطی
در صورت استفاده از متغیرهای محیطی، آن‌ها را در بخش “Environment Variables” در cPanel تنظیم کنید.
تست نهایی و اطمینان از اجرای صحیح Django در cPanel
بعد از تنظیم متغیرهای محیطی، حالا وقت آن است که مطمئن شوید پروژه جنگو جنگو شما بدون مشکل کار می‌کند. دامنه‌ای که تنظیم کرده‌اید را در مرورگر باز کنید و بررسی کنید که همه‌چیز درست لود می‌شود. اگر مشکلی وجود داشت، فایل‌های لاگ مانند error.log را بررسی کنید و اتصال دیتابیس MySQL را نیز چک کنید تا از ذخیره شدن داده‌ها مطمئن شوید. در نهایت، برای امنیت بیشتر، گواهی SSL را از طریق cPanel نصب کنید. با انجام این مراحل، وب‌اپلیکیشن شما آماده بهره‌برداری است و می‌توانید روی توسعه و جذب کاربران تمرکز کنید.
خطاهای رایج
- ModuleNotFoundError: اگر وابستگی‌های پروژه به درستی نصب نشده باشند، این خطا رخ می‌دهد. مطمئن شوید که فایل requirements.txt کامل باشد.
- خطای دسترسی به دیتابیس: بررسی کنید که نام کاربری، رمز عبور و نام دیتابیس در فایل settings.py صحیح باشد.
- خطای Permission: اطمینان حاصل کنید که پوشه‌ها و فایل‌های پروژه دسترسی مناسبی دارند.
🔍 عیب یابی خطاهای رایج در راه اندازی Django
| خطا | دلیل احتمالی | راه حل |
| ModuleNotFoundError | کتابخانهها نصب نشده اند | pip install -r requirements.txt را اجرا کنید. |
| Access Denied for User | اطلاعات دیتابیس نادرست است | تنظیمات settings.py را بررسی کنید. |
| 500 Internal Error | خطا در passenger_wsgi.py | مسیر فایل wsgi.py را بررسی کنید. |
سوالات متداول:
- آیا می‌توانم چند پروژه Django را در یک حساب cPanel میزبانی کنم؟ بله، اما باید هر پروژه را در دایرکتوری جداگانه قرار داده و تنظیمات مربوط به دامنه یا زیردامنه را انجام دهید.
- چگونه می‌توانم جنگو را نصب کنم؟ برای نصب جنگو می‌توانید از دستور زیر در ترمینال استفاده کنید:
pip install django- چگونه می‌توانم پس از نصب جنگو خطاها را بررسی کنم؟ فایل stderr.log که در ریشه پروژه ایجاد شده است، جزئیات خطاها را نمایش می‌دهد.
- چگونه می‌توانم نسخه خاصی از جنگو را نصب کنم؟ برای نصب نسخه خاصی از جنگو می‌توانید از دستور زیر استفاده کنید:
pip install django==3.2- چگونه می‌توانم جنگو را از روی سیستم خود حذف کنم؟ برای حذف جنگو می‌توانید از دستور زیر استفاده کنید:
pip uninstall djangoنتیجه‌گیری
با دنبال کردن این راهنما، می‌توانید پروژه Django خود را به‌راحتی روی cPanel راه‌اندازی و مدیریت کنید. برای اطمینان از عملکرد بهتر و پایداری پروژه، انتخاب یک هاست با‌کیفیت بسیار مهم است. پیشنهاد ما، هاست پایتون مشهدهاست است که با سرعت بالا، امنیت مناسب و پشتیبانی حرفه‌ای، گزینه‌ای ایده‌آل برای میزبانی پروژه‌های جنگو به شمار می‌رود. حالا وقت آن است که با خیال راحت پروژه خود را توسعه دهید و تجربه‌ای بهتر برای کاربران خود فراهم کنید!
منبع : [dev.to]
