# @auth0/component-cdn-uploader 中文文档

规范地址：https://npmcn.com/package/%40auth0/component-cdn-uploader/

版本：2\.5\.1
npm 元数据更新时间：2026-07-14T10:25:58.215Z
中文译文更新时间：2026-11-07T06:01:15.894Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40auth0/component-cdn-uploader
原文对照：https://npmcn.com/package/%40auth0/component-cdn-uploader/?lang=original
项目主页：https://github.com/auth0/component-cdn-uploader/blob/master/README.md
源码仓库：https://github.com/auth0/component-cdn-uploader

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：49.3 kB，33 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=18\.0\.0
- 运行依赖：7 个
- 首次发布：2017-06-08T18:35:48.471Z
- 最新版本发布：2026-03-26T12:11:35.126Z
- 近 30 天下载量：2772（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：15（近 12 个月 7 个）

## 中文简介

通过 S3 桶将网络部件上传到 Auth0 CDN 的工具 .

## 安装

```sh
npm install @auth0/component-cdn-uploader
```

也可以使用：`pnpm add @auth0/component-cdn-uploader`、`yarn add @auth0/component-cdn-uploader`、`bun add @auth0/component-cdn-uploader`

## README

# 组件加载器

通过 S3 桶将网络部件上传到 Auth0 CDN 的工具 .

## 安装

通过纱线

```
yarn add @auth0/component-cdn-uploader --dev
```

通过 npm

```
npm install @auth0/component-cdn-uploader --save-dev
```

## 配置

在你身边 `package.json` 添加以下条目:

```json
"ccu": {
  "cdn": "https://cdn.auth0.com",
  "mainBundleFile": "lock.min.js",
  "bucket": "mybucket",
  "remoteBasePath": "js"
}
```

地点

-   cdn: 在 URL 中找到您的 CDN, 所以如果一个版本已经上传, 则检查 lib
-   主BundleFile: 检查CDN时使用的文件名称, 如果特定版本已经上传
-   桶: 要上传到的 S3 桶的名称
-   远程BasePath:在桶中存储组件的路径.

您也可以拥有以下条目

-   名称: 内部文件夹的名称 `remoteBasePath` 从软件包名称上覆盖默认值.
-   快照Name: 将覆盖默认的快取版本名称 `development`

### 文件密码摘要

如果您需要文件摘要, 您也可以在内部添加 `ccu` 在你身边 `package.json` 以下

```json
"digest": {
  "hashes": ["sha384"]
}
```

这将生成 `sha384` 上传和存储到不同文件的每个文件摘要 `<filename>.<hash-method>`. 如果您只需要散开一些文件,例如:

```json
"digest": {
  "hashes": ["sha384"],
  "extensions": [".js"]
}
```

> 有效的文摘类型是: `sha256`, (中文(简体) ), `sha384` 财务报告和审定财务报表 `sha512`,如果未指定任何文件,则工具将不生成摘要文件.

## 使用量

```
$ ccu [options] [directory ...]
```

选项

-   \--type( 字符串) 类型的上传流来进行( 默认的 “ ” , “ 释放 ” , “ snapshot ” )
-   \- 仅完整地上传完整的主要小写版本, 如果类型是“ snapshot” 则忽略
-   干燥进行干燥
-   \-- snapshot-name(字符串) 名称用于快照 。 默认是“ 开发 ”
-   静默地运行
-   用动词日志跟踪运行
-   \--version-override (字符串) 表示要上传的语义版号(overrides package.json 版本)

### 类型

-   默认: 如果在 cdn 中不存在, 将上传( 请检查) `mainBundleFile` ),使用完整和主要微分标记(或只在 `only-full` 或仅仅是快照标记.
-   释放: 如果在 cdn 中不存在, 只上传( 请检查) `mainBundleFile` ),使用完整和主要微分标记(或只在 `only-full` 指定),没有快报标记.
-   快照: 将总是上传快照标记 .

## 问题报告

如果您找到错误或有特性请求, 请在此寄存器问题节中报告 。 请不要在公共 GitHub 问题跟踪器上报告安全漏洞 。 这个 [负责任的披露程序](https://auth0.com/whitehat) 详细说明披露安全问题的程序.

## 作者

[自动 0](https://npmcn.com/package/%40auth0/component-cdn-uploader/auth0.com)

## 许可证

这个项目根据麻省理工学院的许可证获得许可。 见 [自由主义](https://npmcn.com/package/%40auth0/component-cdn-uploader/LICENSE) 需要更多信息的文件.

## 常见问题

### @auth0/component-cdn-uploader 是什么？

通过 S3 桶将网络部件上传到 Auth0 CDN 的工具 \.

### 如何安装 @auth0/component-cdn-uploader？

在项目目录运行 npm install @auth0/component-cdn-uploader，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ccu，可以用 npx ccu 直接运行。

### @auth0/component-cdn-uploader 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/auth0\_\_component-cdn-uploader 是否存在。

### @auth0/component-cdn-uploader 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @auth0/component-cdn-uploader 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @auth0/component-cdn-uploader 可以商用吗？

@auth0/component-cdn-uploader 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @auth0/component-cdn-uploader 的下载量有多少？

根据 npm 官方下载统计，@auth0/component-cdn-uploader 在 2026/10/07 – 2026/11/05 这 30 天内被下载 2,772 次，日均约 92 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @auth0/component-cdn-uploader 还在维护吗？

最新版本 2\.5\.1 发布于 2026/03/26（7 个月前）；至今共发布 15 个版本，其中过去 12 个月发布了 7 个；首次发布于 2017/06/09。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。