创建静态网站
静态网站适合部署纯前端项目，例如官网、文档站，或 React、Vue、Vite、Next.js 静态导出（output: 'export'）的构建产物。静态网站部署免费，由 CDN 节点直接分发。边缘加速流量与 Web 应用共用每月 10 GiB 免费额度，超出部分按 0.43 元/GiB 计费，详见 定价与计费。
tip
如果项目需要在服务端运行（如 Next.js SSR、Express、Django），请创建 Web 应用。
入口
点击控制台右上角 新建 → 静态网站，进入 创建静态网站 页面。
填写应用信息
应用名称
- 只能使用小写字母和数字，长度 4 ~ 20 位，例如
myblog2026。 - 应用名称会用于生成默认访问域名，创建后不能修改。
选择部署来源
静态网站支持三种来源：
| 来源 | 说明 |
|---|---|
| GitHub | 需要先授权 GitHub。未授权时页面会提示 授权访问，详见 Git 集成 |
| Gitee | 需要先授权 Gitee，并选择 Gitee 账户 |
| Git | 填写 公开Git仓库 地址，无需授权，例如 https://github.com/user/repo.git |
选好来源后填写：
- 代码仓库：下拉框支持搜索。找不到仓库时，点击 授权访问 重新选择授权范围。
- 分支：要部署的分支，例如
main。 - 根目录（可选）：项目不在仓库根目录时填写，例如 monorepo 中的
apps/web。设置后将从此目录构建。
构建设置
| 字段 | 说明 | 示例 |
|---|---|---|
| 构建命令 | 构建时执行的命令。留空时按框架自动识别 | npm run build |
| 输出目录 | 构建产物所在目录，平台会把该目录发布到线上 | dist、build、out |
更多说明见 构建设置。
构建环境变量（可选）
展开 构建环境变量，点击 增加 添加键值对，例如 VITE_API_URL=https://api.example.com。这些变量只在构建过程中注入，键或值为空的行会被忽略。
Gitee Webhook
使用 Gitee 来源时，表单中有 webhook 开关，默认开启。开启后，向部署分支推送代码会自动触发部署。GitHub 来源默认通过 GitHub App 自动部署。
部署
点击 部署，在确认框中点击确认。创建成功后返回应用列表，应用开始构建。构建完成后可以：
- 通过平台分配的
应用名-xxxx.maozi.io域名访问； - 在应用详情页点击 访问 打开网站；
- 绑定自己的域名，见 应用域名。
静态网站可用的功能
静态网站详情页包含：概览、部署、构建设置、域名、规则、设置。监控、日志、资源、配置/密钥和计费只对 Web 应用和数据库提供。详见 应用管理概览。
note
部署完成后如果浏览器看到的仍是旧页面，请清除浏览器缓存，或用无痕模式访问。
更新于