npm-access

設定已發佈套件的存取權限層級

選擇 CLI 版本

概要

npm access list packages [<user>|<scope>|<scope:team> [<package>]
npm access list collaborators [<package> [<user>]]
npm access get status [<package>]
npm access set status=public|private [<package>]
npm access set mfa=none|publish|automation [<package>]
npm access grant <read-only|read-write> <scope:team> [<package>]
npm access revoke <scope:team> [<package>]

注意:此指令不了解工作區。

說明

用於設定私人套件的存取控制。

對於所有子指令,如果未將套件名稱傳遞給子指令,npm access 會對目前工作目錄中的套件執行動作。

  • public / restricted (已棄用):將套件設定為公開存取或受限存取。

  • grant / revoke (已棄用):新增或移除使用者和團隊對套件具有唯讀或讀寫存取權限的能力。

  • 2fa-required / 2fa-not-required (已棄用):設定套件是否要求任何發佈者在帳戶上啟用兩步驟驗證。

  • ls-packages (已棄用):顯示使用者或團隊可以存取的所有套件,以及存取權限層級,唯讀公開套件除外 (它不會列印整個註冊表清單)

  • ls-collaborators(已棄用):顯示套件的所有存取權限。只會顯示您至少有讀取存取權限的套件權限。如果傳入 <user>,清單僅會篩選至該使用者所屬的團隊。

  • edit(未實作)

詳細資料

npm access 永遠直接在目前的登錄檔上執行,可使用 --registry=<registry url> 從命令列進行設定。

未設定範圍的套件永遠是公開的

設定範圍的套件預設為受限,但您可以使用 npm publish --access=public 將它們公開,或在初始發佈後使用 npm access public 將其存取權限設定為公開。

您必須有權限才能設定套件的存取權限

  • 您是未設定範圍或設定範圍套件的所有者。
  • 您是擁有範圍的團隊成員。
  • 您已獲得套件的讀寫權限,可能是作為團隊成員或直接作為所有者。

如果您啟用兩步驟驗證,系統會提示您提供第二個驗證因素,或可以使用 --otp=... 選項在命令列中指定。

如果您的帳戶未付費,則嘗試發佈設定範圍的套件會失敗,並顯示 HTTP 402 狀態碼(合乎邏輯),除非您使用 --access=public

團隊和團隊成員的管理是使用 npm team 命令進行的。

設定

json

  • 預設值:false
  • 類型:布林值

是否輸出 JSON 資料,而不是一般輸出。

  • npm pkg set 中,它會在將設定值儲存到 package.json 之前,使用 JSON.parse() 來分析設定值。

並非所有 npm 命令都支援。

otp

  • 預設值:null
  • 類型:null 或字串

這是來自兩步驟驗證器的一次性密碼。在使用 npm access 發佈或變更套件權限時需要它。

如果未設定,且登錄檔回應失敗並要求一次性密碼,npm 會在命令列中提示您輸入。

registry

npm 登錄檔的基本 URL。

另請參閱