npm 供應鏈攻擊近況與開發者防護:keyv 事件、9 月新惡意套件,暫存發布、冷卻期、雙因素驗證與 CI 設定怎麼用(2026)

機誌編輯部 · 發布 2026年11月4日 · 約 9 分鐘

npm 供應鏈攻擊近況與開發者防護:keyv 事件、9 月新惡意套件,暫存發布、冷卻期、雙因素驗證與 CI 設定怎麼用(2026)
圖片來源:Pixabay/Pexels/Pixabay License(示意圖)

先說結論: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 報導與官方公告整理,每列都標明依據;套件與版本數字見表後的說明。

2026 年 npm 相關事件與官方動作時間線
時間事件或動作依據
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 報導)。

兩個值得開發者記住的重點,都來自報導:

  1. 來源證明不等於安全。 首批惡意版本是透過專案既有的 GitHub Actions 與 npm OIDC trusted publishing 發布,所以仍帶有效的 SLSA 來源證明(iThome)。
  2. 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 與官方文件為準。

一、所有人:安裝端

  1. 提交鎖定檔,CI 用 npm ci。 依 npm 官方文件,npm ci 需要 package-lock.json 或 npm-shrinkwrap.json;若鎖定檔與 package.json 不一致,會直接報錯而不是更新鎖定檔,也永遠不會寫入 package.json 或鎖定檔,並且會先刪除既有的 node_modules。

    # CI 與正式建置:照鎖定檔安裝,不一致就失敗
    npm ci
    
  2. 設定發布冷卻期 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 初版沒有例外排除機制,現在是否已有,資料不足,請查你所用版本的文件。代價是新版與安全修補會晚幾天才裝得到,遇到緊急修補要有手動繞過的流程。

  3. 管好安裝指令碼。 依 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-scripts
    

    npm 設定文件另有 ignore-scripts(預設 false,設為 true 則不執行 package.json 的腳本)與 strict-allow-scripts(設為 true,沒被允許的安裝指令碼會讓安裝失敗而不是只警告)。但請記得 9 月 indexed-btree 事件:惡意碼在執行時才發動,安裝指令碼被擋住也沒用,所以這只是其中一層。

  4. 收緊非 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。

  5. 新版本先別急著升級。 對沒有自動化封鎖機制的小團隊,最低成本的做法是依賴更新走 PR、人工看一下變更,而不是 CI 每次抓最新。

二、有 npm 帳號、會發布套件的人

  1. 帳號開 2FA,並盡量用安全金鑰或 passkey。 npm 官方文件說預設的 2FA 模式是 auth-and-writes(登入授權與寫入操作,如發布、棄用、變更套件權限都要第二因素),另有範圍較小的 auth-only;發布套件需要啟用 2FA,或使用設為繞過 2FA 的精細度存取權杖。官方頁面描述的是安全金鑰(Touch ID、Face ID、Windows Hello、Yubikey 等)流程;iThome 報導 StepSecurity 也建議維護者用 passkey 或實體安全金鑰。通行密鑰的概念可參考通行密鑰與雙重驗證設定。

  2. 能用 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 發布也會被濫用,所以它要搭配下一步。

  3. 加上暫存發布(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 佔位版本;新套件請以官方文件與自己實測為準。

  4. 還在用繞過 2FA 的 token 嗎? 依 iThome 報導,這類精細度存取權杖已被限制不能做帳號與套件管理操作,且 GitHub 預計 2027 年 1 月取消其直接發布能力,建議改用 OIDC trusted publishing 或暫存發布;9 月新增的「僅限暫存發布」權杖權限則給暫時無法轉換的團隊(報導強調這種權杖仍可修改發行標籤與棄用版本,外洩仍有風險)。這部分我們只讀到 iThome 的報導,沒讀到官方文件原文,請去 npm 後台確認選項名稱。

三、CI 與團隊

  1. CI 只給最小權限。 依 iThome 報導,StepSecurity 建議縮小 GitHub Token 權限、啟用主分支保護與強制程式碼審查;企業可在 CI/CD 限制套件安裝指令與對外連線,並監控新版本突然加入的可執行檔與安裝指令碼。AsyncAPI 事件的原因(依報導)是配置不當的 GitHub Actions,值得回頭檢查自家的 workflow。
  2. 有預算的組織可看 GitHub 套件防火牆。 依 iThome 10-21 報導,它在公開預覽、僅限 GitHub Enterprise Cloud,可擋已知惡意套件、檢查新版是否新增安裝指令碼或失去來源證明,並提供版本冷卻期(報導引用官方文件:預設 1 天、可設 1 至 365 天)。公開預覽期間免費,正式上市後依用量收費,費率未公布。一般個人與小團隊用不到。
  3. 如果已經安裝過受影響版本: 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 憑證並重建環境。

參考資料

// 分享

常見問題

  • 各報導說法不一,而且事件當天數字一直在變。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 來源證明;來源證明只記錄原始碼與建置流程,不檢測內容是否惡意。

延伸閱讀