使用私有 npm 注册表

Deno 会读取与 npm 相同的 .npmrc 文件，因此托管在私有 npm 注册表中的包可以像公共包一样通过 deno install 和 deno add 安装。 本教程先配置一个带认证令牌的作用域注册表，然后介绍 全局注册表覆盖以及两个常见的托管注册表。

将作用域指向你的注册表 Jump to heading#

创建一个 .npmrc 文件，将你组织的作用域映射到注册表 URL， 并为该主机附加一个认证令牌：

@mycompany:registry=https://registry.mycompany.com/
//registry.mycompany.com/:_auth=secretToken

Deno 会先在项目根目录中查找 .npmrc，然后再查找你 $HOME 目录中的文件。配置完成后，就可以像往常一样依赖该包：

{
  "imports": {
    "@mycompany/package": "npm:@mycompany/package@1.0.0"
  }
}

现在，每个 npm:@mycompany/... 标识符都会通过你的注册表解析； 其他内容仍然来自默认的 npm 注册表。

为所有包覆盖注册表 Jump to heading#

如果要将 所有 npm 请求发送到同一个注册表，请设置 NPM_CONFIG_REGISTRY 环境变量：

NPM_CONFIG_REGISTRY=https://registry.mycompany.com/ deno install

它会覆盖 .npmrc 中配置的注册表，行为与 npm 自身的优先级一致， 因此非常适合在 CI 中使用：你可以在不修改已提交的 .npmrc 的情况下 重定向安装来源。

认证私有 HTTPS 和 JSR 导入 Jump to heading#

.npmrc 只覆盖 npm: 包。对于从私有 HTTPS 主机导入的模块 （例如私有 GitHub 仓库），请使用 DENO_AUTH_TOKENS 环境变量。每一项要么是 bearer token（{token}@{hostname}）， 要么是 basic auth（{username}:{password}@{hostname}），多项之间 用分号分隔：

DENO_AUTH_TOKENS=a1b2c3d4e5f6@deno.land;username:password@example.com:8080

Deno 在从这些主机获取模块时，会发送匹配的 Authorization 请求头。

GitHub Packages Jump to heading#

GitHub npm 注册表使用个人访问令牌进行认证（在 Actions 中也可以使用 GITHUB_TOKEN），并通过 _authToken 字段配置：

@mycompany:registry=https://npm.pkg.github.com/
//npm.pkg.github.com/:_authToken=ghp_yourTokenHere

Deno 会像 npm 一样将其作为 bearer token 发送。

Verdaccio Jump to heading#

对于自托管的 Verdaccio 实例，配置方式 完全相同：将作用域（或对所有包使用 NPM_CONFIG_REGISTRY）指向你的 实例，并提供其令牌：

@mycompany:registry=https://verdaccio.mycompany.com/
//verdaccio.mycompany.com/:_authToken=secretToken

Azure Artifacts Jump to heading#

Azure Artifacts feed 使用这种注册表 URL 形式（这是一个典型的 Azure feed URL； 请替换为你自己的组织和 feed 名称）：

@mycompany:registry=https://pkgs.dev.azure.com/{org}/_packaging/{feed}/npm/registry/
//pkgs.dev.azure.com/{org}/_packaging/{feed}/npm/registry/:_auth=base64EncodedToken

JFrog Artifactory Jump to heading#

Artifactory npm 仓库遵循以下 URL 约定：

@mycompany:registry=https://{host}/artifactory/api/npm/{repo}/
//{host}/artifactory/api/npm/{repo}/:_auth=secretToken

双向 TLS Jump to heading#

如果注册表需要客户端证书（mTLS），请使用 certfile 和 keyfile 字段将 Deno 指向 PEM 文件（Deno 2.8+）：

//registry.mycompany.com/:certfile=/etc/deno/client.crt
//registry.mycompany.com/:keyfile=/etc/deno/client.key

Deno 也会为需要它的旧版注册表读取 email 字段，以及读取 min-release-age 作为供应链防护；有关所有受支持字段，请参阅 .npmrc 配置参考。