ممکن است برای شما هم پیش آمده باشد که هنگام نصب کتابخانه‌های پایتون با استفاده از دستور pip با خطای تایم‌اوت یا سرعت بسیار پایین مواجه شوید. این مشکل معمولاً به دلیل اختلال در اینترنت بین‌الملل یا محدودیت‌های دسترسی رخ می‌دهد. در این مواقع، استفاده از یک Mirror (آینه) داخلی، بهترین راهکار برای دور زدن این محدودیت‌ها و افزایش سرعت دانلود است.

PyPI چیست؟

PyPI که مخفف Python Package Index است، مخزن اصلی و رسمی پکیج‌های زبان برنامه‌نویسی پایتون محسوب می‌شود.

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

روش اول: نصب پکیج‌ها به صورت موردی (موقت)

اگر نمی‌خواهید تنظیمات کلی سیستم خود را تغییر دهید و فقط قصد دارید یک بار یک پکیج خاص را از طریق سرورهای داخلی نصب کنید، می‌توانید از پارامتر -i استفاده کنید.

به عنوان مثال، برای نصب کتابخانه Mutagen از طریق میرور “رانفلر”، این دستور را در ترمینال یا CMD وارد کنید:

pip install -i https://mirror-pypi.runflare.com/simple mutagen

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

روش دوم: تنظیم میرور به صورت دائمی (Global)

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

کافیست دستورات زیر را به ترتیب در ترمینال (Linux/Mac) یا محیط Command Prompt (Windows) اجرا کنید:

pip config --user set global.index https://mirror-pypi.runflare.com/simple
pip config --user set global.index-url https://mirror-pypi.runflare.com/simple
pip config --user set global.trusted-host mirror-pypi.runflare.com

نتیجه چیست؟

بعد از اجرای این سه دستور، تنظیمات شما ذخیره می‌شود. حالا از این به بعد می‌توانید مثل همیشه و با خیال راحت، فقط دستور ساده‌ی زیر را برای هر پکیجی که می‌خواهید اجرا کنید:

pip install packageName

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

چند منبع و Mirror مفید داخلی دیگر

پکیج میرور PyPI | میرور ایرانی پکیج های پایتونی – لیارا

VSCode Extensions

چابکان – ابزارهای برنامه‌نویسی برای توسعه‌دهندگان ایران

داکیومنت‌های آفلاین کتابخانه‌ها و فریمورک‌ها

مخزن ملی منابع متن باز