创建 Web 应用
Web 应用以容器方式运行你的服务端程序，适合 Node.js、Python、Go、Java、PHP、Ruby 等后端服务，以及 Next.js、Nuxt.js 等需要服务端渲染的框架。你可以从代码仓库构建，也可以直接使用 Docker 镜像。
入口
点击控制台右上角 新建 → Web 服务，进入 创建Web应用 页面。
1、应用名称
只能使用小写字母和数字，长度 4 ~ 20 位，创建后不能修改。
2、选择部署来源
| 来源 | 说明 |
|---|---|
| GitHub | 授权后选择 代码仓库、分支，可选 根目录 |
| Gitee | 选择 Gitee 账户 后选择仓库和分支，可开启 webhook 自动部署 |
| Git | 填写公开 Git 仓库地址和分支 |
| Docker | 直接部署已有镜像，不需要构建 |
构建类型（代码仓库来源）
| 构建类型 | 适用场景 | 可填写字段 |
|---|---|---|
| Buildpack（默认） | 项目中没有 Dockerfile。平台按项目类型（如 package.json、requirements.txt、go.mod）自动识别语言并构建 | 构建命令（可选）、启动命令（可选） |
| Dockerfile | 项目中已有 Dockerfile，需要完全控制构建过程 | Dockerfile 路径（可选），默认 ./Dockerfile |
示例：
- Buildpack 构建 Node.js 项目：构建命令
npm run build，启动命令npm run start。 - Dockerfile 在子目录：Dockerfile 路径填写
./deploy/Dockerfile。
tip
应用需要在容器内监听端口提供 HTTP 服务，请监听 0.0.0.0 而不是 127.0.0.1，否则外部无法访问。
Docker 镜像来源
切换到 Docker 标签页：
- Docker 镜像名称：必须包含 tag，例如
nginx:1.21、ghcr.io/user/app:v1.0.0。输入后点击 验证（或离开输入框时自动验证），平台会检查镜像能否拉取，并自动读取镜像暴露的 TCP 端口。 - 镜像认证：私有镜像需要勾选此项，并在下拉框中选择已保存的注册表凭证。没有凭证时选择 添加注册表 直接新建，详见 容器注册表。
构建环境变量（可选）
展开 构建环境变量 添加键值对。这些变量只在构建阶段生效。应用运行时需要的配置文件、密钥，请在创建后通过 配置/密钥 挂载。
3、计算资源
在 计算资源 面板中选择 规格。每张规格卡片显示日价、约合月价、CPU 和内存：
- 规格按天计费，详见 定价与计费。
- 实例数固定为 1。
持久卷
容器重启后本地文件会丢失。需要保存上传文件、SQLite 数据库等数据时，点击 新增持久卷：
| 字段 | 规则 |
|---|---|
| 名称 | 小写字母、数字和 -，以字母或数字开头和结尾，最长 63 个字符，例如 data |
| 容量 | 1 ~ 100 GiB，默认 10 GiB |
| 挂载路径 | 以 / 开头，不能以 / 结尾，不能包含 //、. 或 .. 路径段，例如 /data |
每个应用最多 5 个持久卷，名称和挂载路径都不能重复。持久卷按存储单价计费。
4、部署
点击 部署 并确认。表单校验失败时会弹出提示，按提示修改后重试。部署成功后返回应用列表，等待构建和启动完成，即可通过 应用名-xxxx.maozi.io 访问。
部署之后
更新于