وبلاگ نت‌آرامآموزش، تجربه و راهکارهای زیرساخت

رفع خطای هش بسته در pip؛ چه زمانی فایل را نباید نصب کنیم؟

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

انتشار:
توسط تیم فنی نت‌آرام
۵ دقیقه زمان مطالعه
۰ دیدگاه
محتوای تخصصی، ساده و کاربردی
هماهنگ با هویت حرفه‌ای نت‌آرام
بازگشت به لیست مقالات
تصویر شاخص مقاله رفع خطای هش بسته در pip؛ چه زمانی فایل را نباید نصب کنیم؟ در وبلاگ نت‌آرام
محتوای آموزشی وبلاگ نت‌آرام
هنگام نصب وابستگی‌های پایتون، pip می‌گوید هش فایل دانلودشده با هش مورد انتظار یکی نیست. هش مثل اثرانگشت محتوای فایل عمل می‌کند: حتی تغییر کوچک در فایل معمولاً مقدار دیگری می‌سازد. این خطا می‌تواند به فایل قفل قدیمی، انتخاب فایل متفاوت برای سیستم مقصد، کش خراب یا پاسخ نادرست یک مخزن مربوط باشد؛ در شرایطی نیز نشانه تغییر مشکوک بسته است.
هش را فوراً حذف یا با مقدار نمایش‌داده‌شده در خطا جایگزین نکنید. ابتدا باید بفهمید فایل از کجا آمده و چرا با نسخه تأییدشده پروژه فرق دارد. نمونه‌ها را در محیط آزمایشی و با وابستگی‌های قابل اعتماد اجرا کنید.

۱. محیط و بسته خطادار را شناسایی کنید

در Terminal یا SSH، وارد محیط مجازی همان پروژه شوید. در هاست دارای پنل، فرمان فعال‌سازی محیط برنامه ممکن است با python3 عمومی ترمینال متفاوت باشد:
کد / دستورpython --version python -m pip --version python -c "import sys; print(sys.executable)"
نام بسته، نسخه، فایل انتخاب‌شده و بخش Expected و Got در متن خطا را یادداشت کنید. اطلاعات دسترسی مخزن خصوصی، توکن‌ها و مسیرهای حساس را پیش از اشتراک‌گذاری بپوشانید. اگر برنامه با مفسر دیگری اجرا می‌شود، نتیجه ترمینال به‌تنهایی مشکل محیط اجرای وب را توضیح نمی‌دهد.
فایل نیازمندی تأییدشده را فقط بخوانید:
کد / دستورls -la requirements.txt
در فایل، نسخه پین‌شده و عبارت‌های --hash=sha256:... را برای بسته خطادار پیدا کنید. بعضی پروژه‌ها چند هش برای فایل‌های سازگار با سیستم‌های مختلف دارند. نصب به فایل و پلتفرم مشخص وابسته است؛ تفاوت نسخه Python، معماری یا نوع wheel ممکن است باعث انتخاب یک فایل مجاز دیگر شود که هش آن در فهرست نیست.

۲. فایل قفل و منبع بسته را مقایسه کنید

اگر پروژه فایل نیازمندی را از مخزن کد دریافت می‌کند، مطمئن شوید فایل متعلق به همان نسخه برنامه و آخرین نسخه تأییدشده است. فایل قفل رایانه یک همکار را بدون تطبیق با انتشار واقعی جایگزین نکنید. مسیر registry یا مخزن خصوصی و تنظیمات آن را نیز با مسئول پروژه بررسی کنید؛ یک آینه قدیمی یا پاسخ صفحه خطا می‌تواند فایل متفاوتی تحویل دهد.
در pip حالت بررسی هش، کنترل را برای همه وابستگی‌های لازم اعمال می‌کند. وجود هش یک بسته به‌تنهایی برای امنیت کل نصب کافی نیست. در این حالت عموماً وابستگی‌ها باید با نسخه مشخص و هش مجاز تعیین شوند. اگر پیام درباره وابستگی بدون هش است، ابتدا فهرست وابستگی‌ها را با روش ساخت فایل قفل پروژه کامل کنید؛ صرف حذف گزینه کنترل امنیت راه‌حل نیست.

۳. فایل را در محل مجزا و از منبع تأییدشده بررسی کنید

اگر مدیر پروژه اجازه داده و نام و نسخه بسته را می‌دانید، در یک پوشه موقت خصوصی می‌توانید فایل همان نسخه را از مخزن مورد اعتماد دریافت و هش آن را ببینید. عبارت نمونه را با نام و نسخه واقعی جایگزین کنید:
کد / دستورworkdir=$(mktemp -d) python -m pip download --no-deps --dest "$workdir" 'example-package==1.2.3' ls -la "$workdir"
دانلود وابستگی‌های فرعی را دریافت نمی‌کند و انتخاب فایل همچنان به پلتفرم و تنظیمات pip وابسته است. اگر نصب پروژه از فایل دیگری مانند source distribution استفاده می‌کند، هش همان فایل را مقایسه کنید. این دستور می‌تواند به مخازن تنظیم‌شده در محیط شما متصل شود؛ ابتدا صحت آن‌ها را تأیید کنید.
نام فایل واقعی را پس از دیدن خروجی جایگزین کنید:
کد / دستورpython -m pip hash "$workdir/EXACT_FILENAME.whl"
خروجی، هش همان فایل محلی است. آن را با هش موجود در فایل نیازمندی و اطلاعات معتبر انتشار مقایسه کنید. برابرکردن دستی هش با فایلی که منشأ آن معلوم نیست، کنترل امنیتی را بی‌اثر می‌کند. اگر منبع، نام فایل یا تغییر غیرمنتظره است، نصب را متوقف کنید و از مسئول بسته یا مخزن توضیح بگیرید.

۴. بسته به علت، راه مناسب را انتخاب کنید

اگر فایل قفل متعلق به نسخه دیگری از پروژه است، نسخه تأییدشده و هماهنگ آن را از مخزن پروژه بازگردانید. اگر فایل صحیح برای پلتفرم جدید هنوز در فهرست هش نیست، توسعه‌دهنده باید با ابزار مدیریت وابستگی پروژه، فایل قفل را از منابع معتبر بازتولید، تغییرات را بررسی و تأیید کند. بسته‌های بومی ممکن است برای لینوکس و ویندوز wheelهای متفاوتی داشته باشند.
اگر احتمال خرابی کش وجود دارد، به جای حذف گسترده کش یا تغییر سایت فعال، پس از تأیید منبع در محیط آزمایشی دانلود تازه را امتحان کنید:
کد / دستورpython -m pip download --no-cache-dir --no-deps --dest "$workdir" 'example-package==1.2.3'
اگر فایل قبلی همان نام را در پوشه دارد، برای آزمایش مجدد یک پوشه موقت تازه انتخاب کنید تا مقایسه روشن باشد. --no-cache-dir فقط این اجرا را از کش pip بی‌نیاز می‌کند؛ اختلاف هش واقعی یا منبع مشکوک را درست نمی‌کند.

۵. نصب و اجرای برنامه را تأیید کنید

پس از اصلاح فایل نیازمندی و تأیید منبع، در محیط مجازی آزمایشی و نه محیط فعال سایت:
کد / دستورpython -m pip install --require-hashes -r requirements.txt python -m pip check
فرمان اول نصب را با بررسی هش انجام می‌دهد و ممکن است اسکریپت‌های ساخت بسته مورد اعتماد را اجرا کند. فرمان دوم ناسازگاری‌های اعلام‌شده وابستگی‌ها را می‌سنجد، نه همه رفتار برنامه را. سپس آزمون‌های پروژه و قابلیت واقعی وب‌برنامه را اجرا کنید. نسخه قبلی را برای بازگشت نگه دارید.
اگر خود نسخه پایتون با بسته سازگار نیست، راهنمای No matching distribution مسیر متفاوتی دارد. مشخصات هاست پایتون نت‌آرام و توضیح نصب امن در مستندات pip را نیز ببینید.
اشتراک‌گذاری:
لینکدینتلگرامایکس
مقاله قبلی
مقاله قبلی وجود ندارد.

دیدگاه‌ها (۰)

دیدگاه‌های تاییدشده و پاسخ‌های تیم نت‌آرام