npm 供應鏈攻擊近況與開發者防護:keyv 事件、9 月新惡意套件,暫存發布、冷卻期、雙因素驗證與 CI 設定怎麼用(2026)
機誌編輯部 · 發布 2026年11月4日 · 約 9 分鐘

先說結論:2026 年 npm 供應鏈攻擊的重點已經從「假冒套件名稱」變成「搶走真維護者的帳號或發布權限」,所以光看套件名稱對不對、有沒有來源證明都不夠。 對台灣的軟體開發者與 Node.js、前端工具使用者來說,比較實際的做法是三層一起做:用鎖定檔加 npm ci 固定版本、讓新版本先放幾天再裝(冷卻期)、把 CI 裡的憑證與安裝權限收緊;如果你自己也發布套件,再加上 2FA、trusted publishing 與暫存發布。這篇依官方文件與媒體報導整理,只談防禦面,不保證完全避免被攻擊。
警語: 本文是一般性的資安資訊整理,以 npm、GitHub 的官方說明為準,不保證完全避免供應鏈攻擊。工具行為與版本要求會變動,請在你自己的環境確認。如果你懷疑自己安裝過受影響的版本,請把該機器與建置環境視為可能已被入侵,並依你所屬組織的資安流程處理;本文不提供惡意程式的利用細節。
資料來源與限制(查證日期:2026-11-04): 本文實際讀過的頁面有:iThome 報導keyv 事件(2026-08-05)、微軟分析 ChainDrop(08-06)、ChainDrop 與 Shai-Hulud 的關係(08-06)、AsyncAPI 事件(08-03)、限制可免除 2FA 的權杖(08-03)、暫存發布機制(05-22)、僅限暫存發布權杖(09-21)、惡意套件改於執行時期發動攻擊(09-21)、GitHub 套件防火牆(10-21)、Axios 事件(04-01)、NPM 與 RubyGems 仿冒套件(08-20);官方文件有 npm 暫存發布、npm 設定文件(v11 版)、npm ci、雙因素驗證、trusted publishing,以及 GitHub changelog 的暫存發布與安裝來源控制(頁面內文標 2026-05-22,網址日期為 05-29)與 npm v12 即將到來的變更(2026-06-09);其他有新加坡 CSA 公告 AD-2026-009、Cloudsmith 部落格、InfoQ 的 npm 12 報導(2026-08-14)與 Socket 部落格(2026-02-26)。限制: 我們沒有讀到 Checkmarx、StepSecurity 等資安公司的原始報告,也沒讀到 GitHub 宣布 npm 12 上線當天的 changelog;BleepingComputer 與 The Hacker News 無法開啟,只看過搜尋摘要,因此不當來源引用。本文沒有實機測試,所有設定都不是我們自己驗證的。
發生什麼事:2026 年幾起事件
以下依 iThome 報導與官方公告整理,每列都標明依據;套件與版本數字見表後的說明。
| 時間 | 事件或動作 | 依據 |
|---|---|---|
| 3 月 30 日 | Axios(依報導每週下載量約 1 億次)被發布兩個有問題的版本,報導指維護者的 npm 憑證遭挾持,且繞過了 GitHub Actions 流程 | iThome(04-01) |
| 5 月 22 日 | npm 暫存發布(staged publishing)正式上線,需 npm CLI 11.15.0 以上 | GitHub changelog、iThome |
| 6 月 9 日 | GitHub 預告 npm v12:依賴套件的安裝指令碼預設關閉 | GitHub changelog |
| 7 月 | npm v12 推出(實際日期我們沒讀到官方原文);7 月中旬 AsyncAPI 事件,報導指攻擊者透過配置不當的 GitHub Actions 取得 npm 發布權杖 | iThome(09-21、08-03) |
| 8 月 3 日 | npm 限制可免除 2FA 的精細度存取權杖執行帳號、組織與套件管理操作;預計 2027 年 1 月取消這類權杖的直接發布能力 | iThome(08-03) |
| 8 月 4 日 | keyv 事件:維護者的 GitHub 帳號被入侵,數小時內擴散到數百個套件 | iThome(08-05)、Cloudsmith |
| 8 月 16 日 | 約 40 個 npm 仿冒套件(另有 16 個 RubyGems)在約 8 分鐘內集中發布,後續陸續被移除 | iThome(08-20,引用 OpenSourceMalware) |
| 9 月 17 日 | Checkmarx 揭露 indexed-btree 與相關 9 個套件,惡意碼藏在套件功能內而非安裝指令碼 | iThome(09-21) |
| 9 月 21 日 | npm 新增「僅限暫存發布」權杖權限 | iThome(09-21) |
| 10 月 21 日 | GitHub 推出 npm 套件防火牆公開預覽版(限 GitHub Enterprise Cloud 客戶) | iThome(10-21) |
keyv 事件:數字各報導不一
依 iThome 引用 StepSecurity 的說法:keyv 維護者的 GitHub 帳號被入侵後,攻擊者先在 3 個專案植入惡意檔案,觸發專案原有的 GitHub Actions 自動建置與發布流程,發布 11 個受污染套件;惡意程式再取得其他開發者的 npm 發布憑證,不到 4 小時擴散到 444 個套件、2,212 個惡意版本、超過 14 個組織。keyv 與 flat-cache 等套件每週下載量各接近或超過 1.5 億次,並被 ESLint 等常用工具間接使用(以上均依 iThome 報導)。
數字不一致:
- iThome:444 個套件、2,212 個惡意版本(來源為 StepSecurity,僅此一個原始出處)。
- Cloudsmith(2026-08-04 部落格,標註仍在發展):約 444 個套件、約 2,236 個惡意版本。
- 新加坡 CSA(2026-08-06):「超過 1,300 個惡意版本」,並稱攻擊仍在進行。
這些報導的發布時間不同,Cloudsmith 與 CSA 都明講事件仍在進行,數字可能是不同時間點的快照;我們沒有辦法判斷哪個是定論,所以本文不挑一個當準。後續多家資安公司指出,這次的 ChainDrop 與 2025 年下半年的 Shai-Hulud 屬同一系列(依 iThome 08-06 報導)。
兩個值得開發者記住的重點,都來自報導:
- 來源證明不等於安全。 首批惡意版本是透過專案既有的 GitHub Actions 與 npm OIDC trusted publishing 發布,所以仍帶有效的 SLSA 來源證明(iThome)。
- CI 與開發機是目標。 依微軟的分析(iThome 08-06),惡意程式會判斷自己跑在開發工作站還是 CI/CD,CI 裡會找工作流程機密、runner 憑證與 OIDC 發布權限,再用來感染其他套件。
9 月新一波:不靠安裝指令碼
依 iThome 09-21 報導,Checkmarx 於 9 月 17 日揭露 indexed-btree 等共 10 個惡意 npm 套件,累計獲得數百萬次下載(僅 iThome 這一個數字,我們沒讀到原始報告)。套件偽裝成熱門的 sorted-btree 函式庫,惡意碼藏在函式庫的一般功能中,而不是安裝指令碼,因此避開了 npm v12 預設關閉安裝指令碼的防護;Checkmarx 的結論(依 iThome)是只擋安裝指令碼不夠,還需要分析套件執行期的行為。這些套件均已被移除,建議安裝過的人更換所有憑證並用備份重建開發環境。
跟我有什麼關係:誰會受影響
- 直接依賴者: package.json 裡直接寫了受影響的套件,且在惡意版本上架的時間窗內執行過沒有鎖版本的
npm install。 - 間接依賴者: 你沒有直接裝 keyv,但前端工具鏈(例如 ESLint 這類工具)依賴了 flat-cache 等套件。報導寫這些套件被常用開發工具間接採用。
- CI/CD: 每次建置都重新解析依賴、又握有 npm、GitHub 或雲端憑證的流水線,是惡意程式的主要目標。
- 套件維護者: 帳號或 CI 權限被盜,會讓你的套件變成下一個擴散點。
要確認自己有沒有裝到,請在 package-lock.json 或 pnpm-lock.yaml、yarn.lock 與 node_modules 裡,用完整套件名稱與版本比對官方與資安單位的最新清單。CSA 公告列出的受影響版本包含 keyv 6.0.0、flat-cache 6.1.24、file-entry-cache 11.1.6、cacheable-request 13.0.20、cache-manager 7.2.10、@cacheable/utils 2.5.1、ecto 5.0.1 等,但 CSA 明講這只是「notable」套件,完整清單請看公告連結的 Socket 清單;Cloudsmith 也提醒清單仍在增加,要重複檢查。
現在該做什麼
以下只寫我們在官方文件或 GitHub 公告實際讀到的設定。版本要求請以 npm -v 與官方文件為準。
一、所有人:安裝端
-
提交鎖定檔,CI 用
npm ci。 依 npm 官方文件,npm ci需要package-lock.json或npm-shrinkwrap.json;若鎖定檔與 package.json 不一致,會直接報錯而不是更新鎖定檔,也永遠不會寫入 package.json 或鎖定檔,並且會先刪除既有的 node_modules。# CI 與正式建置:照鎖定檔安裝,不一致就失敗 npm ci -
設定發布冷卻期
min-release-age。 npm 設定文件(v11 版)寫明:設定後,只會安裝「發布超過指定天數」的版本,預設為null(不啟用)。下面的 7 天只是示範值,iThome 報導 StepSecurity 建議企業設 3 至 7 天,但這不是官方規定。# .npmrc(專案根目錄,7 是示範值,請依自己的風險取捨) min-release-age=7官方文件頁面沒註明這個選項從哪個版本開始有;InfoQ 報導寫是 npm 11.10.0。Socket 2026-02 的報導指出 npm 初版沒有例外排除機制,現在是否已有,資料不足,請查你所用版本的文件。代價是新版與安全修補會晚幾天才裝得到,遇到緊急修補要有手動繞過的流程。
-
管好安裝指令碼。 依 GitHub 2026-06-09 公告,npm v12 預設不執行依賴套件的
preinstall、install、postinstall(含隱含的 node-gyp 建置),專案要明確核准;在 npm 11.16.0 以上會先顯示警告。公告列出的指令如下,核准的結果會寫進 package.json,請一起提交。# 查看哪些套件有安裝指令碼、目前被擋住 npm approve-scripts --allow-scripts-pending # 允許你信任的套件 npm approve-scripts # 阻擋其餘套件 npm deny-scriptsnpm 設定文件另有
ignore-scripts(預設false,設為 true 則不執行 package.json 的腳本)與strict-allow-scripts(設為 true,沒被允許的安裝指令碼會讓安裝失敗而不是只警告)。但請記得 9 月 indexed-btree 事件:惡意碼在執行時才發動,安裝指令碼被擋住也沒用,所以這只是其中一層。 -
收緊非 registry 來源。 GitHub changelog 說明
--allow-git、--allow-remote、--allow-file、--allow-directory可控制npm install能否從 git、遠端網址、本機路徑解析依賴,各自可設為all或none;其中--allow-file、--allow-remote、--allow-directory在 npm 11.15.0 加入。2026-06-09 公告寫 v12 起--allow-git與--allow-remote預設為none。 -
新版本先別急著升級。 對沒有自動化封鎖機制的小團隊,最低成本的做法是依賴更新走 PR、人工看一下變更,而不是 CI 每次抓最新。
二、有 npm 帳號、會發布套件的人
-
帳號開 2FA,並盡量用安全金鑰或 passkey。 npm 官方文件說預設的 2FA 模式是
auth-and-writes(登入授權與寫入操作,如發布、棄用、變更套件權限都要第二因素),另有範圍較小的auth-only;發布套件需要啟用 2FA,或使用設為繞過 2FA 的精細度存取權杖。官方頁面描述的是安全金鑰(Touch ID、Face ID、Windows Hello、Yubikey 等)流程;iThome 報導 StepSecurity 也建議維護者用 passkey 或實體安全金鑰。通行密鑰的概念可參考通行密鑰與雙重驗證設定。 -
能用 trusted publishing 就別留長期 token。 依官方文件,trusted publishing 透過 OIDC 從 CI 直接發布,不需要長效 npm token;支援 GitHub Actions(GitHub-hosted runner)、GitLab CI/CD(GitLab.com shared runner)、CircleCI(雲端),需要 npm CLI 11.5.1 以上與 Node.js 22.14.0 以上。注意:keyv 事件顯示帳號或 CI 被入侵時,OIDC 發布也會被濫用,所以它要搭配下一步。
-
加上暫存發布(staged publishing)。 依官方文件,需要 npm CLI 11.15.0 以上、Node.js 22.14.0 以上、對套件有發布權限、帳號已啟用 2FA。CI 把
npm publish改成npm stage publish(不需 2FA);維護者審查後,用 CLI 或 npmjs.com 的 Staged Packages 分頁核准,核准一定要 2FA。# CI:送進暫存區(原本的 npm publish 改成這行) npm stage publish # 維護者:審查並核准(核准需要 2FA) npm stage list npm stage view <stage-id> npm stage download <stage-id> npm stage approve <stage-id>GitHub changelog 建議把 trusted publishing 限制為 stage-only,這樣該工作流程裡的
npm publish會被拒絕,只接受npm stage publish。官方文件也註明npm stage list、approve等指令無法用 OIDC,必須是人。已知說法不一的地方: iThome 報導寫暫存發布不支援全新套件首次發布,但官方文件寫套件尚不存在時,首次暫存會公開發布一個0.0.0-stage佔位版本;新套件請以官方文件與自己實測為準。 -
還在用繞過 2FA 的 token 嗎? 依 iThome 報導,這類精細度存取權杖已被限制不能做帳號與套件管理操作,且 GitHub 預計 2027 年 1 月取消其直接發布能力,建議改用 OIDC trusted publishing 或暫存發布;9 月新增的「僅限暫存發布」權杖權限則給暫時無法轉換的團隊(報導強調這種權杖仍可修改發行標籤與棄用版本,外洩仍有風險)。這部分我們只讀到 iThome 的報導,沒讀到官方文件原文,請去 npm 後台確認選項名稱。
三、CI 與團隊
- CI 只給最小權限。 依 iThome 報導,StepSecurity 建議縮小 GitHub Token 權限、啟用主分支保護與強制程式碼審查;企業可在 CI/CD 限制套件安裝指令與對外連線,並監控新版本突然加入的可執行檔與安裝指令碼。AsyncAPI 事件的原因(依報導)是配置不當的 GitHub Actions,值得回頭檢查自家的 workflow。
- 有預算的組織可看 GitHub 套件防火牆。 依 iThome 10-21 報導,它在公開預覽、僅限 GitHub Enterprise Cloud,可擋已知惡意套件、檢查新版是否新增安裝指令碼或失去來源證明,並提供版本冷卻期(報導引用官方文件:預設 1 天、可設 1 至 365 天)。公開預覽期間免費,正式上市後依用量收費,費率未公布。一般個人與小團隊用不到。
- 如果已經安裝過受影響版本: CSA 與 StepSecurity(依 iThome)的建議是視為已被入侵,重建系統,並輪換可能外洩的憑證,包括 npm、GitHub、雲端、SSH 與 Kubernetes 等,再檢查雲端與原始碼環境有沒有可疑活動。
還不確定的部分
- 事件規模: 如上所述,套件與版本數字各報導不同,且當時仍在變動。
- npm v12 的實際上線日與細節: iThome 與 InfoQ 都說 7 月推出,但我們沒讀到 GitHub 宣布上線當天的原文,確切行為請看
npm -v與官方 release notes。 - min-release-age 的版本與例外機制: 官方設定頁沒寫新增版本,例外排除機制資料不足。
- 暫存發布對全新套件的支援: 報導與官方文件說法不同,見上。
- 僅限暫存發布權杖與套件防火牆的官方文件: 本文僅引用 iThome 報導。
- 9 月事件的細節: 下載量與時間點只有 iThome 一個來源,Checkmarx 原文未讀。
- 事件還在更新: 本文設定為 2026-12-02 後提醒可能過時,請以 npm 與 GitHub 官方公告為準。
用 3C 讀者的角度補一句
開發機本身往往就放著 npm token、GitHub 憑證、SSH 金鑰與雲端金鑰,一旦被偷,後果不只是一台電腦。本站其他文章也談過類似的「個資外洩之後自保」邏輯:先換掉可能外洩的憑證,再開雙重驗證,並對「看起來很合理的通知」多一道查證,可以參考酷澎個資外洩的應對步驟與3C 防詐騙指南。台灣警政署的 165 專線資料可看165 打詐儀表板與購物詐騙整理;這類事件若造成財產損失,請另外報案,本文不涵蓋。
檢查清單
- 專案有提交鎖定檔,CI 與正式建置用
npm ci,而不是npm install。 - 我用完整套件名稱與版本,比對過鎖定檔裡有沒有 keyv 事件的受影響版本,並知道清單還會增加。
- 我評估過要不要設
min-release-age,也有緊急修補的繞過流程。 - 我確認過目前的 npm 版本與安裝指令碼政策,知道
npm approve-scripts --allow-scripts-pending的結果。 - 我了解擋安裝指令碼不等於安全,9 月的惡意套件是在執行時才動作。
- 我的 npm 與 GitHub 帳號都開了 2FA,最好是安全金鑰或 passkey。
- 要發布套件的專案,已評估 trusted publishing 與
npm stage publish,並確認 npm CLI 11.15.0 以上、Node.js 22.14.0 以上。 - 還在用繞過 2FA 的 token 的專案,已排定在 2027 年 1 月前轉換。
- CI 的 GitHub Token 與雲端憑證都是最小權限,workflow 沒有可被濫用的設定。
- 若曾安裝受影響版本,我已輪換 npm、GitHub、雲端、SSH 憑證並重建環境。
參考資料
- 熱門 NPM 套件 keyv 遭植入竊密蠕蟲,至少 400 個套件受感染(iThome,2026-08-05)
- 剖析 NPM 套件 Keyv 遭供應鏈攻擊 ChainDrop,微軟揭露惡意程式完整運作流程(iThome,2026-08-06)
- NPM 套件 Keyv 供應鏈攻擊活動 ChainDrop 傳出源自於 Shai-Hulud(iThome,2026-08-06)
- 在 AsyncAPI 供應鏈攻擊事故中,使用 Miasma 框架散布惡意軟體(iThome,2026-08-03)
- NPM 限制可免除 2FA 的權杖管理權限,2027 年 1 月再取消直接發布能力(iThome,2026-08-03)
- 因應軟體供應鏈攻擊,NPM 新增套件暫存發布機制(iThome,2026-05-22)
- NPM 新增僅限暫存發布權杖(iThome,2026-09-21)
- npm 惡意套件避開 GitHub 安裝指令碼防護,改於執行時期發動攻擊(iThome,2026-09-21)
- GitHub 開放 NPM 套件防火牆(iThome,2026-10-21)
- NPM 套件 Axios 遭遇供應鏈攻擊(iThome,2026-04-01)
- NPM 與 RubyGems 出現 56 個仿冒套件(iThome,2026-08-20)
- npm 官方文件:Staged publishing
- npm 官方文件:Trusted publishing
- npm 官方文件:About two-factor authentication
- npm 官方文件:npm ci
- npm 官方文件:config
- GitHub changelog:Staged publishing and new install-time controls for npm
- GitHub changelog:Upcoming breaking changes for npm v12(2026-06-09)
- 新加坡 CSA:Ongoing npm Supply Chain Attack Affecting Keyv and Related Packages(AD-2026-009)
- Cloudsmith:keyv and cacheable npm packages compromised in active supply chain attack
- InfoQ:npm 12 released(2026-08-14)
- Socket:npm introduces minimumReleaseAge and bulk OIDC configuration(2026-02-26)
常見問題
各報導說法不一,而且事件當天數字一直在變。iThome(引用 StepSecurity)寫 444 個套件、2,212 個惡意版本;Cloudsmith 部落格寫約 444 個套件、約 2,236 個惡意版本,並註明仍在增加;新加坡 CSA 在 8 月 6 日的公告寫「超過 1,300 個惡意版本」。建議把任何單一數字當成當時的快照,自己的專案請直接比對鎖定檔。
依 npm 官方文件,暫存發布是把「發布」拆成暫存、審查、核准三步:CI 用 npm stage publish 把套件送進暫存區,維護者審查後要通過 2FA 才能核准公開。這是給套件維護者用的功能,需要 npm CLI 11.15.0 以上與 Node.js 22.14.0 以上;只是安裝套件的人不需要設定,但可以優先選擇有採用這類機制的套件。
依 GitHub 2026-06-09 的公告,npm v12 預設不再執行依賴套件的 preinstall、install、postinstall,需明確核准;iThome 9 月報導寫 npm v12 已在 7 月推出。實際行為請在你的 npm 版本上確認,並用 npm approve-scripts --allow-scripts-pending 查看待核准項目。注意 9 月的 indexed-btree 事件是把惡意碼藏在程式功能內、執行時才發動,不靠安裝指令碼。
官方 npm 設定文件只寫明:設定後只會安裝「發布超過指定天數」的版本,預設為 null(不啟用),單位是天,沒有建議天數。iThome 報導 StepSecurity 建議企業設 3 至 7 天,這是廠商建議,不是 npm 官方規定。代價是新版與安全修補會晚幾天才裝得到,請依專案風險自己取捨。
不代表。iThome 報導 StepSecurity 指出,keyv 事件的首批惡意版本是透過專案既有的 GitHub Actions 與 npm OIDC trusted publishing 發布,所以仍取得有效的 SLSA 來源證明;來源證明只記錄原始碼與建置流程,不檢測內容是否惡意。
延伸閱讀
Android 側載開發者驗證:巴西等 4 國先上路、2027 年擴大全球,台灣用戶裝 APK 會怎樣(2026)
Google 的 Android 開發者驗證已於 9 月 30 日在巴西、印尼、新加坡、泰國先行,2027 年擴大到全球認證裝置。整理進階側載流程、24 小時等待、台灣讀者的影響,以及還不確定的部分。
Ubuntu 26.10 發布:核心工具全面改用 Rust、OpenSSL 4,要不要升級?對照 26.04 LTS(2026)
Ubuntu 26.10 已在 10 月 15 日發布,核心工具全面改用 Rust 版 uutils、搭載 OpenSSL 4。依官方 release notes 對照 26.04 LTS,整理支援期限、已知問題、升級前檢查,以及個人、開發機與伺服器該不該升級。
群暉 Synology NAS 遭 C3RB3R 勒索軟體攻擊:家用 NAS 怎麼檢查 DSM 更新、遠端存取與備份(2026)
Synology 在 2026-10-29 呼籲用戶更新 DSM,指有勒索軟體攻擊舊版系統。依官方公告、HKCERT 與資安媒體整理誰受影響、怎麼查版本、關閉不必要的遠端存取、備份怎麼做,以及漏洞來源各方說法不一的部分。