SSD Nodes Learn Hosting plans →
راهنماها Matt Connorتوسط Matt Connor · به‌روزرسانی شده 2026-10-23

جلوگیری از حملات زنجیره تأمین npm در سرور Node.js

حملات زنجیره تأمین npm از طریق اسکریپت‌های postinstall و بسته‌های مخرب به سرور شما نفوذ می‌کنند. با استفاده از npm ci و lockfile از اجرای کدهای ناخواسته جلوگیری کنید.

حمله زنجیره تأمین npm روی سرور شما چیست

حمله زنجیره تأمین npm از طریق بسته‌ای که برای نصب انتخاب کرده‌اید به سرور شما نفوذ می‌کند. در این فرآیند هیچ پورت بازی درگیر نیست و مرحله‌ای برای اکسپلویت وجود ندارد. npm کد را نصب می‌کند و نصب کد به معنای اجرای آن است؛ بنابراین یک برنامه کوچک Node چندین صد بسته را فراخوانی می‌کند که شما هرگز آن‌ها را بررسی نکرده‌اید و هر کدام از آن‌ها می‌توانند یک ساعت دیگر نسخه جدیدی منتشر کنند.

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

این الگوها بر اساس میزان تکرار وقوع برای شخصی که یک برنامه Node را روی یک VPS مستقر می‌کند، مرتب شده‌اند. این ترتیب با ترتیبی که یک شرکت بزرگ استفاده می‌کند متفاوت است، زیرا یک شرکت بزرگ از رجیستری داخلی، تیم بررسی و یک کپی (mirror) از رجیستری عمومی استفاده می‌کند. شما فقط یک اسکریپت deploy دارید.

شکل 1: یک حساب کاربری نگهدارنده (maintainer) مورد نفوذ قرار می‌گیرد و یک وصله منتشر می‌کند

رجیستری npm به هیچ‌کس اجازه نمی‌دهد محتوای نسخه‌ای که از قبل وجود دارد را تغییر دهد. بنابراین، مهاجمی که با فیشینگ به حساب یک نگهدارنده دسترسی پیدا کرده یا توکن انتشار او را سرقت کرده است، نمی‌تواند 4.18.2 را بازنویسی کند. آن‌ها در عوض 4.18.3 را منتشر می‌کنند.

به فایل package.json خود نگاه کنید. خطی مانند "express": "^4.18.2" به معنای نسخه 4.18.2 نیست. علامت caret به معنای «هر نسخه 4.x که برابر یا بالاتر از این نسخه باشد» است و ~4.18.2 به معنای «هر نسخه 4.18.x» است. دستور npm install این بازه را در لحظه اجرا حل (resolve) می‌کند؛ بنابراین یک commit یکسان در git، اگر دو بار در یک بعدازظهر مستقر (deploy) شود، می‌تواند دو مجموعه کد متفاوت را نصب کند. این شکاف، سطح حمله است. برای باز شدن این شکاف، نیازی نیست هیچ‌چیز روی سیستم شما مورد نفوذ قرار گرفته باشد.

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

شکل 2: اسکریپت نصب با دسترسی کاربری که عملیات استقرار را انجام می‌دهد اجرا می‌شود

یک package.json در بسته می‌تواند preinstall، install، postinstall و prepare را در بلوک scripts خود تعریف کند. npm این موارد را در حین نصب اجرا می‌کند. این اسکریپت‌ها در محیط ایزوله (sandbox) نیستند و هیچ‌کس آن‌ها را بازبینی نمی‌کند. این‌ها دستورات shell هستند که با دسترسی کاربری که دستور نصب را تایپ کرده، در دایرکتوری home همان کاربر، با دسترسی شبکه همان کاربر و با محیط کامل آن shell اجرا می‌شوند.

نسخه npm 12 که در تاریخ 8 ژوئیه 2026 منتشر شد، این رفتار پیش‌فرض را تغییر داده است: اجرای اسکریپت‌های نصب وابستگی‌ها را مسدود می‌کند، مگر اینکه فیلد allowScripts در package.json پروژه، آن‌ها را تأیید کرده باشد. تا تاریخ 12 اکتبر 2026، هیچ نسخه Node.js شامل npm 12 نیست (Node.js 26.11.1 با npm 11.20.0 عرضه می‌شود)، بنابراین تا زمانی که خودتان npm را ارتقا نداده باشید، npm موجود در سرور شما همچنان تمام آن‌ها را اجرا می‌کند.

بنابراین پرسش مفید این نیست که بسته چه کاری می‌تواند انجام دهد، بلکه این است که آن کاربر به چه چیزی دسترسی خواندن دارد. در یک سرور استقرار معمولی، پاسخ شامل ~/.npmrc که حاوی توکن رجیستری است، ~/.ssh/id_ed25519 که به عنوان کلید استقرار برای SSH (secure shell) استفاده می‌شود، ~/.aws/credentials، ~/.docker/config.json و تمام متغیرهای export شده در shell است که معمولاً DATABASE_URL در آنجا قرار دارد.

یک payload مانند این، نیازی به ماندگاری (persistence) یا افزایش سطح دسترسی (privilege escalation) ندارد. این payload چند فایل را می‌خواند، آن‌ها را از طریق HTTPS به یک میزبان می‌فرستد و با وضعیت 0 خارج می‌شود. شما هیچ چیزی نمی‌بینید، زیرا npm به صورت پیش‌فرض خروجی اسکریپت‌های نصب را مخفی می‌کند. این قابلیت را غیرفعال کنید و ببینید چه چیزی واقعاً اجرا می‌شود:

npm ci --foreground-scripts

foreground-scripts ورودی، خروجی و خطای استاندارد را با پردازش npm به اشتراک می‌گذارد، بنابراین اسکریپت‌های ساخت به جای چاپ در بافری که npm پس از موفقیت‌آمیز بودن نصب دور می‌ریزد، مستقیماً در ترمینال شما چاپ می‌شوند.

شکل 3: تایپ‌اسکوآت (typosquat) و نامی که دقیقاً تایپ نکردید

تایپ‌اسکوآت (typosquat) بسته‌ای است که با نامی بسیار شبیه به یک بسته محبوب منتشر می‌شود و منتظر می‌ماند تا شما دستور نصب را اشتباه تایپ کنید یا اشتباه کپی کنید. مکانیزم این حمله، خودِ دستور است، نه کد؛ بنابراین lockfile در اینجا کمکی به شما نمی‌کند: شما یک بار نام اشتباه را اضافه می‌کنید و از آن پس، lockfile با وفاداری همان بسته اشتباه را برای شما پین (pin) می‌کند.

نوعی از این حمله که به‌جای افراد، تیم‌ها را هدف قرار می‌دهد، dependency confusion نام دارد. فرض کنید بسته داخلی شما billing-utils نام دارد و در یک رجیستری خصوصی میزبانی می‌شود. اگر بسته‌ای با نام billing-utils در رجیستری عمومی وجود نداشته باشد، هر کسی می‌تواند آن را منتشر کند. ابزار npm نام‌های بدون scope را در رجیستری عمومی پیش‌فرض جستجو می‌کند، بنابراین نسخه عمومی می‌تواند جایگزین نسخه داخلی شود. راه حل این مشکل، استفاده از یک scope اختصاصی و نگاشت (mapping) آن به رجیستری مربوطه در فایل .npmrc است:

@yourorg:registry=https://npm.yourorg.example/
//npm.yourorg.example/:_authToken=${NPM_TOKEN}

اکنون @yourorg/billing-utils همیشه فقط از همان میزبان دریافت می‌شود، زیرا نگاشت scope به رجیستری، پیش از رجیستری پیش‌فرض بررسی می‌شود. یک نام داخلی بدون scope، هیچ نگاشتی ندارد و در نتیجه هیچ محافظتی برای آن وجود ندارد.

پیش از اضافه کردن هر dependency جدید، به‌جای نگاه کردن به نشان (badge) تعداد دانلود، خودِ بسته را بررسی کنید:

npm view some-lib repository.url maintainers time.created time.modified

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

شکل 4: وابستگی‌ای که مالک آن بی‌سروصدا تغییر کرده است

نگهدارندگان بسته‌ها را واگذار می‌کنند. شخصی دچار فرسودگی می‌شود، غریبه‌ای پیشنهاد کمک می‌دهد، حق انتشار منتقل می‌شود و هیچ اطلاعیه‌ای به پروژه‌هایی که به آن وابسته هستند نمی‌رسد. هیچ‌چیز نقض نشده است. اعتمادی که در سال 2021 به آن داشتید، اکنون در اختیار شخص دیگری است.

این کندترین شکل و سخت‌ترین مورد برای شناسایی است و هیچ دستوری مستقیماً به آن پاسخ نمی‌دهد. دو مورد این مسئله را محدود می‌کنند. پیش از آنکه بسته‌ای را انتخاب کنید، با استفاده از خط npm view در بالا بررسی کنید چه کسی اجازه انتشار دارد. سپس هنگامی که بسته‌ای که واقعاً به آن وابسته‌اید تغییر می‌کند، diff آن را بخوانید:

npm diff --diff-name-only --diff=some-lib@1.4.2 --diff=some-lib@1.4.3
npm diff --diff=some-lib@1.4.2 --diff=some-lib@1.4.3

شکل اول فقط نام فایل‌های تغییریافته را چاپ می‌کند که برای انجام در هر بار ارتقای بسته‌ای که برایتان اهمیت دارد، به اندازه کافی سریع است. یک نسخه patch که اسکریپت build را تغییر می‌دهد، فایلی به ریشه بسته اضافه می‌کند یا بلوک scripts را ویرایش می‌کند، ارزش آن را دارد که پیش از رسیدن به سرور، به‌طور کامل خوانده شود.

ساخت پروژه از روی lockfile متعهد شده با استفاده از npm ci

فایل package-lock.json نسخه دقیق هر بسته در درخت وابستگی‌ها، URL منبع هر کدام، هش یکپارچگی sha512 برای هر tarball و اینکه کدام بسته به آن نیاز داشته است را ثبت می‌کند. این فایل را commit کنید. این تنها فایلی است که مشخص می‌کند دقیقاً چه چیزی را تست کرده‌اید.

سپس در هر ماشینی که لپ‌تاپ توسعه‌دهنده نیست، نصب را با npm ci انجام دهید و هرگز از npm install استفاده نکنید:

npm ci --omit=dev --ignore-scripts

عملکرد npm ci با npm install در مواردی تفاوت دارد که همگی در اینجا اهمیت دارند. این دستور مستلزم وجود یک lockfile است. پیش از شروع، هر node_modules موجود را حذف می‌کند تا بقایای یک استقرار (deploy) قبلی به استقرار فعلی منتقل نشود. این دستور هرگز در package.json یا فایل lockfile تغییری ایجاد نمی‌کند، بنابراین نصب نمی‌تواند به‌طور خودکار شما را به نسخه جدیدتر منتقل کند. اگر lockfile و package.json با هم مغایرت داشته باشند، دستور به جای تلاش برای حل اختلاف، با خطا متوقف می‌شود.

آن خطا یک ویژگی است، نه یک مزاحمت. این یعنی تغییر در وابستگی‌ها باید به عنوان یک commit که توسط شخصی بازبینی شده است اعمال شود، نه به عنوان یک اثر جانبی از یک استقرار در ساعت 02:00 بامداد.

هش یکپارچگی در هر بار دریافت (fetch) بررسی می‌شود. اگر بایت‌های یک tarball با هش ثبت‌شده مطابقت نداشته باشد، نصب با خطای code EINTEGRITY متوقف می‌شود و فایل استخراج نمی‌شود. در مورد مزیت این کار دقیق باشید: این کار ثابت می‌کند فایلی که دریافت کرده‌اید همان فایلی است که در lockfile پین شده است؛ این همان تضمینی است که تأیید دانلودها با checksum به شما می‌دهد و محدودیت‌های مشابهی نیز دارد. این موضوع هیچ اطلاعاتی درباره اینکه آیا نسخه پین‌شده در زمان انتشار مخرب بوده است یا خیر، ارائه نمی‌دهد.

یک نکته درباره --omit=dev: این بسته‌ها همچنان resolve شده و در lockfile نوشته می‌شوند. فقط روی دیسک قرار نمی‌گیرند. بسته‌های کمتر روی دیسک به معنای اسکریپت‌های نصب کمتر و کد کمتر در زمان اجرا (runtime) است، بنابراین انجام آن ارزشمند است. این کار وابستگی را از درخت پروژه شما حذف نمی‌کند.

اسکریپت‌های نصب را به چشم کد ببینید و یاد بگیرید چگونه آن‌ها را رد کنید

شما می‌توانید اسکریپت‌های نصب را غیرفعال کنید. این تنظیمات را در .npmrc پروژه قرار دهید و آن را در کنار lockfile کامیت کنید:

ignore-scripts=true
save-exact=true

ignore-scripts=true مانع از اجرای اسکریپت‌هایی می‌شود که در dependencies تعریف شده‌اند. save-exact=true باعث می‌شود npm install some-lib به جای ^1.4.2، مقدار 1.4.2 را در package.json بنویسد؛ بنابراین یک بازهٔ resolving هرگز به‌طور تصادفی وارد manifest شما نمی‌شود.

این کار باعث بروز اختلال در عملکرد می‌شود و پیش از فعال‌سازی، باید بدانید چگونه با آن برخورد کنید. بسته‌هایی که یک native addon را کامپایل می‌کنند یا یک binary از پیش ساخته‌شده را دانلود می‌کنند، این کار را در یک اسکریپت نصب انجام می‌دهند. با غیرفعال بودن اسکریپت‌ها، عملیات نصب با موفقیت انجام می‌شود اما خطا بعداً در زمان اجرا (runtime) ظاهر می‌شود؛ به این صورت که ماژول نمی‌تواند فایل binding خود را بارگذاری کند. راه حل، استفاده از یک allowlist است:

npm ci --ignore-scripts
npm rebuild better-sqlite3 --ignore-scripts=false

npm rebuild <package> اسکریپت‌های build را فقط برای همان یک بسته اجرا می‌کند. مقدار --ignore-scripts=false اختیاری نیست: npm rebuild به ignore-scripts=true که به‌تازگی در .npmrc کامیت کرده‌اید پایبند است و بدون این override، فقط باینری‌های بسته را لینک می‌کند و هیچ‌یک از اسکریپت‌های آن را اجرا نمی‌کند. اکنون شما به‌جای اعطای مجوز اجرای کلی به صدها غریبه که هرگز ملاقات نخواهید کرد، برای هر بسته به‌صورت جداگانه تصمیم گرفته‌اید.

اگر از npm 12 استفاده می‌کنید، این allowlist به‌صورت داخلی وجود دارد. npm approve-scripts better-sqlite3 تأییدیه را در فیلد allowScripts از package.json ثبت می‌کند، اسکریپت‌های تأییدنشدهٔ dependency با نمایش یک هشدار نادیده گرفته می‌شوند و npm rebuild نیز همین لیست را بررسی می‌کند؛ بنابراین در npm 12، عملیات rebuild فوق نیز به همان تأییدیه نیاز دارد. یک ignore-scripts=true کامیت‌شده، سیاست allowScripts را به‌طور کامل نادیده می‌گیرد (override می‌کند).

برای مشاهدهٔ وسعت این دسترسی در حال حاضر، از npm بپرسید:

npm query ":attr(scripts, [postinstall])"

این دستور تمام بسته‌های موجود در درخت نصب‌شده که دارای اسکریپت postinstall هستند را چاپ می‌کند. در یک برنامهٔ معمولی، این لیست کوتاه‌تر از آن چیزی است که تصور می‌کنید، و دقیقاً همین موضوع باعث می‌شود استفاده از allowlist عملی باشد.

جداسازی فرایند ساخت از فرایند ارائه ترافیک

کاربر deploy نیاز به نوشتن در node_modules دارد، اما فرایندی که به درخواست‌های HTTP پاسخ می‌دهد، خیر. اگر این دو یک حساب کاربری باشند، کدی که در حین نصب اجرا می‌شود می‌تواند کدی که به کاربران شما سرویس می‌دهد را بازنویسی کند و کدی که در زمان اجرا (runtime) فعال است نیز می‌تواند همین کار را انجام دهد.

آن‌ها را جدا کنید. با یک کاربر بسازید، با کاربر دیگری سرویس‌دهی کنید و دایرکتوری سرویس‌دهی را برای حساب کاربریِ سرویس‌دهنده، فقط‌خواندنی (read-only) کنید:

sudo useradd --system --home-dir /srv/nodeapp --shell /usr/sbin/nologin nodeapp
sudo chown -R deploy:nodeapp /srv/nodeapp
sudo chmod -R o-rwx /srv/nodeapp

سپس از systemd برای اعمال این محدودیت استفاده کنید. فایل /etc/systemd/system/nodeapp.service را بنویسید:

[Unit]
Description=Node application
After=network-online.target

[Service]
User=nodeapp
Group=nodeapp
WorkingDirectory=/srv/nodeapp/current
EnvironmentFile=/etc/nodeapp/env
ExecStart=/usr/bin/node server.js
Restart=on-failure

NoNewPrivileges=yes
ProtectSystem=strict
ProtectHome=yes
PrivateTmp=yes
ReadWritePaths=/srv/nodeapp/shared
NoExecPaths=/srv/nodeapp/shared
RestrictAddressFamilies=AF_INET AF_INET6 AF_UNIX

[Install]
WantedBy=multi-user.target

گزینه ProtectSystem=strict کل سیستم فایل را برای این سرویس به حالت فقط‌خواندنی درمی‌آورد، به‌جز /dev، /proc، /sys و هر آنچه در ReadWritePaths لیست می‌کنید. بنابراین، تلاش برنامه برای نوشتن در node_modules با خطای EROFS: read-only file system مواجه می‌شود که می‌توانید در عرض یک دقیقه آن را در لاگ‌های خود بازتولید کنید. گزینه NoExecPaths دایرکتوری قابل‌نوشتنِ آپلود را پوشش می‌دهد: سرویس می‌تواند در آنجا فایل بنویسد، اما هسته (kernel) از اجرای آن‌ها جلوگیری می‌کند. این گزینه به systemd نسخه 248 یا جدیدتر نیاز دارد و Ubuntu 24.04 با نسخه 255 عرضه می‌شود.

دو تله در این فایل unit وجود دارد. اول، MemoryDenyWriteExecute=yes را اضافه نکنید. این گزینه در اکثر لیست‌های امن‌سازی (hardening) systemd دیده می‌شود و باعث می‌شود Node اجرا نشود، زیرا V8 کدهای JavaScript را در زمان اجرا به کد ماشین کامپایل می‌کند و به صفحاتی نیاز دارد که هم قابل‌نوشتن و هم قابل‌اجرا باشند. دوم، مسیر ExecStart را از command -v node بردارید. اگر Node با یک مدیر نسخه (version manager) نصب شده باشد، در دایرکتوری خانگی کاربر deploy قرار دارد؛ در نتیجه ProtectHome=yes آن دایرکتوری را از دید سرویس مخفی می‌کند و unit بلافاصله با خطای status=203/EXEC و یک خط لاگ مبنی بر اینکه فایل اجرایی پیدا نشد، شکست می‌خورد.

به‌جای اعتماد به فایل، نتیجه را بررسی کنید:

sudo systemctl daemon-reload
sudo systemctl enable --now nodeapp
sudo systemd-analyze security nodeapp.service
sudo -u nodeapp touch /srv/nodeapp/current/probe

دستور systemd-analyze security تمام تنظیمات امن‌سازی را به همراه وضعیت آن‌ها لیست می‌کند تا ببینید کدام‌یک هنوز روی مقدار پیش‌فرض هستند. دستور touch باید با خطای Permission denied مواجه شود، زیرا nodeapp مالک هیچ فایلی در current نیست. اگر دستور با موفقیت اجرا شد، مالکیت فایل‌های شما اشتباه است و تنظیمات systemd به‌طور بی‌صدا در حال پوشش دادن این نقص هستند.

یک نکته در مورد EnvironmentFile: systemd این فایل را پیش از تغییر سطح دسترسی به User=nodeapp با کاربر root می‌خواند، بنابراین آن فایل می‌تواند با مالکیت root:root و سطح دسترسی 600 باشد. برنامه همچنان متغیرها را دریافت می‌کند. هر کسی که دسترسی shell با کاربر nodeapp داشته باشد، همچنان می‌تواند آن‌ها را از /proc/<pid>/environ بخواند؛ بنابراین این روش از secret در حالت ذخیره‌شده محافظت می‌کند، نه از فرایند در حال اجرا.

اعتبارنامه‌های استقرار را از محیط build دور نگه دارید

اسکریپت‌های نصب، محیط (environment) را به ارث می‌برند. همین یک واقعیت باید تعیین‌کننده محل انجام build باشد.

قوی‌ترین روش این است که build را در جایی غیر از سرور production انجام دهید و دایرکتوری نهایی را منتقل کنید. در این حالت، ماشین build فقط یک توکن registry با دسترسی read-only دارد و هیچ چیز دیگری در آن نیست. نه SSH deploy key، نه cloud access key، نه رمز عبور دیتابیس و نه login مربوط به container registry.

npm token create --name=build-readonly --packages-and-scopes-permission=read-only --packages-all --expires=30

یک توکن read-only می‌تواند بسته‌ها را دریافت کند اما امکان انتشار ندارد. npm در تاریخ 9 دسامبر 2025 تمام توکن‌های کلاسیک را ابطال کرد، بنابراین این یک توکن دسترسی جزئی (granular) است و flag مجوز همان چیزی است که آن را read-only می‌کند: نسخه فعلی npm همچنان flag قدیمی --read-only را می‌پذیرد، اما npm token create آن را به registry ارسال نمی‌کند. اگر توکن از محیط build سرقت شود، خسارت محدود به دسترسی خواندن بسته‌های تحت پوشش آن توکن خواهد بود.

اگر مجبور هستید build را روی سرور انجام دهید، آن را با کاربر deploy و با محیطی که عمداً محدود شده است اجرا کنید و اسرار runtime را در /etc/nodeapp/env نگه دارید که deploy قادر به خواندن آن نیست. همین استدلال برای اتوماسیون build که خودتان میزبانی می‌کنید نیز صدق می‌کند: یک runner خودمیزبان GitHub Actions توکن‌ها را در اختیار دارد و در هر job، کدهای منتشرشده دلخواهی را اجرا می‌کند که آن را به باارزش‌ترین ماشین در یک استقرار کوچک تبدیل می‌کند. هر برنامه‌ای که شما ننوشته‌اید و کل محیط شما را دریافت می‌کند، در همین دسته قرار می‌گیرد؛ به همین دلیل است که دور نگه داشتن اسرار از محیط یک عامل هوش مصنوعی، همان مشکل با یک برنامه متفاوت در میان است.

پین کردن یا vendor کردن آنچه نمی‌توانید بازبینی کنید

یک dependency پین‌شده، وابستگی‌ای است که نسخهٔ آن بدون ثبت یک commit تغییر نمی‌کند. فایل lockfile که commit شده است، همین کار را برای کل درخت وابستگی‌ها انجام می‌دهد. دو مورد وجود دارد که به اقدامات بیشتری نیاز دارند.

مورد اول، وابستگی‌های غیرمستقیم (transitive) هستند. شما کنترلی بر آنچه وابستگی‌هایتان به آن وابسته هستند ندارید. دستور overrides در package.json، یک نسخهٔ خاص را در هر جای درخت وابستگی‌ها اعمال می‌کند:

{
  "overrides": {
    "some-transitive-lib": "1.4.2"
  }
}

پس از افزودن آن، یک بار دستور npm install را اجرا کنید تا نتیجه در lockfile ثبت شود، سپس هر دو فایل را commit کنید.

مورد دوم، بسته‌ای است که نمی‌توانید آن را بازبینی کنید و نمی‌توانید حذفش کنید. آن را vendor کنید. دستور npm pack دقیقاً همان tarballای را دانلود می‌کند که registry ارائه می‌دهد، و یک dependency از نوع file:، آن را از روی کپی محلی شما نصب می‌کند:

npm pack some-lib@1.4.2
mkdir -p vendor && mv some-lib-1.4.2.tgz vendor/
{
  "dependencies": {
    "some-lib": "file:vendor/some-lib-1.4.2.tgz"
  }
}

این tarball اکنون در مخزن شما قرار دارد و بدون اطلاع شما تغییر نمی‌کند. شما همچنین مسئولیت به‌روزرسانی‌های آن را برای همیشه بر عهده گرفته‌اید، بنابراین از این روش فقط برای بسته‌های کوچک و رهاشده‌ای که مجبور به استفاده از آن‌ها هستید استفاده کنید، نه برای فریم‌ورک وب خود.

یک دورهٔ انتظار (cooling-off period) نیز وجود دارد که هزینه‌ای ندارد:

npm install --before=2026-08-01

گزینهٔ before درخت وابستگی‌ها را تنها با استفاده از نسخه‌هایی بازسازی می‌کند که در آن تاریخ یا پیش از آن منتشر شده‌اند. هنگام تازه‌سازی وابستگی‌ها، این تاریخ را یک یا دو هفته به عقب ببرید تا از بازهٔ زمانی که یک نسخهٔ مخرب منتشر شده و هنوز گزارش نشده است، عبور کنید. این یک ابزار کلی است، زیرا جلوی اصلاحات امنیتی واقعی را نیز می‌گیرد. از آن برای حل بازه‌های نسخه‌ها استفاده کنید، تغییرات را بخوانید و سپس lockfile را commit کنید. نسخه‌های اخیر npm گزینهٔ min-release-age را نیز می‌پذیرند که یک بازهٔ زمانی متحرک بر حسب روز است (min-release-age=7 در .npmrc) و همان کار را بدون نیاز به تعیین تاریخ ثابت انجام می‌دهد. همین رویکرد را باید برای ابزارهای خط فرمانی که از npm نصب می‌کنید (به جای وابستگی به آن‌ها) نیز در نظر بگیرید؛ جایی که یک فراخوانی بدون پینِ npx، هر نسخه‌ای را که همان روز منتشر شده دریافت می‌کند و پین کردن نسخهٔ دقیق dsh همان چیزی است که باعث می‌شود دو ماشین، کد یکسانی را اجرا کنند.

چگونه بفهمم دقیقاً چه نسخه‌ای را منتشر کرده‌ام؟

فایل lockfile در git نشان می‌دهد که چه چیزی باید نصب می‌شد. دیسک نشان می‌دهد که چه چیزی نصب شده است. تنها مورد دوم سندیت دارد.

npm ls some-lib
node -e "console.log(require('./node_modules/some-lib/package.json').version)"

دستور npm ls فایل node_modules را می‌خواند، بنابراین آنچه را که به‌صورت فیزیکی موجود است گزارش می‌دهد، نه آنچه را که lockfile قصد داشته است. خط node -e مانیفست نصب‌شده را بر اساس مسیر می‌خواند؛ این کار حتی برای بسته‌هایی که فیلد exports آن‌ها واردات subpath را مسدود می‌کند نیز کارساز است و یک نسخه را بدون رسم ساختار درختی چاپ می‌کند.

برای بخش دیگر مقایسه، git را بخوانید:

git log --oneline -- package-lock.json
git show <commit>:package-lock.json | grep -A3 '"node_modules/some-lib"'

با قرار دادن commit در طرح deploy، ارتباط بین این دو را دائمی کنید. نسخه را در /srv/nodeapp/releases/<short commit sha> منتشر کنید و با یک symlink، فایل /srv/nodeapp/current را به آن اشاره دهید. پاسخ به پرسش «در حال حاضر چه چیزی در حال اجراست» تبدیل به readlink /srv/nodeapp/current می‌شود و این اطلاعات در ساعت 03:00 برای کسی که عملیات deploy را انجام نداده است نیز در دسترس خواهد بود.

در نهایت، بررسی کنید که registry چه چیزی را تأیید می‌کند:

npm audit signatures

این دستور امضاهای registry را روی بسته‌های موجود در درخت نصب‌شدهٔ شما بررسی می‌کند و گواهی‌های اصالت (provenance attestations) را برای بسته‌هایی که دارای آن هستند، تأیید می‌نماید. Provenance یک tarball منتشرشده را به build سیستم continuous integration (CI) عمومی که آن را تولید کرده است، پیوند می‌دهد. بنابراین، یک گواهی تأییدشده به این معناست که می‌توانید کد را به یک commit مشخص ردیابی کنید، نه به یک لپ‌تاپ ناشناس. پوشش این قابلیت همگانی نیست، بنابراین نبود گواهی را به معنای «اطلاعاتی در دسترس نیست» تلقی کنید، نه به معنای «بسته مخرب».

پس از رسیدن یک نسخه مخرب به سرور چه باید کرد

از آنچه اجرا شده و با چه کاربری، به سمت بیرون حرکت کنید.

اگر کد در حین نصب اجرا شده است، فرض کنید هر فایلی که برای کاربر build قابل خواندن بوده، لو رفته است. توکن رجیستری، کلیدهای SSH در آن دایرکتوری home، اعتبارنامه‌های ابری و هر secret دیگری که در آن shell صادر (export) شده است را تغییر دهید (rotate). تغییر دادن تنها پاسخ صادقانه است، زیرا نمی‌توانید ثابت کنید که فایلی خوانده نشده است.

اگر کد در زمان اجرا (runtime) تحت یک حساب کاربری محدود (service account) اجرا شده باشد، دامنه دسترسی بسیار کوچک‌تر است: متغیرهای محیطی خود برنامه و هر آنچه که دسترسی شبکه آن می‌تواند به آن برسد. این تمام استدلال برای اجرای سرویس‌ها با کاربران بدون دسترسی ویژه روی یک VPS است. این کار از نفوذ جلوگیری نمی‌کند، بلکه تعیین می‌کند که نفوذ چقدر از ماشین را درگیر می‌کند و آیا پس از راه‌اندازی مجدد باقی می‌ماند یا خیر.

سپس به جای پاکسازی، سیستم را دوباره بسازید (rebuild). فایل node_modules را حذف کنید، بسته آسیب‌دیده را در نسخه پایین‌تر از نسخه مخرب در package.json پین کنید، دستور npm install را یک بار برای به‌روزرسانی lockfile اجرا کنید، آن را commit کرده و با npm ci مستقر (deploy) کنید. درخت فایل‌ها را در محل تعمیر نکنید. شما نمی‌توانید تمام مواردی که یک اسکریپت نصب تغییر داده است را فهرست کنید.

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

مواردی که هیچ‌کدام از این روش‌ها حل نمی‌کنند

یک lockfile امنیت یک وابستگی (dependency) را تضمین نمی‌کند. این فایل، لحظه‌ای را که شما آن وابستگی را پذیرفته‌اید، به یک تصمیم تاریخ‌دار و بازبینی‌شده تبدیل می‌کند، نه یک اثر جانبی از فرآیند deploy. تمام روش‌های ذکرشده در بالا، همین تبدیل را انجام می‌دهند: تبدیل «اتفاق» به «انتخاب».

npm audit در اینجا یک دفاع محسوب نمی‌شود. این ابزار درخت وابستگی‌های شما را با پایگاه داده‌ای از آسیب‌پذیری‌های گزارش‌شده مقایسه می‌کند؛ بنابراین مشکلاتی را پیدا می‌کند که قبلاً منتشر و نام‌گذاری شده‌اند. یک حمله به زنجیره تأمین (supply-chain attack) در تمام طول عمر مفید خود، بدون نام باقی می‌ماند. برای یافتن باگ‌های قدیمی و شناخته‌شده از npm audit استفاده کنید، اما از آن انتظار نداشته باشید که درباره نسخه‌ای که چهار ساعت پیش منتشر شده است، اطلاعاتی به شما بدهد.

کاهش تعداد وابستگی‌ها بیش از هر ابزار دیگری در این راهنما به شما کمک می‌کند، و این کم‌طرفدارترین توصیه‌ای است که کسی ارائه می‌دهد. هر بسته‌ای که اضافه نکنید، یک ناشر کمتر است که می‌تواند به جای شما فیشینگ شود، و یک اسکریپت نصب کمتر است که هرگز با دسترسی کاربر deploy شما اجرا نخواهد شد.

هیچ‌کدام از این موارد مختص npm نیست. همین چهار الگو برای PyPI، RubyGems، ایمیج‌های کانتینر و مدیر بسته توزیع سیستم‌عامل شما نیز صدق می‌کند. npm جایی است که این مشکلات بیشتر نمایان می‌شوند، زیرا درخت‌های وابستگی در آن عمیق‌تر هستند و اکثر سرورهای npm هنوز اسکریپت‌های نصب را به‌صورت پیش‌فرض اجرا می‌کنند. هر چیزی که ابزاری را که در حال حاضر استفاده می‌کنید گسترش دهد، همان مشکل را به ارث می‌برد؛ به همین دلیل است که بررسی دسترسی‌های یک پلاگین dsh پیش از نصب آن، همان تمرینی است که برای خواندن یک اسکریپت postinstall انجام می‌دهید، با این تفاوت که در اینجا مجوزهای agent شما جایگزین مجوزهای کاربر deploy شما شده است. اینکه چه بخشی از ماشین اطراف شما برای دفاع در اختیار شماست، به محل اجرای آن بستگی دارد، که بخشی از پرسش گسترده‌تر درباره امنیت میزبانی VPS است.

FAQ

آیا npm ci من را در برابر یک بسته npm آلوده محافظت می‌کند؟

این ابزار شما را در برابر تغییر نسخه بدون اطلاع شما محافظت می‌کند. npm ci دقیقاً همان چیزی را نصب می‌کند که package-lock.json ثبت کرده است، هر tarball را با هش یکپارچگی sha512 آن بررسی می‌کند و اگر package.json و فایل lockfile با هم مغایرت داشته باشند، به‌جای تلاش برای حل تفاوت، با خطا متوقف می‌شود. این ابزار هیچ تضمینی در مورد ایمن بودن نسخه پین‌شده ارائه نمی‌دهد. اگر فایل lockfile را که حاوی یک نسخه مخرب است commit کنید، npm ci آن نسخه را با دقت در هر سروری که دارید، هر بار نصب خواهد کرد.

آیا باید ignore-scripts=true را برای همه چیز تنظیم کنم؟

آن را تنظیم کنید و سپس لیست سفید (allowlist) بسازید. ignore-scripts=true در فایل .npmrc پروژه، اجرای اسکریپت‌های نصب وابستگی‌ها را متوقف می‌کند؛ این کار مستقیم‌ترین مسیر از یک بسته مخرب به سمت اعتبارنامه‌های کاربر deploy شما را مسدود می‌کند. بسته‌هایی که یک افزونه native را کامپایل می‌کنند یا یک باینری از پیش ساخته‌شده را دریافت می‌کنند، واقعاً به اسکریپت‌های خود نیاز دارند و با غیرفعال بودن اسکریپت‌ها، در زمان اجرا (runtime) به‌دلیل نبود فایل binding با خطا مواجه می‌شوند، نه در زمان نصب. دستور npm ci --ignore-scripts را اجرا کنید و سپس برای تعداد کمی از بسته‌هایی که تصمیم گرفته‌اید به آن‌ها اعتماد کنید، از npm rebuild <package> --ignore-scripts=false استفاده کنید، زیرا npm rebuild در غیر این صورت به تنظیمات .npmrc احترام می‌گذارد و هیچ‌چیز را اجرا نمی‌کند. دستور npm query ":attr(scripts, [postinstall])" نشان می‌دهد که واقعاً چند مورد از این بسته‌ها وجود دارند.

چگونه بفهمم سرور من در واقع کدام نسخه از یک بسته را نصب کرده است؟

به جای فایل lockfile، دیسک را بررسی کنید. npm ls <package> گزارش می‌دهد که چه چیزی در node_modules موجود است و node -e "console.log(require('./node_modules/<package>/package.json').version)" فقط رشته نسخه را چاپ می‌کند. فایل lockfile در git به سؤال متفاوتی پاسخ می‌دهد، یعنی اینکه چه چیزی باید نصب می‌شد، و مقایسه این دو، هدف اصلی است. استقرار در دایرکتوری‌ای که با نام commit گیت نام‌گذاری شده است، باعث می‌شود هر دو پاسخ ماه‌ها بعد، زمانی که به آن‌ها نیاز دارید، در دسترس باقی بمانند.

آیا npm audit حملات زنجیره تأمین را شناسایی می‌کند؟

خیر. npm audit درخت وابستگی‌های شما را با پایگاه داده‌ای از آسیب‌پذیری‌های گزارش‌شده مطابقت می‌دهد، بنابراین فقط مشکلاتی را پیدا می‌کند که قبلاً منتشر شده و دارای شناسه هستند. یک نسخه مخرب در طول ساعاتی یا روزهایی که نصب آن اهمیت دارد، گزارش‌نشده باقی می‌ماند. npm audit signatures دستور مفیدتری است: این دستور امضاهای registry را در سراسر درخت نصب‌شده شما تأیید می‌کند و گواهی‌های اصالت (provenance attestations) را در مواردی که ناشر آن‌ها را تولید کرده است بررسی می‌کند؛ این کار به شما می‌گوید که یک tarball از یک build عمومی آمده است، نه از یک ماشین ناشناس.

چرا اگر حمله در زمان نصب رخ می‌دهد، اجرای برنامه با یک کاربر بدون دسترسی (unprivileged) اهمیت دارد؟

زیرا این دو شکست، دامنه نفوذ متفاوتی دارند و شما در حال دفاع در برابر هر دو هستید. کد زمان نصب با دسترسی کاربر deploy اجرا می‌شود و می‌تواند کلیدهای SSH، توکن‌های registry و اعتبارنامه‌های ابری آن کاربر را بخواند. کد زمان اجرا (runtime) با دسترسی حساب کاربری سرویس اجرا می‌شود و با استفاده از User=nodeapp، ProtectSystem=strict و نبود اعتبارنامه روی دیسک، دامنه نفوذ آن به محیط خودِ برنامه و پایگاه داده‌اش محدود می‌شود. جداسازی این حساب‌ها همچنین به این معنی است که فرآیند پاسخ‌دهی به ترافیک نمی‌تواند node_modules را بازنویسی کند، بنابراین یک نفوذ در زمان اجرا با راه‌اندازی مجدد بعدی از بین می‌رود و دائمی نمی‌شود.

آیا این مقاله مفید بود؟