本文档介绍如何使用边缘函数 Pages 托管静态页面。

什么是边缘函数 Pages #

边缘函数 Pages 是火山引擎边缘函数提供的一项静态页面托管服务，旨在帮助开发者快速、高效地将静态网站部署到全球边缘节点网络。通过边缘函数 Pages，您可以轻松托管各种类型的静态内容，包括但不限于：

• 静态网站（HTML/CSS/JavaScript）
• 单页应用（SPA）
• 文档站点
• 博客
• 静态资源库

边缘函数 Pages 基于分布在全球的火山引擎边缘节点构建，将您的静态资源缓存到离用户最近的边缘节点，从而实现低延迟、高可用的内容交付。

目前，您可以通过边缘函数 CLI 使用边缘函数 Pages。参见 nest pages。

基本概念 #

Pages 实例 #

Pages 实例是边缘函数中用于托管和管理静态页面的基本单元。每个 Pages 实例都拥有唯一的 ID，作为其身份标识。一个 Pages 实例可以包含多个资源（Asset），每个资源对应一个静态页面版本，且每个资源也有自己的唯一 ID。

通过 Pages 实例，您可以集中管理静态页面的生命周期，包括：

• 创建、配置和删除实例
• 上传、部署和管理资源版本

资源 #

资源（Asset）是 Pages 实例中存储的静态页面版本。每个资源包含完整的静态站点文件，并在上传后会生成一个唯一的资源 ID。

使用限制 #

边缘函数 Pages 的使用限制如下。

• 每个火山引擎账号最多可以创建 10 个 Pages 实例
• 每个 Pages 实例最多保留 100 个历史资源，多余资源会自动清理
• 每个 Pages 实例每个月最多发布 100 次
• 每个资源在 gzip 压缩后的 tar 包大小不超过 50 MB
• 每个资源内的文件个数不超过 500 个
• 每个资源内的单文件大小不超过 25 MB

示例场景 #

您有一个静态网站项目，包含 .html、.css、.js 等文件，您希望通过边缘函数 Pages 快速托管和发布该网站。

运行环境要求 #

运行边缘函数 CLI 的设备需要满足以下要求：

• 操作系统必须属于以下类型：
  • ARM64 macOS
  • x86-64 macOS
  • ARM64 Linux
  • x86-64 Linux
• 安装了 Node.js 和 npm。版本要求如下：
  • Node.js：8.17.0+
  • npm：6.13.4+
• 安装了 wget 或 cURL。

操作步骤 #

步骤一：安装边缘函数 CLI #

您可以将 CLI 安装到全局环境中：

npm install -g @volcengine/nest

步骤二：设置您的 Access Key ID 和 Secret Access Key #

在任意目录下运行以下命令在边缘函数 CLI 中设置您的火山引擎账号的 Access Key ID 和 Secret Access Key。您可以从 火山引擎控制台 获取 Access Key ID 和 Secret Access Key：

npx nest config set -g cloud.access_key <access_key_id>
npx nest config set -g cloud.secret_key <secret_access_key>

步骤三：创建 Pages 实例并在本地测试 #

1. 创建静态资源目录：在任意目录下创建一个静态资源目录，例如 site，并将您的静态网站文件放入该目录中：

   mkdir -p site
   # 将您的静态文件（.html、.css、.js 等）放入 site 目录
   

2. 创建 Pages 实例：使用以下命令创建一个 Pages 实例：

   npx nest pages create --name demo-site --assets ./site
   

   参数说明 #

   参数	类型	必填	描述
   --name	string	是	新 Pages 实例的名称
   --assets	string	是	本地静态资源目录路径（需包含 index.html 入口文件）

   执行命令后，您将看到类似以下的输出：

   ==> New Pages demo-site created!
   ==> [info]: Compressing given assets directory ./site...✓
   ==> [info]: Uploading assets...✓
   

3. 本地测试 Pages 实例：使用 serve 命令在本地运行和测试您的 Pages 实例：

   nest pages serve ./site
   

   默认情况下，您的站点将在 http://localhost:8080 上提供服务。您可以在浏览器中打开此地址来预览您的站点。

步骤四：关联域名并发布（可选） #

如需对外发布您的 Pages 实例，您需要关联一个域名。您可以 提交工单 联系技术支持。