静态站点

静态站点 = 纯前端产物（HTML/CSS/JS/图片）不进容器：zip 上传即发布，站点经 CDN 全球分发，地址固定为 https://pages.newbeebox.com/<appid>/。没有容器、副本、端口、环境变量这些概念，也不占 CPU/内存配额——只有一份存储配额（默认 2GB）。

适合：官网 / 文档站 / 前端 Demo / Vite、CRA、VuePress 等构建产物。需要后端接口或服务端渲染的应用请用普通应用。

一条龙

# 1) 建站点：只要一个 app-id
nae create --kind static --app-id mysite

# 2) 构建你的前端项目（以 Vite 为例，产物在 dist/）
npm run build

# 3) 发布：打包 dist 目录上传，处理完成即上线
nae pages deploy mysite ./dist
# → 站点地址：https://pages.newbeebox.com/mysite/

再次发布重复第 2、3 步即可，整站替换：本次包里没有的旧文件会被删除。

命令

命令	说明
`nae pages deploy <appid> [path]`	发布：目录就地打 zip（或直接给 `.zip` 文件）上传，整站替换上线
`nae pages refresh <appid>`	手动刷新 CDN 缓存（60 秒冷却），改动立即全网生效
`nae pages deploys <appid>`	最近部署记录（状态 / 文件数 / 体量）
`nae pages rollback <appid> <部署ID>`	回滚到某次成功部署（副本保留窗口内；ID 见 `deploys`）
`nae pages files <appid>`	站点当前文件清单（只读；发布是整站替换）
`nae pages logs <appid> [--minutes N]`	源站访问日志（CDN 回源+直连口径）+ 简单统计
`nae pages stats <appid>`	边缘访问 7 天简报（含缓存命中口径，延迟数小时）
`nae pages access-logs <appid> [--date YYYY-MM-DD]`	边缘访问日志逐行分页（留存 7 天）

nae pages deploy mysite ./dist                # 打包 dist 目录并发布
nae pages deploy mysite site.zip              # 直接上传现成 zip
nae pages deploy mysite ./dist --no-refresh   # 发布但不刷缓存

要点

必须有 index.html 首页：站点根（目录根或 zip 内唯一顶层目录）下必须存在 index.html，没有则发布失败。请指到构建产物目录（如 dist/），别指到项目根。
CDN 缓存 1 天：发布默认自动刷新缓存、改动立即生效；--no-refresh 跳过刷新时，改动最长 1 天后生效。也可随时 nae pages refresh 手动刷（60 秒冷却）。
路径即子目录：站点部署在 /<appid>/ 路径下。构建工具需配置相对路径或 base: '/<appid>/'（Vite 的 base、CRA 的 homepage 同理），否则资源 404。
目录打包自动跳过 .git/、符号链接与系统垃圾文件（.DS_Store 等）；给现成 zip 则原样上传。
限额：解包后总大小 ≤ 存储配额（默认 2GB），文件数 ≤ 20000。
上传直传对象存储：预签名 URL 一次一密，凭据不出服务端，字节不经平台。

排查

nae pages deploys mysite     # 看最近部署：failed 行的 Error 即失败原因
nae events mysite            # 站点事件时间线（发布成功/失败/缓存刷新）

常见失败：zip 里没有 index.html（指错目录）、解包超配额、zip 损坏。

网页端「应用详情 → 站点」Tab 同样能发布：选 zip 文件上传、勾选是否刷新缓存，也能看部署历史、手动刷新缓存、删除站点。