从 GitHub 启动您的第一个应用。
连接 GitHub,选择仓库,选择资源和地址,几分钟即可上线——您的第一个应用可享受 3 天免费试用。
应用直接从您的 Git 仓库运行您自己的代码——网站、API、后台任务。您无需选择服务器或主机套餐:只需选择仓库,我们会确定如何构建和运行,每次推送都会自动上线。
一切操作都在新版控制面板中完成(rivervo.com/panel)→ 应用 → 新建应用。
1. 连接您的 Git 账户
GitHub 始终可用。点击连接 GitHub:GitHub 会询问将 Rivervo 安装到哪里(您的个人账户或某个组织),以及允许它读取哪些仓库。我们不会向您的仓库写入任何内容。
之前已在 GitHub 上安装过 Rivervo?请使用已在 GitHub 上安装?关联它。
在可用的情况下,GitLab 和 Bitbucket 会以额外按钮的形式显示在仓库列表上方。连接方式相同:允许 Rivervo 读取您的仓库,并添加用于自动部署的 Webhook。您的代码绝不会被修改。
2. 选择仓库
搜索您的仓库,点击要部署的仓库,然后选择:
- 分支——上线的分支。每次推送到该分支都会自动部署。
- 项目目录——仅用于包含多个项目的仓库(monorepo),例如
apps/web。项目位于根目录时请留空。
点击继续。
还没有仓库?或从模板开始会使用我们的模板之一——Next.js、Laravel、Express、Flask 或静态网站——在您的 GitHub 账户中创建新仓库。代码归您所有,推送即可部署更改。
3. 我们能识别什么
我们读取仓库并确定如何构建和启动它。您无需编写任何配置。我们能识别:
| 技术栈 | 识别依据 |
|---|---|
| Node.js | Next.js、Nuxt、SvelteKit、Astro、Express、Fastify、Koa、Hono、NestJS;根据锁文件识别 npm、yarn 或 pnpm |
| PHP | Laravel、Symfony、Slim、CodeIgniter 或原生 PHP(8.2–8.4) |
| Python | Django、Flask、FastAPI |
| Go | 根目录下的 go.mod |
| 静态网站 | 纯 HTML,或前端构建:Vite(React、Vue、Svelte)、Create React App、Angular、Gatsby、Docusaurus、VitePress、Next.js 或 Nuxt 的静态导出 |
如果您的仓库有自己的 Dockerfile,我们会直接用它构建——这也是运行列表之外技术栈的方式。
您可以稍后在设置 → 构建设置中修改检测到的安装、构建和启动命令。各技术栈的说明:Laravel、Node.js、Next.js 和 Nuxt、Python、静态网站。
4. 资源与价格
通过三个滑块按应用需要选择资源:
| 资源 | 价格 | 范围 |
|---|---|---|
| 内存 | 每月每 GB ¥39.99 | 256 MB、512 MB,之后按整 GB 递增,最高 16 GB |
| CPU | 每月每核 ¥26.66 | 1 至 8 核 |
| 磁盘 | 每 GB 内存含 10 GB,超出部分每月每 GB ¥1.00 | 5 至 500 GB,以 5 GB 为单位 |
几个示例:
| 内存 | CPU | 磁盘 | 每月 |
|---|---|---|---|
| 512 MB | 1 核 | 5 GB | ¥46.66 |
| 1 GB | 1 核 | 10 GB | ¥66.66 |
| 2 GB | 2 核 | 20 GB | ¥133.31 |
| 4 GB | 2 核 | 60 GB | ¥233.30 |
拖动滑块时,控制面板会显示每月合计。之后可随时调整资源,应用数据不受影响。每个项目每月还包含 500 GB 流量——请参阅应用的计费方式。
5. 地址
选择应用的访问方式——默认不预选:
- 公网地址——通过带 HTTPS 的免费地址
https://<name>.rivervo.app从互联网访问。启动后可以绑定您自己的域名——请参阅自定义域名。 - 仅内部访问——没有互联网地址;只有应用的其他服务可以访问。适合由应用中其他服务调用的 API 或后端——请参阅服务之间的通信。
选择名称(小写拉丁字母、数字和短横线,3–42 个字符);控制面板会立即告诉您该名称是否可用。之后可在设置 → 公网地址中切换这两种方式。
6. 启动——以及免费试用
点击启动并添加您的银行卡。您的第一个应用可享受 3 天免费试用:这 3 天内不会扣款,试用结束时收取第一笔费用。此后应用按显示的价格按月计费。
每个账户只能享受一次试用——用于您启动的第一个应用。
7. 首次部署
启动后,控制面板会实时显示每个步骤:获取代码、安全检查、构建、启动和启用地址。通常需要几分钟。每次发布前,我们都会检查代码中是否藏有恶意代码;含有恶意代码的项目不会被构建或运行。
部署完成后,点击打开即可访问已上线的应用(适用于有公网地址的应用)。
如果启动未完成,控制面板会显示出错的步骤和日志。在代码或变量中修复问题后,点击重试——不会额外收费。解释此错误会简要说明日志内容及修复方法(请参阅开发者工具)。