用途:将 HTML 页面、静态目录或自定义边缘函数部署到阿里云 ESA 边缘节点,并使用 Edge KV 分布式键值存储。提供免费全球 CDN 加速与边缘安全防护。
主要能力:三种部署模式——HTML 页面(自动包装为 JS,<5MB)、静态目录(前端构建产物,单文件<25MB)、自定义函数(自定义 JS,<5MB)。Edge KV 支持命名空间与键值读写,写入 2 个及以上键值对时必须使用 BatchPutKv(大批量用 BatchPutKvWithHighCapacity),单个键值用 PutKv。
使用方式:需先为 RAM 用户/角色授予 AliyunESAFullAccess 策略,并在 ESA 控制台启用 Functions & Pages。安装依赖:npm install @alicloud/esa20240910@2.43.0 @alicloud/openapi-client@0.4.15 @alicloud/credentials@2.4.4。部署前必须调用 GetErService 检查服务状态,未启用则调用 OpenErService。统一流程:CreateRoutine → 上传代码/资源 → Commit & Publish → GetRoutine 获取访问 URL → GetRoutineAccessToken 获取令牌(有效期 1 小时,追加 ?esa_er_token=<token>)。提供脚本:node scripts/deploy-html.mjs <name> <html-file>、node scripts/deploy-folder.mjs <name> <folder>、node scripts/deploy-function.mjs <name> <code-file>、node scripts/manage.mjs list|get、node scripts/kv.mjs <command> [options]。
限制:函数<5MB,资源单文件<25MB,KV 值<2MB(高容量 25MB);仅 production 环境;删除类 API 需用户确认;首次启用域名可能需数分钟生效;凭证通过默认凭证链获取,ESA 端点固定为 esa.cn-hangzhou.aliyuncs.com。