站点
Sites 提供前端 / 全栈站点的托管:从模板克隆、Git 仓库或手动上传创建站点,管理部署版本、域名与用量。
启用条件
- 实例配置
_APP_SITES_ENABLED=true时,项目侧栏显示 Sites;未启用时入口隐藏。 - 能力白名单:实例可进一步配置 Sites 允许名单(邮箱列表)。名单为空时 Sites 能力对所有人关闭;名单非空时,仅当当前会话用户邮箱、账号 API Key 对应用户邮箱,或项目 / 组织 API Key 对应团队的已确认 Owner 邮箱在名单内才可使用,不满足时请求直接失败并明确报错。
- 创建站点还需要项目
sites.write权限(成员角色决定)。
创建站点
截图未公开:上游原图包含真实账号或资源标识。
入口:Sites 列表页 Create site(快捷键 C),三种方式:
| 方式 | 流程 |
|---|---|
| 克隆模板 | 从模板库选择(支持按 Use case / Framework 等筛选)→ 进入部署配置 |
| 连接 Git 仓库 | 选择已连接的 GitHub 仓库(未连接时先完成 GitHub App 授权)→ 进入部署配置 |
| 手动上传 | 拖拽或选择 .tar.gz 源码包(大小受套餐 / 实例配置限制)→ 进入部署配置 |
部署配置(Deploy site):
- Details:站点名称、Site ID、Framework(Next.js / SvelteKit 等)、执行计划。
- Git configuration:Root directory(默认
./)。 - Build configuration:Install command(默认
npm install)、Build command(默认npm run build)、Output directory(默认dist)。 - 环境变量(可从仓库预填)。
- Domain:站点子域名。
- 提交后进入构建等待页;构建完成前页面自动更新。
站点详情页签
| 页签 | 内容 |
|---|---|
| Overview | 当前活动部署(Visit 访问;Instant rollback 一键回滚——仅当存在 ready 且曾激活的部署);构建中显示进行中提示 |
| Deployments | 部署列表;Create deployment(Git(推荐)/ CLI / Manual);可 Cancel / Delete / Redeploy,查看部署指标 |
| Logs | 构建与运行日志 |
| Domains | 自定义域名与预览域名;证书状态与重试 |
| Usage | 站点用量 |
| Settings | 名称、仓库连接(可断开)、构建配置、运行时设置、环境变量(站点作用域)、资源规格、timeout、日志设置、危险区 |
部署状态与回滚
- 构建中:等待页自动更新;配置变更未生效时页面显示警示条并可 Redeploy。
- 回滚 = 把活动部署切换到某个 ready 且曾激活 的历史部署(Instant rollback 或在 Deployments 中选择);删除当前活动部署有额外警示。
- Cancel / Delete deployment 均需确认;删除不可恢复。
删除站点
Settings 页 Danger zone → Delete site:永久删除站点及其全部部署,不可撤销;需二次确认,删除后回到 Sites 列表。
与 Functions 的关系
Functions 侧重服务端代码执行;Sites 侧重站点构建产物托管与域名。站点可通过 API Endpoint 调用同项目的 Functions 与数据服务(见函数)。