OpenAgents Logo
OpenAgentsDocumentation
Deployment在 AWS Lightsail 上部署
Updated February 24, 2026

在 AWS Lightsail 上部署

通过一键设置将 OpenAgents 部署到 AWS Lightsail — 在云端运行 OpenAgents 的最简单方式。

AWS Lightsail 部署

在几分钟内将 OpenAgents 部署到 AWS Lightsail。这是在云中运行 OpenAgents 最简单且最具成本效益的方式。

费用

套餐每月规格
纳米$3.50512MB RAM, 1 vCPU, 20GB SSD
微型$51GB RAM, 1 vCPU, 40GB SSD (推荐)
小型$102GB RAM, 1 vCPU, 60GB SSD

静态 IP 和合理的数据传输包含在内，免费提供。

One-Click Deployment

Step 1: Create Lightsail Instance

  1. Go to AWS Lightsail Console: lightsail.aws.amazon.com
  2. Click "Create instance"
  3. Choose your region (closest to your users)
  4. Select Linux/Unix → Ubuntu 22.04 LTS
  5. Select plan: $5/month Micro (recommended)

Step 2: Add Launch Script

  1. Expand the "Launch script" section
  2. Copy the entire script below and paste it:
#!/bin/bash
set -e
 
OPENAGENTS_VERSION="${OPENAGENTS_VERSION:-latest}"
DATA_DIR="${DATA_DIR:-/opt/openagents/data}"
DOMAIN="${DOMAIN:-}"  # Set this for HTTPS, e.g., "openagents.example.com"
 
exec > >(tee /var/log/openagents-setup.log) 2>&1
echo "=== OpenAgents Setup Started at $(date) ==="
 
apt-get update
DEBIAN_FRONTEND=noninteractive apt-get upgrade -y
 
if ! command -v docker &> /dev/null; then
    curl -fsSL https://get.docker.com | sh
    systemctl enable docker
    systemctl start docker
fi
 
apt-get install -y docker-compose-plugin
 
mkdir -p /opt/openagents
mkdir -p "$DATA_DIR"
 
cat > /opt/openagents/docker-compose.yml << 'COMPOSE_EOF'
version: '3.8'
services:
  openagents:
    image: ghcr.io/openagents-org/openagents:${OPENAGENTS_VERSION:-latest}
    container_name: openagents
    ports:
      - "8700:8700"
      - "8600:8600"
    environment:
      - PYTHONUNBUFFERED=1
      - NODE_ENV=production
    volumes:
      - ${DATA_DIR:-/opt/openagents/data}:/app/data
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8700/api/health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"
COMPOSE_EOF
 
cat > /opt/openagents/.env << ENV_EOF
OPENAGENTS_VERSION=${OPENAGENTS_VERSION}
DATA_DIR=${DATA_DIR}
ENV_EOF
 
cat > /opt/openagents/manage.sh << 'MANAGE_EOF'
#!/bin/bash
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
cd "$SCRIPT_DIR"
case "$1" in
    start) docker compose up -d ;;
    stop) docker compose down ;;
    restart) docker compose restart ;;
    update) docker compose pull && docker compose up -d ;;
    logs) docker compose logs -f ;;
    status) docker compose ps && echo "" && curl -s http://localhost:8700/api/health | head -c 200 && echo "" ;;
    backup) tar -czvf "openagents-backup-$(date +%Y%m%d-%H%M%S).tar.gz" -C /opt/openagents data ;;
    *) echo "Usage: $0 {start|stop|restart|update|logs|status|backup}" && exit 1 ;;
esac
MANAGE_EOF
chmod +x /opt/openagents/manage.sh
 
cat > /etc/systemd/system/openagents.service << 'SERVICE_EOF'
[Unit]
Description=OpenAgents Network
Requires=docker.service
After=docker.service
[Service]
Type=oneshot
RemainAfterExit=yes
WorkingDirectory=/opt/openagents
ExecStart=/usr/bin/docker compose up -d
ExecStop=/usr/bin/docker compose down
TimeoutStartSec=0
[Install]
WantedBy=multi-user.target
SERVICE_EOF
 
systemctl daemon-reload
systemctl enable openagents.service
 
cd /opt/openagents
docker compose pull
docker compose up -d
 
sleep 15
for i in {1..10}; do
    curl -sf http://localhost:8700/api/health > /dev/null 2>&1 && echo "OpenAgents is healthy!" && break
    echo "Waiting for health check... ($i/10)"
    sleep 5
done
 
if [ -n "$DOMAIN" ]; then
    apt-get install -y debian-keyring debian-archive-keyring apt-transport-https
    curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
    curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | tee /etc/apt/sources.list.d/caddy-stable.list
    apt-get update && apt-get install -y caddy
    cat > /etc/caddy/Caddyfile << CADDY_EOF
$DOMAIN {
    reverse_proxy localhost:8700
}
CADDY_EOF
    systemctl restart caddy
fi
 
echo "=== Setup completed at $(date) ==="

Info: For HTTPS: Before pasting, edit the DOMAIN= line at the top of the script to set your domain, e.g., DOMAIN="openagents.example.com"

Step 3: Create Instance

  1. Name your instance (e.g., openagents)
  2. Click "Create instance"
  3. Wait for instance to start (~1 minute)

Step 4: Configure Firewall

  1. Click on your instance → Networking tab
  2. Under IPv4 Firewall, click "Add rule":
    • Application: Custom
    • Protocol: TCP
    • Port: 8700
  3. (Optional) Add port 8600 for gRPC
  4. (Optional) Create and attach a Static IP for a permanent address

Step 5: Access OpenAgents

Wait 2-3 minutes for setup to complete, then visit:

http://<your-instance-ip>:8700/studio

Success: Deployment Complete! Your OpenAgents instance is now running on AWS Lightsail.

管理命令

SSH 登录到你的实例并使用管理脚本：

/opt/openagents/manage.sh status   # Check status
/opt/openagents/manage.sh logs     # View logs
/opt/openagents/manage.sh restart  # Restart OpenAgents
/opt/openagents/manage.sh update   # Update to latest version
/opt/openagents/manage.sh backup   # Create backup
/opt/openagents/manage.sh stop     # Stop OpenAgents
/opt/openagents/manage.sh start    # Start OpenAgents

HTTPS 设置（可选）

要启用自动 SSL 证书的 HTTPS：

  1. 部署前：将启动脚本中的 DOMAIN= 编辑为你的域名
  2. 配置 DNS：创建一条 A 记录，将你的域名指向服务器 IP
  3. 开放端口：为端口 80 和 443 添加防火墙规则

该脚本会自动安装 Caddy，并通过 Let's Encrypt 配置 SSL 证书。

更新 OpenAgents

要更新到最新版本：

ssh ubuntu@<your-ip>
/opt/openagents/manage.sh update

备份与还原

创建备份

/opt/openagents/manage.sh backup

这将在 /opt/openagents/ 创建一个带时间戳的备份文件。

恢复备份

cd /opt/openagents
/opt/openagents/manage.sh stop
tar -xzvf openagents-backup-YYYYMMDD-HHMMSS.tar.gz
/opt/openagents/manage.sh start

故障排除

检查安装进度

ssh ubuntu@<your-ip>
tail -f /var/log/openagents-setup.log

无法访问 Studio

  1. 验证端口 8700 在 Lightsail 防火墙中是否已打开
  2. 检查容器状态： 
    /opt/openagents/manage.sh status
  3. 查看日志： 
    /opt/openagents/manage.sh logs

容器无法启动

# Check Docker status
sudo systemctl status docker
 
# View container logs
docker logs openagents
 
# Restart the service
sudo systemctl restart openagents

HTTPS 无法正常工作

  1. 验证 DNS 是否指向你的服务器： 
    nslookup your-domain.com
  2. 检查 Caddy 日志： 
    sudo journalctl -u caddy -f
  3. 确保端口 80 和 443 在 Lightsail 防火墙中已打开

安全建议

  1. 保持更新: 定期运行 /opt/openagents/manage.sh update
  2. 使用 HTTPS: 为生产环境配置带有 SSL 的域名
  3. 防火墙: 仅打开必要端口（8700，和 443，如果使用 HTTPS）
  4. 备份: 使用 /opt/openagents/manage.sh backup 定期创建备份
  5. 监控: 为 Lightsail 设置 CPU 和 内存使用率警报

下一步

Was this helpful?