unpkg-white-list

• npmmirror.com 允许开启 unpkg 功能的白名单列表，避免 https://x.com/fengmk2/status/1791498406923215020 类似问题

  • allowPackages 字段：用于添加指定包名和版本号，示例：

    "allowPackages": {
      "urllib": {
        "version": "*"
      }
    }

  • allowScopes 字段：用于添加指定 scope，示例：

    "allowScopes": [
      "@eggjs",
      "@ant-design"
    ]

• npmmirror sync package tgz 超大文件白名单列表，避免 https://x.com/fengmk2/status/1999821026012889567 类似问题

  • allowLargePackages 字段：用于添加指定包名和版本号，示例：

    "allowLargePackages": {
      "aws-cdk-lib": {
        "version": "*"
      }
    }

  • allowLargeScopes 字段：用于添加指定 scope，示例：

    "allowLargeScopes": [
      "@next",
      "@swc"
    ]

添加白名单方式

Note

尽量使用 CLI 添加白名单，它可以确保字段顺序和格式正确，避免手动修改 package.json 文件。

unpkg 白名单添加指定包名和版本号

用 CLI 添加你想开启 unpkg 文件同步的 npm 包名和版本号，全量同步版本号可以设置为 *，以同步 urllib 为示例：

# npm run add -- --pkg={package name}[:{version range}]
npm run add -- "--pkg=urllib" # 同步 urllib 所有版本
# or
npm run add -- "--pkg=urllib:1.0.0" # 同步 urllib 1.0.0 版本
# or
npm run add -- "--pkg=urllib:>=1.0.0" # 同步 urllib 大于等于 1.0.0 版本

你将会看到 package.json 文件中的 allowPackages 字段被更新，如下所示：

"allowPackages": {
  ...
  "urllib": {
    "version": "*"
  }
  ...
}

unpkg 白名单添加指定 scope

Warning

为避免滥用，申请添加的 scope 必须已包含热门包（如周下载量超过 1 万）。我们不接受为刚创建且无热门包的 scope 添加白名单。

当然你发布的是 scoped package，可以用 CLI 添加 scope 到白名单 allowScopes：

npm run add -- --scope=@eggjs

你将会看到 package.json 文件中的 allowScopes 字段被更新，如下所示：

"allowScopes": [
  ...
  "@eggjs",
  ...
]

sync package tgz 超大文件白名单添加指定包名和版本号

用 CLI 添加你想开启 npmmirror sync package tgz 超大文件同步的 npm 包名和版本号，全量同步版本号可以设置为 *，以同步 aws-cdk-lib 为示例：

# npm run add -- --large-pkg={package name}[:{version range}]
npm run add -- "--large-pkg=aws-cdk-lib" # 同步 aws-cdk-lib 所有版本
# or
npm run add -- "--large-pkg=aws-cdk-lib:1.0.0" # 同步 aws-cdk-lib 1.0.0 版本
# or
npm run add -- "--large-pkg=aws-cdk-lib:>=1.0.0" # 同步 aws-cdk-lib 大于等于 1.0.0 版本

你将会看到 package.json 文件中的 allowLargePackages 字段被更新，如下所示：

"allowLargePackages": {
  ...
  "aws-cdk-lib": {
    "version": "*"
  }
  ...
}

sync package tgz 超大文件白名单添加指定 scope

Warning

为避免滥用，申请添加的 scope 必须已包含热门包（如周下载量超过 1 万）。我们不接受为刚创建且无热门包的 scope 添加白名单。

当然你发布的是 scoped package，可以用 CLI 添加 scope 到白名单 allowLargeScopes：

npm run add -- --large-scope=@next

你将会看到 package.json 文件中的 allowLargeScopes 字段被更新，如下所示：

"allowLargeScopes": [
  ...
  "@next",
  ...
]

提交 PR 并等待合并生效

修改完成后提交一个 Pull Request 合并到 master 分支，等待 Review，合并后会自动发布，预计最长 5 分钟后会全网生效。

for admins

block sync packages and scopes:

npm run add -- --block-sync-pkg=colors
npm run add -- --block-sync-scope=@sdjkals

License

MIT

Contributors

Made with contributors-img.