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

هشدار npm audit را چطور برطرف کنیم بدون اینکه برنامه از کار بیفتد؟

روش خواندن گزارش npm audit، پیدا کردن وابستگی آسیب‌پذیر و آزمون به‌روزرسانی بدون اجرای کورکورانه force.

انتشار:
توسط تیم فنی نت‌آرام
۷ دقیقه زمان مطالعه
۰ دیدگاه
محتوای تخصصی، ساده و کاربردی
هماهنگ با هویت حرفه‌ای نت‌آرام
بازگشت به لیست مقالات
تصویر شاخص مقاله هشدار npm audit را چطور برطرف کنیم بدون اینکه برنامه از کار بیفتد؟ در وبلاگ نت‌آرام
محتوای آموزشی وبلاگ نت‌آرام
بعد از نصب بسته‌ها، npm چند هشدار آسیب‌پذیری نشان می‌دهد و پیشنهاد npm audit fix می‌دهد. دیدن هشدار به این معنا نیست که هر سایت فوراً هک شده، اما نادیده‌گرفتن آن هم مناسب نیست. باید نام بسته، نسخه، مسیر وابستگی، شرایط سوءاستفاده و بخشی از برنامه را که از آن استفاده می‌کند بشناسیم.
اجرای فوری npm audit fix --force روی سایت فعال ممکن است نسخه‌های اصلی ناسازگار را نصب کند. ابتدا گزارش را در نسخه آزمایشی بخوانید، تغییر پیشنهادی را بررسی و سپس برنامه را با امکان بازگشت امتحان کنید.

۱. نسخه پروژه و فایل قفل را ثبت کنید

در ترمینال و پوشه کپی آزمایشی پروژه:
کد / دستورpwd node --version npm --version ls -la package.json package-lock.json
نسخه کد و فایل قفل سالم را در سیستم کنترل نسخه یا پشتیبان امن نگه دارید. npm audit معمولاً به package.json و فایل قفل نیاز دارد. اگر پروژه از ابزار و فایل قفل دیگری استفاده می‌کند، دستور و گزارش همان ابزار را طبق مستنداتش بررسی کنید.
این بررسی اطلاعاتی درباره وابستگی‌ها را برای registry تنظیم‌شده ارسال می‌کند؛ پیش از اجرا مطمئن شوید مخزن مورد اعتماد و مطابق سیاست سازمان است و اطلاعات محرمانه در فایل‌های پروژه قرار ندارد.

۲. گزارش را بدون تغییر وابستگی‌ها بخوانید

کد / دستورnpm audit
نام بسته، نسخه آسیب‌پذیر، شدت گزارش، مسیر وابستگی و پیشنهاد رفع را یادداشت کنید. عدد کل هشدار به تنهایی شدت خطر واقعی سایت را تعیین نمی‌کند. صفحه advisory را بخوانید تا بفهمید کدام قابلیت، ورودی یا شرایط تحت تأثیر است. یک وابستگی توسعه که فقط در build استفاده می‌شود با کدی که در هر درخواست کاربر روی سرور اجرا می‌شود ممکن است شرایط متفاوتی داشته باشد؛ با این حال ابزار build نیز می‌تواند بخشی از زنجیره حساس انتشار باشد.
برای دیدن اینکه چرا بسته نصب شده، در نسخه‌هایی از npm که این فرمان را پشتیبانی می‌کنند:
کد / دستورnpm explain example-package npm ls example-package
نام نمونه را با بسته گزارش‌شده عوض کنید. خروجی نشان می‌دهد بسته مستقیم است یا از طریق بسته دیگری آمده. اگر چند نسخه وجود دارد، مسیر هر کدام را جدا بخوانید. npm ls ممکن است در صورت ناسازگاری وابستگی‌ها با کد خطا خارج شود؛ پیام آن را با دقت بررسی کنید.

۳. تغییر پیشنهادی را پیش از اجرا ببینید

در کپی آزمایشی می‌توانید نمای پیشنهادی را بخواهید:
کد / دستورnpm audit fix --dry-run --json
طبق نسخه npm، این گزارش نشان می‌دهد چه تغییرهایی پیشنهاد می‌شود؛ خروجی را از نظر داده خصوصی بررسی کنید. --dry-run جای تست نصب واقعی نیست. تفاوت نسخه‌های اصلی، نیازمندی Node و تغییرات ناسازگار بسته را پیش از اعمال بخوانید. در محیط تولید یا روی فایل قفل فعال، این آزمایش را بدون روند انتشار تأییدشده انجام ندهید.
اگر بسته مستقیم است، توسعه‌دهنده می‌تواند نسخه رفع‌شده و سازگار را در کپی پروژه انتخاب و تغییر package.json و فایل قفل را بازبینی کند. اگر بسته غیرمستقیم است، ممکن است لازم باشد بسته والد به نسخه‌ای که وابستگی اصلاح‌شده دارد ارتقا یابد. استفاده از overrides بدون بررسی سازگاری می‌تواند در زمان اجرا خطای پنهان ایجاد کند.
اگر گزارش می‌گوید راه‌حل آماده موجود نیست، نام advisory و مسیر استفاده از بسته را به مسئول پروژه بدهید. محدودکردن ورودی آسیب‌پذیر یا غیرفعال‌کردن قابلیت مرتبط شاید یک اقدام موقت باشد، اما باید برای همان آسیب‌پذیری سنجیده شود و جای انتشار وصله معتبر را نمی‌گیرد.

یک نمونه واقعی: به‌روزرسانی وابستگی مستقیم

فرض کنید گزارش دقیقاً بسته مستقیم lodash را بابت آسیب‌پذیری CVE-2026-2950 نشان می‌دهد. طبق گزارش امنیتی منتشرکننده، این مشکل مشخص در نسخه‌های تا 4.17.23 وجود دارد و از 4.18.0 اصلاح شده است. این فقط نمونه همان هشدار است؛ هر بسته و هر گزارش ممکن است نسخه اصلاح‌شده متفاوتی داشته باشد.
در پوشه کپی آزمایشی پروژه، اول مطمئن شوید بسته مستقیم است و نسخه پیشنهادی واقعاً در مخزن مورد اعتماد شما وجود دارد:
کد / دستورnpm ls lodash --depth=0 npm view lodash@4.18.1 version npm view lodash@4.18.1 engines --json
فرمان اول نسخه وابستگی مستقیم را نشان می‌دهد. فرمان دوم باید نسخه درخواستی را نمایش دهد؛ خروجی خالی فرمان سوم می‌تواند یعنی اطلاعات engines برای آن بسته ثبت نشده، نه اینکه سازگاری قطعاً تأیید شده است. یادداشت‌های انتشار و سازگاری پروژه را جدا بخوانید. اگر lodash اصلاً وابستگی مستقیم پروژه شما نیست، این نمونه را اجرا نکنید و به بخش وابستگی غیرمستقیم پایین بروید.
اگر این بسته در dependencies قرار دارد، نسخه 4.18.1 برای پروژه شما سازگار تشخیص داده شده و در گزارش فعلی هم نسخه امنی است، در همان کپی آزمایشی اجرا کنید:
کد / دستورnpm install --save-exact lodash@4.18.1 npm ls lodash npm audit
فرمان اول نسخه دقیق را در فایل پروژه و قفل ثبت و بسته را نصب می‌کند؛ ممکن است اسکریپت‌های نصب اجرا شوند. دومی نسخه‌های نصب‌شده را نشان می‌دهد و سومی گزارش تازه را می‌گیرد. اگر بسته موردنظر فقط در devDependencies است، نوع وابستگی را حفظ کنید و به جای فرمان اول از npm install --save-dev --save-exact lodash@4.18.1 استفاده کنید. پیش از انتخاب هر نسخه، advisoryهای تازه و محدودیت Node پروژه را دوباره ببینید؛ مثال تاریخی تضمین نمی‌کند آن نسخه برای همه هشدارهای آینده امن بماند.
اگر npm explain lodash نشان داد این بسته فقط از طریق یک بسته والد آمده است، نصب مستقیم lodash لزوماً نسخه مورد استفاده والد را عوض نمی‌کند. نام والد و محدوده نسخه اصلاح‌شده‌اش را از گزارش و یادداشت انتشار پیدا کنید. سپس با جایگزین‌کردن نام و نسخه واقعی، ابتدا اطلاعات آن را ببینید و بعد در کپی آزمایشی همان والد مستقیم را ارتقا دهید:
کد / دستورnpm view example-parent@1.2.3 dependencies --json npm install --save-exact example-parent@1.2.3 npm explain lodash npm audit
example-parent@1.2.3 نمونه است و باید با نام واقعی والد و نسخه سازگار جایگزین شود. اگر والد در devDependencies است، گزینه --save-dev را حفظ کنید. اگر بعد از ارتقای والد هنوز نسخه آسیب‌پذیر در خروجی است، مسیر دیگری هم آن را وارد کرده است؛ هر مسیر را جدا بررسی کنید. در نبود نسخه سازگار، قبل از استفاده از overrides با مسئول پروژه راهکار موقت و ریسک ناسازگاری را بسنجید.

۴. به‌روزرسانی را آزمایش و نتیجه را مقایسه کنید

پس از انتخاب نسخه مناسب و اعمال تغییر در شاخه آزمایشی، اختلاف فایل‌های پروژه و قفل را ببینید. سپس نصب تمیز را در همان کپی با روش پروژه اجرا کنید؛ npm ci پوشه node_modules آن مسیر را حذف می‌کند و ممکن است اسکریپت نصب بسته‌ها را اجرا کند. آزمون‌های خودکار، build و مسیرهای مهم مانند ورود و اتصال API را با نسخه Node هدف اجرا کنید.
npm audit را دوباره اجرا و گزارش جدید را با قبلی مقایسه کنید. نبود هشدار شناخته‌شده به معنی نبود هر آسیب‌پذیری نیست. اگر رفع کامل با نسخه سازگار موجود نیست، شرایط سوءاستفاده و اقدام موقت را با توسعه‌دهنده و مشاور امنیت بررسی کنید و تصمیم را ثبت کنید.

۵. انتشار و بازگشت

فقط نسخه‌ای را که آزمون شده با روند استقرار خود فعال کنید. نسخه قبلی کد و فایل قفل را برای بازگشت نگه دارید؛ بازگرداندن تنها package.json بدون قفل و وابستگی هماهنگ ممکن است وضعیت متفاوتی بسازد. اگر نصب به علت ناهماهنگی قفل متوقف شد، راهنمای npm ci و فایل قفل را بخوانید.
اطلاعات هاست Node.js نت‌آرام و جزئیات گزینه‌ها در مستندات npm audit آمده است.
اشتراک‌گذاری:
لینکدینتلگرامایکس

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

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