راهنمای کامل نصب و راه‌اندازی Django

این مقاله یک راهنمای جامع برای نصب و راه‌اندازی Django ارائه می‌دهد. از نصب Python و ایجاد محیط مجازی گرفته تا نصب Django، راه‌اندازی پایگاه‌داده، و استفاده از وب‌سرورهایی مانند Apache و mod_wsgi، تمام مراحل به‌صورت دقیق و کاربردی توضیح داده شده است. این مقاله برای مبتدیان و توسعه‌دهندگان حرفه‌ای مناسب است.

نصب و راه‌اندازیجنگو

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

مقدمه

Django یکی از محبوب‌ترین فریم‌ورک‌های وب در زبان Python است که برای توسعه سریع، امن و مقیاس‌پذیر طراحی شده است. برای شروع کار با Django، لازم است چند مرحله کلیدی شامل نصب Python، راه‌اندازی پایگاه‌داده و نصب خود Django را طی کنید.

۱. نصب Python

Django یک فریم‌ورک مبتنی بر Python است؛ بنابراین اولین قدم نصب Python است.

  • آخرین نسخه Python را از سایت رسمی دریافت کنید.
  • در ویندوز می‌توانید از راهنمای «نصب Django در ویندوز» استفاده کنید.
  • در لینوکس و macOS معمولاً Python از قبل نصب است.

۲. نصب Apache و mod_wsgi (اختیاری)

اگر فقط قصد آزمایش Django را دارید، می‌توانید از وب‌سرور داخلی Django استفاده کنید. اما برای محیط تولید (Production)، استفاده از Apache همراه با mod_wsgi توصیه می‌شود.

مزایای mod_wsgi:

  • اجرای سریع‌تر به دلیل بارگذاری کد در حافظه
  • پشتیبانی از حالت daemon برای امنیت و مدیریت بهتر
  • امکان راه‌اندازی مجدد بدون توقف کامل Apache

پس از نصب Apache، باید mod_wsgi را فعال کنید. سپس می‌توانید از مستندات Django برای پیکربندی آن استفاده کنید.

۳. راه‌اندازی پایگاه‌داده

Django از پایگاه‌داده‌های مختلفی پشتیبانی می‌کند:

  • PostgreSQL
  • MariaDB / MySQL
  • Oracle
  • SQLite (پیش‌فرض)

نکات مهم:

  • برای پروژه‌های کوچک، SQLite بهترین گزینه است.
  • برای پروژه‌های بزرگ، بهتر است از همان پایگاه‌داده‌ای استفاده کنید که در محیط تولید استفاده خواهد شد.

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

  • PostgreSQL → بسته psycopg یا psycopg2
  • MySQL/MariaDB → بسته mysqlclient
  • Oracle → بسته oracledb

تنظیمات DATABASES در Django:

در فایل settings.py باید مقادیر زیر را تنظیم کنید:


ENGINE: نوع پایگاه‌داده  
NAME: نام پایگاه‌داده  
USER, PASSWORD, HOST: برای پایگاه‌داده‌های غیر SQLite

اگر از migrate استفاده می‌کنید، باید کاربر پایگاه‌داده اجازه ایجاد و تغییر جدول‌ها را داشته باشد.

۴. نصب Django

بهترین و استانداردترین روش نصب Django استفاده از pip است.

گام‌ها:

  • نصب pip (در صورت نیاز)
  • ایجاد محیط مجازی با venv
  • فعال‌سازی محیط مجازی
  • اجرای دستور نصب:
python -m pip install Django

۵. نصب Django از مخزن توسعه (Development Version)

اگر می‌خواهید از آخرین نسخه در حال توسعه Django استفاده کنید:

  • Git را نصب کنید.
  • مخزن Django را کلون کنید:
git clone https://github.com/django/django.git
  • در محیط مجازی دستور زیر را اجرا کنید:
python -m pip install -e django/

برای به‌روزرسانی Django کافی است در پوشه django دستور زیر را اجرا کنید:

git pull

جمع‌بندی

برای نصب Django کافی است Python، یک محیط مجازی و پایگاه‌داده مناسب داشته باشید. سپس با استفاده از pip می‌توانید Django را نصب کنید. برای محیط تولید، استفاده از Apache و mod_wsgi توصیه می‌شود. همچنین می‌توانید از نسخه توسعه Django برای دسترسی به آخرین قابلیت‌ها استفاده کنید.

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

مقالات مرتبط

فریم‌ورک Tasks در Django: راهنمای کامل اجرای کارهای پس‌زمینه در Django 6.0

Django 6.0 فریم‌ورک Tasks را معرفی کرده است؛ سیستمی داخلی برای تعریف و صف‌بندی کارهای پس‌زمینه خارج از چرخهٔ request–response. این مقاله نحوهٔ کار Tasks، پیکربندی backendها، تعریف و enqueue کردن Taskها، استفاده از context، و ادغام با سیستم‌های Worker خارجی را توضیح می‌دهد.

ادامه

پشتیبانی Asynchronous در Django: راهنمای کامل Async Views، ORM، Middleware، عملکرد و ایمنی

این مقاله پشتیبانی Django از برنامه‌نویسی غیرهم‌زمان (async) را توضیح می‌دهد. موضوعاتی مانند async views، اجرای Django تحت ASGI، رفتار middleware، قابلیت‌های ORM غیرهم‌زمان، sync_to_async، مدیریت قطع اتصال، نکات عملکردی، و مکانیزم‌های ایمنی Django برای جلوگیری از استفادهٔ ناامن async بررسی می‌شوند.

ادامه

System Check Framework در Django: راهنمای کامل نوشتن، ثبت، اجرا و تست چک‌های سیستمی

System Check Framework در Django مجموعه‌ای از بررسی‌های استاتیک برای تشخیص مشکلات رایج در پروژه است. این مقاله نحوهٔ اجرای چک‌ها، نوشتن چک‌های سفارشی، مدیریت پیام‌ها، برچسب‌گذاری چک‌ها، افزودن چک به مدل‌ها و فیلدها، و نوشتن تست‌های واحد و یکپارچه برای چک‌ها را توضیح می‌دهد.

ادامه

سیگنال‌ها در Django: راهنمای کامل استفاده، اتصال، ارسال و مدیریت Signalها

این مقاله سیستم سیگنال‌های Django را توضیح می‌دهد؛ مکانیزمی برای اطلاع‌رسانی رویدادها بین بخش‌های مختلف برنامه بدون ایجاد وابستگی مستقیم. موضوعاتی مانند نحوهٔ اتصال receiverها، استفاده از decorator، مدیریت senderهای خاص، محل مناسب قرارگیری کد سیگنال‌ها، هشدارهای مهم، و بهترین شیوه‌ها بررسی می‌شوند.

ادامه

آشنایی کامل با Django Settings: پیکربندی، مدیریت محیط، و بهترین شیوه‌ها

این مقاله یک راهنمای جامع دربارهٔ سیستم تنظیمات در Django ارائه می‌دهد. موضوعاتی مانند ساختار فایل تنظیمات، نحوهٔ تعیین DJANGO_SETTINGS_MODULE، استفاده از settings در کد، امنیت، پیکربندی دستی با configure()، استفادهٔ مستقل از Django با django.setup() و ایجاد تنظیمات سفارشی بررسی می‌شوند.

ادامه

سریال‌سازی و دسریال‌سازی در Django: راهنمای کامل کار با Serialization Framework

این مقاله سیستم سریال‌سازی Django را توضیح می‌دهد؛ از نحوهٔ تبدیل مدل‌ها به JSON، XML، YAML و JSONL گرفته تا دسریال‌سازی داده‌ها، سریال‌سازی فیلدهای انتخابی، کار با مدل‌های ارث‌بری، مدیریت روابط، و نکات مهم هنگام ذخیرهٔ داده‌های دسریال‌شده.

ادامه