快速开始

本文带你接入一台服务器，并从 GitHub 部署一个应用。

1. 创建账号

在 zenavo.app 用邮箱、GitHub 或 Google 注册。

用邮箱和密码注册的话，请先打开 Zenavo 发给你的邮件里的链接：邮箱验证之前，你不能添加服务器，也不能部署。

2. 添加服务器

你需要一台有公网 IP 的 Linux 服务器，至少 1 核 CPU、2 GB 内存。详见服务器要求。

1. 在控制台打开 服务器 → 添加服务器。
2. 填写服务器的 IP 地址、SSH 端口和用户（例如 root，大多数云镜像上是 ubuntu）。
3. 选择 密码 或 私钥。可以上传密钥文件（例如 ~/.ssh/id_ed25519，或云服务商提供的 .pem 文件），也可以直接粘贴。
4. 点击 连接并初始化。Zenavo 会检查服务器，安装 K3s 和 cert-manager，并在服务器的 状态 标签页显示进度。初始化需要几分钟。

3. 创建项目

1. 打开 项目 → 新建项目。
2. 选择服务器。项目名称可以不填，留空会自动生成一个。
3. 点击 创建项目。项目打开时是空的。

4. 添加服务

1. 点击 添加服务（或按 ⌘ K）。
2. 选择 GitHub。第一次使用时，点击 连接 GitHub，选择 Zenavo 可以读取的仓库。
3. 选择仓库，再选择分支。
4. 在 配置构建计划 中检查服务名称和根目录，如果应用需要环境变量就在这里添加。点击 下一步。
5. 构建计划预览 显示 Zenavo 识别出的内容，例如 Go 1.26。点击 部署。

服务会依次显示 等待中、构建中、部署中、启动中，最后是 运行中。打开 日志 可以查看构建过程。

5. 绑定域名

打开服务的 网络 标签页，点击 绑定自己的域名。把域名的 A 记录指向服务器的 IP 地址；解析生效后会自动签发 HTTPS 证书。详见域名与 HTTPS。