نصب جنگو در اوبونتو فقط به نصب یک بسته ختم نمی‌شود؛ باید مفسر مناسب، محیط مستقل و یک پروژهٔ قابل اجرا داشته باشید. در این راهنما Django 5.2 LTS را به‌عنوان شاخهٔ مشخص انتخاب می‌کنیم. آخرین اصلاحات همان شاخه نصب می‌شود و ارتقا به شاخهٔ اصلی دیگر به تصمیم جداگانه نیاز دارد.
انتخاب نسخه پیش از نصب جنگو در اوبونتو
موضوع اولیهٔ این صفحه اوبونتو ۲۲٫۰۴ بود. برای محیط تازه، اوبونتوی پشتیبانی‌شده با Python مناسب، مانند ۲۴٫۰۴، انتخاب ساده‌تری است. صرف سازگاری عددی کافی نیست؛ وضعیت پشتیبانی امنیتی مفسر و توزیع را هم بررسی کنید. طبق جدول سازگاری Django، شاخهٔ ۵٫۲ با Python 3.10 تا 3.14 سازگار است؛ پشتیبانی 3.14 از اصلاحیهٔ 5.2.8 اضافه شده است.
cat /etc/os-release
python3 --version
sudo apt update
sudo apt install python3-fullمفسر سیستم را برای پروژه حذف یا جایگزین نکنید. اگر نسخهٔ موجود با نیاز پروژه هماهنگ نیست، مفسر سازگار را کنار آن و با روش معتبر همان انتشار فراهم کنید. راهنمای مرتبط پایتون این جداسازی را توضیح می‌دهد.
محیط مجازی و نصب Django
mkdir django-demo
cd django-demo
python3 -m venv .venv
source .venv/bin/activate
python -m pip install "Django>=5.2,<5.3"
python -m django --version
python -m pip checkاین مراحل را با حساب عادی در پوشهٔ تازه اجرا کنید. از sudo برای pip داخل محیط استفاده نکنید. خروجی نسخه باید متعلق به شاخهٔ انتخابی باشد. وضعیت پشتیبانی را در صفحهٔ رسمی انتشار Django ببینید؛ شماره‌های قدیمی ۳٫۲ یا ۴٫۰ در تصاویر گذشته توصیهٔ امروز نیستند.
ساخت و بررسی پروژهٔ جدید
python -m django startproject config .
python manage.py check
python manage.py migrate
python manage.py runserver 127.0.0.1:8000نقطهٔ انتهای فرمان اول یعنی ایجاد پروژه در پوشهٔ جاری. این نمونه برای پروژهٔ خالی است؛ آن را روی پوشهٔ یک برنامهٔ موجود اجرا نکنید. تنظیم پیش‌فرض از SQLite استفاده می‌کند و migrate جدول‌های اولیه را می‌سازد. آموزش رسمی شروع Django ساختار پروژه و سرور توسعه را توضیح می‌دهد.
در همان رایانه نشانی http://127.0.0.1:8000/ را باز کنید. برای توقف، Ctrl+C بزنید. مشاهدهٔ صفحهٔ آغاز، مسیر پایهٔ اجرا را تأیید می‌کند؛ هنوز برنامهٔ اختصاصی، حساب‌ها یا عملیات کسب‌وکار شما آزموده نشده‌اند.
آزمون روی سرور راه دور
127.0.0.1 در مرورگر رایانهٔ شما به همان رایانه اشاره دارد، نه سرور. به‌جای عمومی کردن سرور توسعه، از تونل SSH مجاز استفاده کنید:
ssh -L 8000:127.0.0.1:8000 username@server.example.comنام حساب و میزبان را جایگزین کنید و runserver را روی سرور، محدود به loopback نگه دارید. اگر پورت محلی اشغال است، یک پورت محلی آزاد انتخاب کنید. برای این آزمون لازم نیست پورت ۸۰۰۰ را برای همهٔ اینترنت باز کنید.
رفع خطاهای رایج
No module named django معمولاً به انتخاب مفسر یا محیط اشتباه مربوط است. مسیر python -c "import sys; print(sys.executable)" را ببینید. نبود manage.py معمولاً یعنی در پوشهٔ پروژه نیستید. خطای دیتابیس را با ساخت دوبارهٔ تصادفی پروژه پنهان نکنید؛ نام و مسیر دیتابیس تنظیم‌شده را بررسی کنید.
چه چیزی برای انتشار سایت باقی می‌ماند؟
runserver برای تولید نیست. بر اساس راهنمای استقرار Django، سرور WSGI/ASGI مناسب، DEBUG خاموش، دامنه‌های مجاز مشخص، کلید محرمانه، HTTPS و روش ارائهٔ فایل‌های ثابت و بارگذاری‌شده لازم‌اند. check –deploy را با تنظیمات واقعی تولید اجرا کنید؛ عبور از این بررسی جای آزمون عملکرد سایت را نمی‌گیرد.
مطالعهٔ مرتبط
بازبینی فنی: ۱۳ آبان ۱۴۰۵. تاریخ انتشار اولیه و نشانی قبلی حفظ شده‌اند.
