构建设置
构建设置决定平台如何把你的代码变成可运行的网站或服务。创建应用时可以填写，创建后也可以在应用详情页的 构建设置 标签页修改。
部署来源
| 字段 | 说明 |
|---|---|
| 代码仓库 / 公开Git仓库 | 要部署的仓库 |
| 分支 | 部署分支。自动部署只响应该分支的推送 |
| 根目录 | 可选。项目在仓库子目录时填写，例如 packages/web，构建将在该目录中执行 |
静态网站
| 字段 | 说明 | 常见取值 |
|---|---|---|
| 构建命令 | 构建时执行的命令。留空时按框架自动识别 | npm run build、pnpm build、hugo |
| 输出目录 | 构建产物目录，会被发布到 CDN | Vite/Vue：dist；Create React App：build；Next.js 静态导出：out |
Web 应用
| 构建类型 | 字段 | 说明 |
|---|---|---|
| Buildpack | 构建命令（可选） | 自定义构建命令，例如 npm run build |
| Buildpack | 启动命令（可选） | 部署完成后用来启动应用的命令，例如 npm run start、python app.py |
| Dockerfile | Dockerfile 路径（可选） | 相对根目录的路径，默认 ./Dockerfile |
输入框最多 300 个字符。Buildpack 无需 Dockerfile，平台会根据项目文件自动识别语言和框架。Dockerfile 模式要求根目录（或指定路径）下存在 Dockerfile。
构建环境变量
展开 构建环境变量，点击 增加 添加 键 和 值。这些变量会在构建过程中注入，常用于前端构建时写入接口地址等配置，例如：
VITE_API_URL=https://api.example.com
NODE_ENV=production键或值为空的行会被忽略。
important
构建环境变量只在构建阶段可用。Web 应用运行时需要的配置文件和密钥，请使用 配置/密钥。不要把密码写进前端构建变量，构建产物中的内容可被任何访问者看到。
修改后生效
在 构建设置 标签页修改并保存后，需要重新部署才会生效：点击详情页右上角 部署，选择分支后点击 立即部署。
Docker 镜像来源
使用 Docker 镜像的应用没有构建过程，对应的标签页叫 镜像设置，详见 部署来源。
更新于