راهنمای نصب جنگو بدون اینترنت

بسیاری از برنامه‌نویسان هنگام کار با پروژه‌های سازمانی، سرورهای داخلی یا محیط‌هایی که دسترسی مستقیم به اینترنت ندارند، با چالش نصب جنگو بدون اینترنت مواجه می‌شوند. بدون اینترنت هم می‌توان از روش‌های نصب آفلاین مانند"Mirror" داخلی پایتون استفاده کرد که در ادامه این مقاله از مجله برنامه نویسی سبزلرن بیشتر در مورد آن صحبت خواهیم کرد. 

• نصب Django بدون اینترنت امکان‌پذیر است و برای سرورهای داخلی، شبکه‌های سازمانی و محیط‌های محدود کاربرد دارد.

• پیش از نصب، باید Python، محیط مجازی و "pip" را روی سیستم مقصد آماده و سازگاری نسخه‌ها را بررسی کنید.

• برای نصب آفلاین، می‌توانید روی یک سیستم متصل به اینترنت، "Django" و وابستگی‌های آن را با  pip download دانلود و به سیستم مقصد منتقل کنید.

• استفاده از فایل‌های "Wheel" و دستور pip install --no-index --find-links امکان نصب Django بدون اتصال به اینترنت را فراهم می‌کند.

• در محیط‌های سازمانی "Mirror" داخلی "pip" جایگزین "PyPI" می‌شود و مدیریت، کنترل نسخه و نصب پکیج‌های Python را ساده‌تر می‌کند.

دلایل اهمیت نصب جنگو بدون اینترنت

در بیشتر پروژه‌های شخصی و در دوره آموزش جنگو بهترین راه برای نصب Django استفاده از اینترنت است؛ اما همیشه شرایط ایده‌آل وجود ندارد. برخی محیط‌ها به‌دلایل امنیتی یا محدودیت‌های شبکه، اجازه اتصال مستقیم به اینترنت را ندارند.

دوره پیشنهادیــــ

دوره آموزش جنگو Django پروژه محور

مشاهده دوره

مهم‌ترین دلایل استفاده از قابلیت نصب جنگو بدون اینترنت عبارت‌اند از:

• نصب Django روی سرورهای بدون اینترنت: بسیاری از سرورهای سازمانی یا محیط‌های Production به دلایل امنیتی به اینترنت عمومی متصل نیستند. در این شرایط، توسعه‌دهندگان باید بتوانند کتابخانه‌های مورد نیاز پروژه را به صورت داخلی نصب کنند.

• استفاده در شبکه‌های سازمانی محدود: دسترسی کاربران و سرورها به اینترنت در اغلب شرکت‌های بزرگ کنترل می‌شود. داشتن یک Mirror داخلی به تیم توسعه کمک می‌کند بدون وابستگی به منابع خارجی، پکیج‌های پایتون را مدیریت نمایند.

• کنترل بهتر نسخه کتابخانه‌ها: یکی از مزایای مهم نصب جنگو بدون اینترنت این است که نسخه دقیق پکیج‌ها مشخص می‌شود. در نتیجه، احتمال تغییر ناخواسته نسخه‌ها و ایجاد مشکل در پروژه کاهش پیدا می‌یابد.

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

پیش‌نیازهای نصب جنگو به صورت آفلاین

قبل از شروع نصب Django بدون اینترنت، باید چند مورد را روی سیستم آماده کنید.

گام اول: نصب بودن Python روی سیستم مقصد

اولین پیش‌نیاز برای نصب Django، وجود Python روی سیستم است. ابتدا نسخه پایتون را بررسی کنید:

python --version

یا:

python3 --version

نسخه پایتون باید با نسخه Django موردنظر سازگار باشد. برای مثال، نسخه‌های جدید جنگو معمولا به نسخه‌های جدیدتر Python نیاز دارند.

گام دوم: ایجاد محیط مجازی Python

توصیه می‌شود Django را داخل یک محیط مجازی نصب کنید. زیرا محیط مجازی باعث می‌شود وابستگی‌های پروژه از سایر پروژه‌های Python جدا باشند. برای ساخت محیط مجازی:

python -m venv venv

فعال‌سازی محیط مجازی در ویندوز:

venv\Scripts\activate

در لینوکس:

source venv/bin/activate

بعد از فعال شدن محیط مجازی، تمام پکیج‌های Django در همین محیط نصب خواهند شد.

گام سوم:بررسی و آماده‌سازی pip

pip ابزار مدیریت پکیج‌های پایتون است که برای نصب جنگو و کتابخانه‌های وابسته استفاده می‌شود. برای بررسی نسخه pip:

pip --version

در نصب آفلاین، pip باید بتواند فایل‌های محلی یا Mirror داخلی را به عنوان منبع دریافت پکیج‌ها استفاده کند.

Mirror داخلی پایتون چیست و چه کاربردی دارد؟

Mirror داخلی در واقع یک نسخه داخلی از مخزن پکیج‌های Python است که در شبکه سازمان قرار می‌گیرد. به جای اینکه pip مستقیماً به PyPI متصل شود، درخواست دریافت پکیج‌ها را به این مخزن داخلی ارسال می‌کند. به زبان ساده، Mirror داخلی مانند یک کپی از مخزن اصلی Python است که در داخل شبکه شما قرار دارد. برای مثال، در نصب معمولی Django:

pip → PyPI → دانلود Django

اما در حالت استفاده از Mirror داخلی:

pip → Internal Mirror → دانلود Django

آماده‌سازی فایل‌های مورد نیاز برای نصب Django بدون اینترنت

برای نصب Django روی یک سیستم بدون اینترنت، ابتدا باید فایل‌های موردنیاز را روی یک سیستم دارای اینترنت دانلود کنید. در سیستم دارای اینترنت یک پوشه برای ذخیره پکیج‌ها ایجاد کنید:

mkdir django_packages

سپس وارد پوشه شوید:

cd django_packages

اکنون می‌توانید Django را دانلود کنید:

pip download django

با این دستور فایل Django و تمام وابستگی‌های مورد نیاز آن را دانلود می‌کنید.

فایل Wheel چیست و چرا برای نصب آفلاین مناسب است؟

فایل‌های "Wheel" با پسوند ".whl" نسخه آماده نصب پکیج‌های پایتون هستند که امکان نصب کتابخانه‌ها را بدون نیاز به دانلود سورس یا اتصال به اینترنت فراهم می‌کنند. استفاده از Wheel در نصب جنگو بدون اینترنت باعث افزایش سرعت نصب، کاهش خطاهای احتمالی و مدیریت ساده‌تر وابستگی‌های پروژه می‌شود؛ به همین دلیل یکی از بهترین گزینه‌ها برای نصب Django در محیط‌های بدون اینترنت است. پس از دانلود فایل‌های Wheel، می‌توانید پوشه پکیج‌ها را از طریق حافظه جانبی، شبکه داخلی یا سرور فایل سازمانی به سیستم مقصد منتقل کنید. پس از انتقال بلافاصله فایل‌ها برای نصب آفلاین جنگو آماده هستند.

آموزش نصب Django بدون اینترنت با pip آفلاین

بعد از انتقال فایل‌ها، کافی است pip را برای نصب از مسیر محلی تنظیم کنید. فرض کنید فایل‌های Django در پوشه زیر قرار دارند:

django_packages/

برای نصب Django:

pip install --no-index --find-links=django_packages django

در دستور قبلی گزینه "--no-index" مانع اتصال pip به اینترنت می‌شود و گزینه "--find-links" مسیر فایل‌های محلی پکیج‌ها را مشخص می‌کند. در نتیجه pip فایل‌های مورد نیاز را از پوشه تعیین‌شده پیدا کرده و Django را بدون نیاز به اینترنت نصب می‌کند.

بررسی نصب صحیح بدون اینترنت جنگو

بعد از نصب، می‌توانید نسخه Django را بررسی کرده و از نصب صحیح آن با دادن دستورهای زیر مطمئن شوید:

django-admin --version

اگر شماره نسخه نمایش داده شود، نصب Django با موفقیت انجام شده است. برای اطمینان از نصب صحیح جنگو به‌صورت آفلاین می‌توان با فرمان زیر یک پروژه جدید ایجاد کنید:

django-admin startproject testproject

سپس وارد پوشه پروژه شوید:

cd testproject

و سرور توسعه Django را اجرا کنید:

python manage.py runserver

نصب Django با استفاده از Mirror داخلی pip

اگر سازمان شما یک Mirror داخلی Python دارد، نیازی نیست فایل‌ها را به صورت دستی منتقل کنید. در این حالت کافی است pip را به مخزن داخلی متصل کنید. برای نصب Django از یک Mirror داخلی:

pip install django --index-url http://internal-mirror.local/simple/

در این دستور "internal-mirror.local" آدرس مخزن داخلی سازمان است که به‌عنوان جایگزین PyPI استفاده می‌شود. در این حالت pip به جای دریافت پکیج‌ها از اینترنت، آن‌ها را از Mirror داخلی دریافت و نصب می‌کند.

تنظیم دائمی Mirror در pip

برای جلوگیری از وارد کردن آدرس Mirror در هر نصب، می‌توان تنظیمات pip را تغییر داد. نمونه تنظیمات:

[global]
index-url = http://internal-mirror.local/simple/

بعد از این تنظیم، تمام نصب‌های pip از Mirror داخلی انجام خواهند شد.

خطاهای رایج هنگام نصب Django بدون اینترنت

نصب Django در محیط‌های آفلاین ممکن است به‌دلیل نبود فایل‌های موردنیاز، ناسازگاری نسخه‌ها یا تنظیمات نادرست pip با خطاهایی همراه شود. برخی از رایج‌ترین خطاها در زمان نصب جنگو بدون اینترنت عبارت‌اند از:

خطای پیدا نشدن Package

یکی از مشکلات رایج هنگام نصب آفلاین که اغلب کاربران مبتدی با آن مواجه می‌شوند، نبودن فایل‌های مورد نیاز در پوشه پکیج‌ها است. برای رفع این مشکل باید مطمئنی شوید که تمام "Dependency"های Django دانلود شده‌اند، نسخه Python و Django با یکدیگر سازگار هستند و مسیر فایل‌های پکیج به‌درستی در دستور نصب وارد شده است.مسیر فایل‌ها را درست وارد کنید.

ناسازگاری نسخه Python و Django

گاهی Django نصب نمی‌شود زیرا نسخه Python با نسخه Django هماهنگ نیست. قبل از نصب برای جلوگیری از این مشکل ابتدا نسخه پایتون و سپس مستندات نسخه جنگو را بررسی کنید و در صورت نیاز نسخه مناسب را دانلود نمایید.

مشکل نصب کتابخانه‌های وابسته Django

جنگو تنها یک پکیج نیست و به کتابخانه‌های دیگری نیز وابسته است. برای نصب کتابخانه می‌توانید از دستور "pip download django" استفاده کنید که باعث می‌شود وابستگی‌های اصلی نیز دانلود شوند.

جمع‌بندی؛ نصب Django آفلاین چه زمانی بهترین انتخاب است؟

نصب جنگو بدون اینترنت یک راهکار کاربردی برای محیط‌هایی است که محدودیت دسترسی به اینترنت دارند. با استفاده از فایل‌های Wheel، ابزار pip در حالت آفلاین و Mirror داخلی می‌توان Django را به‌صورت امن و کنترل‌شده نصب کرد. البته برای استفاده بهتر از Django، ابتدا باید با مفاهیم پایه پایتون، مدیریت پکیج‌ها و ساختار پروژه‌های Python آشنا باشید؛ به همین دلیل یادگیری دوره آموزش پایتون می‌تواند مسیر ورود به توسعه وب با Django را ساده‌تر کند.

دوره پیشنهادیــــ

دوره آموزش پایتون مقدماتی تا پیشرفته

مشاهده دوره

اگرچه نصب آنلاین جنگو برای شروع ساده‌تر است، اما در پروژه‌های سازمانی، سرورهای داخلی و محیط‌های حساس، استفاده از Mirror داخلی باعث مدیریت بهتر پکیج‌ها، کنترل نسخه‌های مورد استفاده و کاهش وابستگی به منابع خارجی می‌شود.