cloady文档
文档阅读约 4 分钟

简介

Cloady 是什么、各部分如何协同工作,以及部署应用的三种方式。

Cloady 替你运行应用,让你无需自己管理服务器。注册账号、创建工作区,然后部署 — 无论是 WordPress 网站、Node API 还是 Postgres 数据库。构建、网络、HTTPS、日志和指标都已内置:既有 VPS 的简单,又有托管部署的便利。

基本模型

工作区包含你的成员、集成和账单。其中每个应用都会声明自己需要的 vCPU、RAM 和磁盘 — 即 compose 文件中的资源上限乘以你选择的缩放倍数 — 工作区支付的费用则取决于这些资源的总和。

你无需选择套餐。资源总量按四档套餐计价,落在两档之间的,价格也介于两者之间 — 参见容量与价格。所有区域价格相同;如果工作区中所有应用的资源合计不超过 0.5 vCPU、1 GB 内存和 5 GB SSD,就无需付费。你为应用声明的资源付费,而不是为它们实际用掉的资源付费。免费额度每月包含 200 GB 出站 HTTP 流量,付费容量则包含不限量的网络流量。

新工作区可以部署到任意区域 — 美国西部、美国东部、德国或新加坡。区域只是应用运行的位置,在部署该应用时选择;不需要事先开通任何东西。

Workspace  —  members, integrations, one bill for what its apps declare
 └─ Application  —  runs in one region, in one environment
     └─ Services  —  the containers the app is made of

每个应用运行在一个区域和一个环境(production、preview 或 development)中,应用名称在同一工作区和环境内唯一。一个应用由一个或多个服务(容器)组成:例如,一个 WordPress 应用包含一个 wordpress 服务和一个 mariadb 服务,你可以分别查看每个服务的状态和日志,也可以单独在其中打开终端。每个应用一启动,就会拥有 HTTPS、实时日志、指标和一个 URL。

重命名应用会改变它的 URL,因为地址会随名称变化。重命名也是安全的做法 — 千万不要为了重命名而删除应用,因为删除应用会永久删除它的数据。

只有一种情况会阻止部署,而且错误信息会明确说明:

  • payment_required — 该应用会让工作区超出免费额度,而目前没有绑定银行卡,或银行卡扣款被拒。工作区所有者可以在 Account → Billing 中添加银行卡,你也可以调小应用的规格。

三种部署方式

  • GitHub 仓库 — 连接仓库后,每次推送时 Cloady 都会构建并部署你的分支。
  • 拖放文件夹 — 把本机上的项目文件夹拖进来,构建方式完全相同。
  • 模板目录 — 挑选一个现成的应用(WordPress、Postgres、n8n、Supabase 等)并安装。
三种部署来源汇入同一条创建路径和同一条流水线GitHub 仓库你的分支,推送即构建拖放文件夹打包成 zip,构建方式相同模板目录现成应用,原样安装三者共用一条创建路径POST /api/workspaces/{workspaceSlug}/deploy仓库或文件夹模板目录 — 无需构建构建railpack,或仓库中已有的 Dockerfile配置容器、存储卷和路由,全部自动配置到位上线在你的主机名上提供服务,并带有 TLS、日志和指标

这三种方式都可以在控制台中使用,也可以在终端里通过 cloady deploy 完成。

两个域名

  • cloady.com — 控制台:你的工作区、应用、日志、指标、团队和账单都在这里。工作区的地址形如 cloady.com/w/acme。
  • cloady.io — 你的应用在这里对外提供服务。每个应用都会在这里获得一个主机名:
my-blog-k7q2v9ze-acme.cloady.io

它由应用名称、一段唯一的短代码和工作区名称组成,所有区域和环境都一样。你也可以为应用绑定自己的域名 — 无论哪种方式,HTTPS 都会自动配置好。

cloady.io 上应用主机名的构成<slug>-<hash8>-<workspaceSlug>.<apex>示例:工作区“acme”中的应用“My Blog”my-blog-k7q2v9ze-acme.cloady.io根域名 — 所有区域和环境都使用 cloady.io工作区 slug — 同样最多 24 个字符唯一短代码 — 确保两个应用永远不会共用同一个地址应用 slug — 重命名时随应用名称变化,最多 24 个字符重命名应用后,这个地址会随新名称一起改变。这里已为你配置好 HTTPS,你绑定的自有域名也一样。

下一步

  • 快速入门 — 创建你的第一个工作区,并上线一个应用。
  • 核心概念 — 工作区、容量与价格、应用、区域和环境。
  • 控制台指南 — 熟悉控制台的各个部分,并管理你的应用。
  • API 参考 — 所有端点,附带请求调试工具。
  • CLI 参考 — 在终端中部署应用、实时查看日志和管理应用。
  • Terraform Provider — 以代码形式声明工作区、应用、变量和域名。
  • MCP 服务器 — 用 AI 智能体操作 Cloady。

本页内容