快速入门

登录

访问 cloady.com，使用邮箱和密码、Google、GitHub 或你公司的 SSO 登录。要创建账号或重置密码，请选择 Create account or reset password，验证邮箱收到的验证码，然后设置密码。已有密码的账号登录时不需要邮箱验证码。你也可以在登录前从 cloady.com 上的部署输入框开始：先在那里配置好应用，点击 Deploy 时会在当前页面内要求你登录，然后完成部署。

首次登录会创建你的账号，并要求你验证手机号：先输入号码，再输入短信收到的验证码。每个账号都必须完成一次验证；在完成之前，控制台会一直把你带回这个页面，API 也会返回 phone_required（403）。之后，你会进入 Cloady 为你创建的第一个工作区；在你部署之前，它是空的。

创建工作区

工作区包含你的应用、你的团队和一份订阅，并有自己的地址，例如 cloady.com/w/acme-inc。你的第一个工作区已经存在。要再添加一个，请点击顶部栏中的 WORKSPACE 切换器，然后点击 New workspace：

1. Name — 例如 Acme Inc。URL 中使用的名称根据它生成，并会实时显示；如果该名称已被占用，你会看到调整后的版本。
2. Icon · optional — 点击弹窗标题栏中的图块上传图标。图标也会决定工作区的配色。

新工作区不产生任何费用，并且可以立即部署。工作区的费用取决于其应用声明的资源，按四档套餐计价（参见容量与价格）；只要工作区的应用总量不超过 0.5 vCPU、1 GB 内存和 5 GB SSD，就无需付费。

一份订阅覆盖所有区域，无需按区域逐一开通。

选择区域和环境

每个应用都只在一个区域和一个环境中运行，两者都在部署时选定。你可以在顶部栏中设置它们；新应用默认使用顶部栏中当前选中的值，部署前你也可以在应用卡片上改选其他区域。

• 区域（Region） — 应用运行的地方，可选美国西部、美国东部、德国或新加坡。菜单会列出 Deployed 区域（你已有应用的区域）和 Available 区域；切换区域也会筛选控制台中显示的内容。应用会一直留在它的区域，除非你用 Transfer 迁移它；要在第二个区域运行同一个应用，请在那里也部署一次。
• 环境（Environment） — Production（生产）、Preview（预览）或 Development（开发）。在同一工作区的同一环境中，应用名称是唯一的，因此 api 可以同时存在于生产环境和预览环境中。开发环境中的应用会保留一份可编辑的代码副本，推送时不会重新部署。

你可能会遇到一种情况：

• 如果某个区域没有空闲容量，部署会显示 Adding capacity…，等待一台服务器加入该区域，然后自动继续，通常只需几分钟。如果大约 40 分钟后仍无法调度，部署就会失败，请重试。

部署应用

点击顶部栏中的 New application，然后在输入框中指定要部署的内容：

• 模板 — 预先构建好的应用（WordPress、Postgres 等）；输入关键词搜索，然后点击其中一个。
• GitHub 仓库 — 粘贴仓库 URL，或从你的仓库中选择一个。公开仓库可以直接部署；私有仓库需要先选择 Connect GitHub account。
• Docker 镜像 — 输入镜像名称（nginx、ghcr.io/acme/api:1.4），或输入 docker.io/ 这样的镜像仓库来浏览热门镜像。
• 文件夹 — 直接拖进来，最大 50 MB、最多 3000 个文件（node_modules、.git、.next、__pycache__ 和 .DS_Store 会被跳过）。适合已经构建好的静态网站，无需 git。

输入框随后会变成应用卡片：顶部是你选择的内容、每月价格和部署按钮，下方是它要运行的服务。部署之前，可以打开 Settings 下的任意一行进行修改：

• Environment — 填写变量；模板会列出它们需要的变量，并可以为你生成密码。
• Build — 适用于代码来源，包括分支、根目录，以及可选的 build 和 start 命令。除非自动检测判断有误，否则请将这两项留空；判断失误常见于 monorepo 以及构建位于子文件夹中的项目。对于 GitHub 来源，Redeploy on every push 默认开启。
• Domains — 应用名称（地址会跟随它变化），以及要绑定的自定义域名。
• Resources、Region 和 Managed backups — 分别是缩放倍数、运行位置，以及每日备份（价格为应用本身价格的 20%）。

按 Enter 或点击 Deploy。在免费额度内不收费。超出额度后，会从已绑定的银行卡扣取本月剩余时间的费用；如果还没有绑定银行卡，Deploy 会先要求你添加一张；如果扣款被拒，则返回 payment_required（402），且不会创建任何东西。

Cloady 会构建应用，为你配置好 HTTPS，并通过一个 cloady.io 地址提供服务。这个地址由应用名、一段唯一的短代码和工作区名组成：

<app-name>-<code>-<workspace>.cloady.io

因此，工作区 acme 中名为 My Blog 的应用可以通过以下地址访问：

my-blog-k7q2v9ze-acme.cloady.io

所有环境和所有区域都使用相同的格式；确切的 URL 显示在应用页面上。

弹窗会实时显示部署过程，同时应用会出现在工作区的应用网格中。配置和所有自动生成的密钥都位于 Settings → Environment。

重命名应用

在 Settings → General 中重命名。地址会跟随名称变化，因此旧主机名会停止响应，新主机名开始生效；请更新所有用到旧主机名的链接、DNS 记录和 API 调用。（Slug 字段就是出现在 URL 中的那部分；一旦你自己设置了它，它就不再跟随名称变化。）

切勿为了重命名而删除应用。删除应用会永久销毁它的数据，包括所有服务、存储卷、环境变量、域名和部署记录，且无法撤销。删除对话框会要求你输入应用的 slug 进行确认。

添加自定义域名

要让应用通过你自己的主机名提供服务，请打开 Settings → Domains。

1. 输入主机名（例如 app.yourdomain.com），然后点击 Add domain。如果这个域名应该转发到其他地方，而不是提供应用本身，请勾选 Redirect to another host (permanent)。
2. 借助 DNS configuration 面板把 DNS 指向 Cloady，面板会显示需要复制的确切记录：
   • CNAME（默认） — 一条指向应用内置 cloady.io 主机名的记录。最适合子域名。
   • A / AAAA — 用于根域名（apex），因为根域名不能使用 CNAME。请严格按照显示的内容添加这两条记录。
3. DNS 解析生效后，Cloady 会自动为该主机名配置 HTTPS。域名所在的行会显示进度：queued → pending → issued（TLS · active）。出现 failed（TLS · error）几乎总是因为 DNS 还没有指向 Cloady；修正记录后会自动重试。

内置的 cloady.io 主机名会与你的域名同时可用。你也可以在部署时通过卡片的 Domains 行绑定域名；那里的 Check DNS 会告诉你记录是否已经指向 Cloady。

用 CLI、API、Terraform 或 MCP 实现自动化

控制台中的一切操作都可以通过脚本完成。

• CLI — 运行 npm install -g cloady 和 cloady login，然后运行 cloady deploy github.com/your-org/your-repo。参见 CLI 参考。
• REST API — 使用个人 API 令牌创建工作区、部署应用、管理域名和实时查看日志。参见 API 概览和端点参考。
• Terraform — 以代码形式声明工作区、应用、环境变量和域名，然后运行 terraform apply。参见 Terraform Provider 指南。
• MCP 服务器 — 让 AI 智能体来操作 Cloady，同样的操作以工具形式提供。参见 MCP 服务器指南。