NPM 软件包注册表

发布您或组织的 npm 包。

要求

要使用 npm 包注册表，您需要 Node.js 以及一个包管理器，例如 Yarn 或 npm 本身。

注册表支持 作用域 和非作用域包。

以下示例使用 npm 工具和作用域 @test。

配置包注册表

要注册包注册表，您需要配置一个新的包源。

npm config set {scope}:registry=https://gitea.example.com/api/packages/{owner}/npm/
npm config set -- '//gitea.example.com/api/packages/{owner}/npm/:_authToken' "{token}"

参数	描述
scope	包的作用域。
owner	包的所有者。
token	您的 个人访问令牌。

例如

npm config set @test:registry=https://gitea.example.com/api/packages/testuser/npm/
npm config set -- '//gitea.example.com/api/packages/testuser/npm/:_authToken' "personal_access_token"

或不带作用域

npm config set registry https://gitea.example.com/api/packages/testuser/npm/
npm config set -- '//gitea.example.com/api/packages/testuser/npm/:_authToken' "personal_access_token"

发布包

在您的项目中运行以下命令以发布包

npm publish

如果已存在相同名称和版本的包，则无法发布包。您必须先删除现有的包。

取消发布包

运行以下命令删除包

npm unpublish {package_name}[@{package_version}]

参数	描述
package_name	包名。
package_version	包版本。

例如

npm unpublish @test/test_package
npm unpublish @test/[email protected]

安装包

要从包注册表安装包，请执行以下命令

npm install {package_name}

参数	描述
package_name	包名。

例如

npm install @test/test_package

标记包

注册表支持 版本标签，可以通过 npm dist-tag 进行管理

npm dist-tag add {package_name}@{version} {tag}

参数	描述
package_name	包名。
version	包的版本。
tag	标签名称。

例如

npm dist-tag add [email protected] release

标签名称不能是有效的版本。所有可解析为版本的标签名称都将被拒绝。

搜索包

注册表支持 搜索，但不支持 author:gitea 等特殊搜索限定符。

支持的命令

npm install
npm ci
npm publish
npm unpublish
npm dist-tag
npm view
npm search