# @aws/cloudfront-hosting-toolkit 中文文档 规范地址：https://npmcn.com/package/%40aws/cloudfront-hosting-toolkit/ 版本：1\.1\.22 npm 元数据更新时间：2024-11-17T13:35:10.698Z 中文译文更新时间：2026-11-07T19:57:40.264Z 软件包许可：Apache-2\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40aws/cloudfront-hosting-toolkit 原文对照：https://npmcn.com/package/%40aws/cloudfront-hosting-toolkit/?lang=original 项目主页：https://github.com/awslabs/cloudfront-hosting-toolkit 源码仓库：https://github.com/awslabs/cloudfront-hosting-toolkit ## 关键信息（来自 npm 元数据） - 包体积（解压后）：12.4 MB，11091 个文件 - 模块格式：CommonJS - TypeScript 类型：包内自带 - 运行依赖：30 个 - 首次发布：2023-12-11T13:33:31.606Z - 最新版本发布：2024-11-17T13:35:10.525Z - 近 30 天下载量：2834（2026-10-08 至 2026-11-06，npm 官方下载统计） - 已发布版本数：25（近 12 个月 0 个） ## 中文简介 CloudFront Hosting工具箱为管理下的前端托管服务提供了方便,同时保持对托管和部署基础设施的充分控制,使其成为你自己的. ## 安装 ```sh npm install @aws/cloudfront-hosting-toolkit ``` 也可以使用：`pnpm add @aws/cloudfront-hosting-toolkit`、`yarn add @aws/cloudfront-hosting-toolkit`、`bun add @aws/cloudfront-hosting-toolkit` ## README # CloudFront 主机工具箱 CloudFront Hosting工具箱是一个开源指令行工具,旨在简化AWS上快速,安全的前端应用程序的部署和管理. 它为管理下的前端托管服务提供了便利,同时让开发者完全控制他们的托管和部署基础设施. [![GitHub Repo](https://img.shields.io/badge/GitHub-Repo-green.svg)](https://github.com/awslabs/cloudfront-hosting-toolkit) [![npm](https://img.shields.io/npm/v/@aws/cloudfront-hosting-toolkit.svg?style=flat-square)](https://www.npmjs.com/package/@aws/cloudfront-hosting-toolkit) [![Documentation](https://img.shields.io/badge/docs-book-blue.svg?style=flat-square)](https://awslabs.github.io/cloudfront-hosting-toolkit) ## 什么是"云龙"主机工具箱? CloudFront Hosting工具箱是一个将AWS上建立和管理强大,可扩展的前端托管基础设施的进程自动化的综合性解决方案. 它利用了CloudFront,S3,CodePipeline,和Lambda等多个AWS服务,创造了适合现代网络应用的强大的托管环境. 关键特征包括: - 前端主机自动设置 AWS 资源 - GitHub和S3工作流程的持续部署管道 - 通过 CloudFront 优化内容提供 - \* 内设安全装置,包括HTTPS和安全头 - 使用自动 SSL/ TLS 证书管理的自定义域名支持 - 各种前端框架的灵活配置选项 ## 如何运作 CloudFront Hosting工具箱通过简单的CLI接口来简化部署过程. 它自动提供和配置必要的AWS资源,处理部署管道,并管理通过CloudFront提供的内容. 关于结构和工作流程的详细解释,请参见我们 [建筑文件](https://awslabs.github.io/cloudfront-hosting-toolkit/architecture/overview)。 。 。 . ## 为什么使用 CloudFront 主机工具箱? - **简单**: 部署复杂的前端托管设置,仅包含几个指令. - **速度**:Leverage CloudFront全球CDN快内容提供. - **警卫**:自动HTTPS配置和安全头. - **灵活性**: 支持各种前端框架和部署来源. - **成本效益**: 高效利用AWS服务而无需间接费用. - **全控**:保留定制和扩大基础设施的能力. ## 开始 看看我们 [文档](https://awslabs.github.io/cloudfront-hosting-toolkit/) 为建立和使用云头托管工具的全面指南! ### 所需资源 - 节点.js 18+ - AWS CLI 2+ 配置与您的 AWS 账户 - 基于 GitHub 的部署的 GitHub 账户 ### 安装 ```bash npm install -g @aws/cloudfront-hosting-toolkit ``` ### 快速启动 1. 初始化您的项目 : ```bash cloudfront-hosting-toolkit init ``` 以下动画 GIF 显示初始化进程 ![sample](https://npmcn.com/package/%40aws/cloudfront-hosting-toolkit/img/init.gif "CloudFront Hosting Toolkit Init") 2. 部署您的网站 : ```bash cloudfront-hosting-toolkit deploy ``` 以下动画显示部署过程 ![sample](https://npmcn.com/package/%40aws/cloudfront-hosting-toolkit/img/deploy.gif "CloudFront Hosting Toolkit Deploy") 关于更详细的说明和先进的使用,请参见我们 [CLI 指南](https://awslabs.github.io/cloudfront-hosting-toolkit/user-guide/cli-guide)。 。 。 . ## 示例命令 ```bash # Show domain name cloudfront-hosting-toolkit show # Check deployment status cloudfront-hosting-toolkit status # Remove hosting infrastructure cloudfront-hosting-toolkit delete ``` ## 建筑 ![Technical diagram](https://npmcn.com/package/%40aws/cloudfront-hosting-toolkit/img/architecture.jpg) CloudFront Hosting工具箱为您的前端主机设置了全面的 AWS 架构: - **源控件**: GitHub 仓库或 S3 桶 - **排雷中心/发改委**: AWS 代码Pipeline 用于自动构建和部署 - **构建进程**: AWS 编码用于编译和创建部署文物 - **存储**: 托管网站文件的 S3 桶 - **内容交付**: CloudFront 全球内容发布 - **路线**: 用于请求处理和路径的 CloudFront 函数 - **管弦**: 管理部署过程的分步函数 - **州管理层**: 用于存储部署状态信息的KVS 此架构确保您前端应用程序的可缩放、可执行和维护的托管解决方案 . ## 高级使用 CloudFront主机工具包在如何使用方面提供了灵活性: - **国 际**: 使用"命令-线"接口进行直截了当,分步部署的过程. - **CDK 构造**: 将 CloudFront 主机工具箱作为现成的L3 CDK架构,用于无缝地集成到您的 AWS CDK 项目中. - **CDK 源代码**: 自定义 CDK 源代码,以适应您的特定要求. 关于如何使用CloudFront Hosting工具箱的更多信息,包括先进的使用设想和深度定制选项,请参见我们在该工具箱中的广泛文献 [高级部分](https://awslabs.github.io/cloudfront-hosting-toolkit/advanced/configuration/)。 。 。 . ## 文档 - [如何运作](https://awslabs.github.io/cloudfront-hosting-toolkit/getting-started/how-it-works) - [CLI 指南](https://awslabs.github.io/cloudfront-hosting-toolkit/user-guide/cli-guide) - [CDK 整合](https://awslabs.github.io/cloudfront-hosting-toolkit/user-guide/cdk-guide) - [解决问题指南](https://awslabs.github.io/cloudfront-hosting-toolkit/troubleshooting/guide) - [财务问题](https://awslabs.github.io/cloudfront-hosting-toolkit/project/faq) - [贡献准则](https://npmcn.com/package/%40aws/cloudfront-hosting-toolkit/CONTRIBUTING.md) ## 路线图 关于未来特点和改进的信息,请参见我们 [路线图](https://npmcn.com/package/%40aws/cloudfront-hosting-toolkit/docs/roadmap.md)。 。 。 . ## 捐款 我们欢迎捐款! 请看我们的 [贡献指南](https://raw.githubusercontent.com/awslabs/cloudfront-hosting-toolkit/main/CONTRIBUTING.md) 更多细节. # 作者 - [克罗托鲁](https://www.linkedin.com/in/corneliucroitoru/) # 贡献者 [![contributors](https://contrib.rocks/image?repo=awslabs/cloudfront-hosting-toolkit&max=2000)](https://github.com/awslabs/cloudfront-hosting-toolkit/graphs/contributors) ## 许可证 这个图书馆根据Apache-2.0许可证获得许可. ## 常见问题 ### @aws/cloudfront-hosting-toolkit 是什么？ CloudFront Hosting工具箱为管理下的前端托管服务提供了方便,同时保持对托管和部署基础设施的充分控制,使其成为你自己的\. ### 如何安装 @aws/cloudfront-hosting-toolkit？ 在项目目录运行 npm install @aws/cloudfront-hosting-toolkit，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 cloudfront-hosting-toolkit，可以用 npx cloudfront-hosting-toolkit 直接运行。 ### @aws/cloudfront-hosting-toolkit 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @aws/cloudfront-hosting-toolkit 支持 ESM 还是 CommonJS？ 以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。 ### @aws/cloudfront-hosting-toolkit 可以商用吗？ @aws/cloudfront-hosting-toolkit 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。 ### @aws/cloudfront-hosting-toolkit 的下载量有多少？ 根据 npm 官方下载统计，@aws/cloudfront-hosting-toolkit 在 2026/10/08 – 2026/11/06 这 30 天内被下载 2,834 次，日均约 94 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @aws/cloudfront-hosting-toolkit 还在维护吗？ 最新版本 1\.1\.22 发布于 2024/11/17（2 年前）；至今共发布 25 个版本，其中过去 12 个月发布了 0 个；首次发布于 2023/12/11。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。