Pages 部署能力

概述

一键将静态网站代码部署至 BytePlus / VolcEngine Edge Pages 平台。专为 Coding Agent（如 Cursor、Claude Code、Trae 等）设计，可在生成静态网页后快速完成托管、构建及 CDN 集成。

使用场景

• 部署由 Coding Agent 生成的静态网页代码
• 将本地静态站点部署至全球 CDN
• 为已部署站点绑定自定义域名
• 对现有 Pages 项目进行迭代更新

前置条件

1. AK/SK 配置：需提供 BytePlus / VolcEngine 的 Access Key 和 Secret Key
   • Mira 客户端：存储于 secrets/byteplus.json，格式为：{"access_key": "xxx", "secret_key": "xxx"}
   • 手动配置：nest config set -g cloud.access_key YOUR_AK && nest config set -g cloud.secret_key YOUR_SK
2. 静态站点目录：包含 index.html 的目录

CLI 命令

完整部署（自动识别新建或更新）

# 自动识别：若项目不存在则创建，存在则更新部署
bash /path/to/scripts/deploy.sh --name my-site --dir ./dist

# 指定描述与加速区域
bash /path/to/scripts/deploy.sh --name my-site --dir ./dist --desc "AI generated site" --region global

# 绑定自定义域名
bash /path/to/scripts/deploy.sh --name my-site --dir ./dist --domain www.example.com

参数说明

其他操作

# 列出所有项目
bash /path/to/scripts/manage.sh list

# 查看项目详情
bash /path/to/scripts/manage.sh get --pages p-xxx

# 查看部署历史
bash /path/to/scripts/manage.sh deployments --pages p-xxx

# 本地预览
bash /path/to/scripts/manage.sh serve --dir ./dist --port 8080

# 域名管理
bash /path/to/scripts/manage.sh domain-list --pages p-xxx
bash /path/to/scripts/manage.sh domain-add --pages p-xxx --domain www.example.com
bash /path/to/scripts/manage.sh domain-verify --pages p-xxx --domain www.example.com

# 下线 / 删除
bash /path/to/scripts/manage.sh offline --pages p-xxx
bash /path/to/scripts/manage.sh delete --pages p-xxx

完整工作流

步骤 0：环境准备（一次性）→ 安装 CLI + 配置 AK/SK  
步骤 1：Coding Agent 生成代码 → ./my-site/  
步骤 2：本地预览 → nest pages serve ./my-site  
步骤 3：部署 → deploy.sh --name xxx --dir ./my-site  
步骤 4：检查域名 → manage.sh get --pages p-xxx  
步骤 5：绑定域名 → deploy.sh --name xxx --dir ./my-site --domain www.example.com  
步骤 6：迭代更新 → deploy.sh --name xxx --dir ./my-site  
步骤 7：项目管理 → manage.sh list / deployments / offline  

注意事项

• 中国大陆生产环境不提供默认域名；必须绑定自定义域名方可访问
• CLI 包名为 @byteplus/nest（非 @byted/nest）
• 部署完成后 CDN 生效需 1–5 分钟
• 绑定自定义域名需在您的 DNS 提供商处添加 CNAME 记录