> ## Documentation Index
> Fetch the complete documentation index at: https://agdiai-597e782f.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# DigitalOcean

# 在 DigitalOcean 上运行 Agdi

## 目标

在 DigitalOcean 上以 **每月 6 美元**（或预留定价时每月 4 美元）运行一个持久化的 Agdi Gateway 网关。

如果你想要每月 0 美元的方案，并且不介意 ARM + 提供商特定设置，请参阅 [Oracle Cloud 指南](https://agdiai-597e782f.mintlify.site/platforms/oracle.md)。

## 成本对比（2026）

| 提供商 | 套餐 | 规格 | 每月价格 | 说明 |
| - | - | - | - | - |
| Oracle Cloud | Always Free ARM | 最多 4 OCPU，24 GB RAM | \$0 | ARM，容量有限 / 注册流程有些麻烦 |
| Hetzner | CX22 | 2 vCPU，4 GB RAM | €3.79（约 \$4） | 最便宜的付费选项 |
| DigitalOcean | Basic | 1 vCPU，1 GB RAM | \$6 | UI 简单，文档完善 |
| Vultr | Cloud Compute | 1 vCPU，1 GB RAM | \$6 | 机房位置多 |
| Linode | Nanode | 1 vCPU，1 GB RAM | \$5 | 现已并入 Akamai |

**如何选择提供商：**

* DigitalOcean：最简单的 UX + 可预测的设置（本指南）
* Hetzner：性价比不错（见 [Hetzner guide](https://agdiai-597e782f.mintlify.site/install/hetzner.md)）
* Oracle Cloud：可能做到每月 0 美元，但更挑环境且仅支持 ARM（见 [Oracle guide](https://agdiai-597e782f.mintlify.site/platforms/oracle.md)）

***

## 前提条件

* DigitalOcean 账号（[注册可获 200 美元免费额度](https://m.do.co/c/signup)）
* SSH 密钥对（或愿意使用密码认证）
* 约 20 分钟

## 1）创建 Droplet

> [!WARNING]
>
> 请使用干净的基础镜像（Ubuntu 24.04 LTS）。除非你已经检查过其启动脚本和防火墙默认设置，否则请避免使用第三方 Marketplace 一键镜像。

1. 登录 [DigitalOcean](https://cloud.digitalocean.com/)
2. 点击 **Create → Droplets**
3. 选择：
   * **Region：** 离你（或你的用户）最近
   * **Image：** Ubuntu 24.04 LTS
   * **Size：** Basic → Regular → **\$6/mo**（1 vCPU、1 GB RAM、25 GB SSD）
   * **Authentication：** SSH key（推荐）或密码
4. 点击 **Create Droplet**
5. 记下 IP 地址

## 2）通过 SSH 连接

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
ssh root@YOUR_DROPLET_IP
```

## 3）安装 Agdi

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# 更新系统
apt update && apt upgrade -y

# 安装 Node.js 24
curl -fsSL https://deb.nodesource.com/setup_24.x | bash -
apt install -y nodejs

# 安装 Agdi
curl -fsSL https://agdi.ai/install.sh | bash

# 验证
agdi --version
```

## 4）运行新手引导

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
agdi onboard --install-daemon
```

向导会带你完成以下设置：

* 模型认证（API key 或 OAuth）
* 渠道设置（Telegram、WhatsApp、Discord 等）
* Gateway 网关 token（自动生成）
* 守护进程安装（systemd）

## 5）验证 Gateway 网关

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# 检查状态
agdi status

# 检查服务
systemctl --user status agdi-gateway.service

# 查看日志
journalctl --user -u agdi-gateway.service -f
```

## 6）访问 Dashboard

Gateway 网关默认绑定到 loopback。要访问 Control UI：

**选项 A：SSH 隧道（推荐）**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# 在你的本地机器上
ssh -L 18789:localhost:18789 root@YOUR_DROPLET_IP

# 然后打开：http://localhost:18789
```

**选项 B：Tailscale Serve（HTTPS，仅 loopback）**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# 在 droplet 上
curl -fsSL https://tailscale.com/install.sh | sh
tailscale up

# 将 Gateway 网关配置为使用 Tailscale Serve
agdi config set gateway.tailscale.mode serve
agdi gateway restart
```

打开：`https://<magicdns>/`

说明：

* Serve 会让 Gateway 网关保持仅 loopback，并通过 Tailscale 身份头对 Control UI/WebSocket 流量进行认证（无 token 认证假定 Gateway 网关主机可信；HTTP API 仍然需要 token/password）。
* 如果你想强制要求 token/password，请设置 `gateway.auth.allowTailscale: false` 或使用 `gateway.auth.mode: "password"`。

**选项 C：绑定到 tailnet（不使用 Serve）**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
agdi config set gateway.bind tailnet
agdi gateway restart
```

打开：`http://<tailscale-ip>:18789`（需要 token）。

## 7）连接你的渠道

### Telegram

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
agdi pairing list telegram
agdi pairing approve telegram <CODE>
```

### WhatsApp

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
agdi channels login whatsapp
# 扫描 QR 码
```

其他提供商请参阅 [Channels](https://agdiai-597e782f.mintlify.site/channels.md)。

***

## 针对 1 GB RAM 的优化

6 美元的 droplet 只有 1 GB RAM。为了保持运行顺畅：

### 添加 swap（推荐）

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
fallocate -l 2G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
echo '/swapfile none swap sw 0 0' >> /etc/fstab
```

### 使用更轻量的模型

如果你遇到 OOM，可以考虑：

* 使用基于 API 的模型（Claude、GPT），而不是本地模型
* 将 `agents.defaults.model.primary` 设置为更小的模型

### 监控内存

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
free -h
htop
```

***

## 持久化

所有状态都存储在：

* `~/.agdi/` — 配置、凭证、会话数据
* `~/.agdi/workspace/` — 工作区（`SOUL.md`、memory 等）

这些内容在重启后仍会保留。请定期备份：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
tar -czvf agdi-backup.tar.gz ~/.agdi ~/.agdi/workspace
```

***

## Oracle Cloud 免费替代方案

Oracle Cloud 提供 **Always Free** ARM 实例，性能显著强于这里列出的任何付费选项 —— 且每月 0 美元。

| 你将获得 | 规格 |
| - | - |
| **4 OCPU** | ARM Ampere A1 |
| **24 GB RAM** | 完全足够 |
| **200 GB 存储** | 块存储卷 |
| **永久免费** | 不会产生信用卡费用 |

**注意事项：**

* 注册过程可能比较挑剔（如果失败请重试）
* ARM 架构 —— 大多数东西都能运行，但某些二进制文件需要 ARM 构建版本

完整设置指南请参阅 [Oracle Cloud](https://agdiai-597e782f.mintlify.site/platforms/oracle.md)。关于注册技巧和注册流程故障排除，请参阅这篇[社区指南](https://gist.github.com/rssnyder/51e3cfedd730e7dd5f4a816143b25dbd)。

***

## 故障排除

### Gateway 网关无法启动

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
agdi gateway status
agdi doctor --non-interactive
journalctl -u agdi --no-pager -n 50
```

### 端口已被占用

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
lsof -i :18789
kill <PID>
```

### 内存不足

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# 检查内存
free -h

# 添加更多 swap
# 或升级到每月 12 美元的 droplet（2 GB RAM）
```

***

## 另请参阅

* [Hetzner guide](https://agdiai-597e782f.mintlify.site/install/hetzner.md) — 更便宜、性能更强
* [Docker install](https://agdiai-597e782f.mintlify.site/install/docker.md) — 容器化设置
* [Tailscale](https://agdiai-597e782f.mintlify.site/gateway/tailscale.md) — 安全的远程访问
* [Configuration](https://agdiai-597e782f.mintlify.site/gateway/configuration.md) — 完整配置参考


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.