运行 AI 代码。
为您的 AI 生成代码提供安全且弹性的基础设施。

文档 · 报告 Bug · 请求功能 · 加入我们的 Slack · 在 X 上联系

 

Daytona 是一个用于执行 AI 生成代码和代理工作流的安全、弹性的基础设施运行时。我们的开源平台提供 沙箱，即完全隔离的可组合计算机，拥有独立的内核、文件系统、网络栈以及分配的 vCPU、RAM 和磁盘。

沙箱是 Daytona 平台的核心组件，能够在不到 90 毫秒内从代码启动并开始执行，并支持 Python、TypeScript 和 JavaScript 等多种语言的代码运行。基于 OCI/Docker 兼容性、大规模并行化以及无限持久化的特性，沙箱为代理工作流提供了稳定、可预测的环境。

代理和开发者可以通过 Daytona 的 SDKs、API 和 CLI 以编程方式与沙箱交互。操作范围涵盖沙箱生命周期管理、文件系统操作、进程与代码执行，以及通过基础镜像、软件包和工具进行运行时配置。我们提供的有状态环境 快照 能够在会话之间保持代理的持续运行，使 Daytona 成为构建 AI 代理架构的理想基础。

功能

Daytona 提供了丰富的功能和工具来与沙箱交互。

• 平台：为采用 Daytona 标准化的组织提供治理和运营控制
• 沙箱：隔离的完整可组合计算机，用于执行工作负载并保留状态
• 代理工具：面向应用代码、代理和集成的程序化能力
• 人类工具：用于与沙箱交互的界面和远程会话
• 系统工具：用于生命周期事件和网络访问的平台级钩子和控制

平台	沙箱	代理工具	人类工具	系统工具
组织	环境	进程与代码执行	仪表板	Webhooks
API 密钥	快照	文件系统操作	Web 终端	网络限制
限制	声明式构建器	语言服务器协议	SSH 访问
计费	卷	计算机使用	VNC 访问
审计日志	区域	MCP 服务器	VPN 连接
OpenTelemetry		Git 操作	预览
集成		伪终端 (PTY)	自定义预览代理
安全展示		日志流	游乐场

架构

Daytona 平台由多个平面组件组成，每个组件都有特定的用途。每个组件的详细概述可在 架构文档 中找到。

• 界面平面：提供与 Daytona 交互的客户端接口
• 控制平面：编排所有沙盒操作
• 计算平面：运行和管理沙盒实例

应用程序

Daytona 平台可运行的应用程序和服务。每个目录都是一个可部署或可构建的组件，位于 apps 目录中。

• api：基于 NestJS 的 RESTful 服务；平台所有操作的主要入口
• cli：Go 命令行界面，用于访问核心功能以与沙盒交互
• daemon：在每个沙盒内运行的代码执行代理
• dashboard：用于可视化管理沙盒的 Web 用户界面
• docs：文档内容；网站发布于 daytona.io/docs
• otel-collector：用于收集 Daytona SDK 操作的跟踪和指标
• proxy：用于自定义路由和预览 URL 的反向代理
• runner：为 Daytona 计算平面提供动力并运行沙盒的计算节点
• snapshot-manager：编排沙盒快照的创建
• ssh-gateway：独立的 SSH 网关，接受经过身份验证的 ssh 连接

客户端库

客户端库通过面向开发者的 SDK 将 Daytona 平台集成到应用程序代码中，这些 SDK 由 OpenAPI 生成的 REST 客户端和工具箱 API 客户端支持。每个目录都是针对特定语言或运行时的可发布包，位于 libs 目录中。

Python

pip install daytona

使用 Python 与 Daytona 交互的独立包和库：

sdk-python • api-client-python • api-client-python-async • toolbox-api-client-python • toolbox-api-client-python-async

TypeScript

npm install @daytona/sdk

使用 TypeScript 与 Daytona 交互的独立包和库：

sdk-typescript • api-client • toolbox-api-client

Ruby

gem install daytona

使用 Ruby 与 Daytona 交互的独立包和库：

sdk-ruby • api-client-ruby • toolbox-api-client-ruby

Go

go get github.com/daytonaio/daytona/libs/sdk-go

使用 Go 与 Daytona 交互的独立包和库：

sdk-go • api-client-go • toolbox-api-client-go

Java

Gradle (build.gradle.kts):

dependencies {
    implementation("io.daytona:sdk:0.1.0")
}

Maven (pom.xml):

<dependency>
  <groupId>io.daytona</groupId>
  <artifactId>sdk</artifactId>
  <version>0.1.0</version>
</dependency>

使用 Java 与 Daytona 交互的独立包和库：

sdk-java • api-client-java • toolbox-api-client-java

部署

Daytona 可作为托管服务在 app.daytona.io 上使用。Daytona 可以作为完全托管的服务运行，也可以作为您自行运营的开源堆栈，或者在混合部署中运行，在这种情况下，Daytona 编排沙盒，而执行则在您管理的机器上进行。

• 开源部署：使用 Docker Compose 从 docker 目录中的完整本地堆栈
• 客户管理的计算：自定义区域和运行 Daytona 沙盒的运行器机器，部署在您自己的计算基础设施上

快速入门

1. 在 app.daytona.io 上创建一个账户
2. 生成一个 API 密钥
3. 创建一个沙盒

Python SDK

from daytona import Daytona, DaytonaConfig

config = DaytonaConfig(api_key="YOUR_API_KEY")
daytona = Daytona(config)
sandbox = daytona.create()
response = sandbox.process.code_run('print("Hello World!")')
print(response.result)

TypeScript SDK

import { Daytona } from "@daytona/sdk";

const daytona = new Daytona({ apiKey: "YOUR_API_KEY" });
const sandbox = await daytona.create();
const response = await sandbox.process.codeRun('print("Hello World!")');
console.log(response.result);

Ruby SDK

require 'daytona'

config = Daytona::Config.new(api_key: 'YOUR_API_KEY')
daytona = Daytona::Daytona.new(config)
sandbox = daytona.create
response = sandbox.process.code_run(code: 'print("Hello World!")')
puts response.result

Go SDK

package main

import (
  "context"
  "fmt"
  "github.com/daytonaio/daytona/libs/sdk-go/pkg/daytona"
  "github.com/daytonaio/daytona/libs/sdk-go/pkg/types"
)

func main() {
  config := &types.DaytonaConfig{APIKey: "YOUR_API_KEY"}
  client, _ := daytona.NewClientWithConfig(config)
  ctx := context.Background()
  sandbox, _ := client.Create(ctx, nil)
  response, _ := sandbox.Process.ExecuteCommand(ctx, "echo 'Hello World!'")
  fmt.Println(response.Result)
}

Java SDK

import io.daytona.sdk.Daytona;
import io.daytona.sdk.DaytonaConfig;
import io.daytona.sdk.Sandbox;
import io.daytona.sdk.model.ExecuteResponse;

public class Main {
  public static void main(String[] args) {
    DaytonaConfig config = new DaytonaConfig.Builder()
        .apiKey("YOUR_API_KEY")
        .build();
    try (Daytona daytona = new Daytona(config)) {
      Sandbox sandbox = daytona.create();
      ExecuteResponse response = sandbox.getProcess().executeCommand("echo 'Hello World!'");
      System.out.println(response.getResult());
    }
  }
}

API

curl 'https://app.daytona.io/api/sandbox' \
  --request POST \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{}'

CLI

daytona create

开发

Devcontainer（完整环境）

在兼容 devcontainer 的编辑器（VS Code、GitHub Codespaces）中打开此仓库，即可获得包含所有语言、工具和支持服务的开箱即用设置。

Nix（轻量级，适合代理）

如果您更喜欢在 devcontainer 外工作——或者您是执行构建命令的人工智能代理——请使用 Nix 开发 shell：

# 进入完整的开发 shell（Go + Node + Python + Ruby + JDK）
nix develop

# 或者选择特定语言的 Shell
nix develop .#go       # Go 服务与库
nix develop .#node     # TypeScript / Node.js 应用与库
nix develop .#python   # Python SDK 与库
nix develop .#ruby     # Ruby SDK 与库
nix develop .#java     # Java SDK 与库

前置条件： 安装 Nix 并启用 Flakes 功能（在 ~/.config/nix/nix.conf 中添加 experimental-features = nix-command flakes）。

对于非交互式或 CI 环境使用：

nix develop .#go --command bash -c "go build ./..."

可选：安装 direnv 和 nix-direnv，以便在进入项目目录时自动激活 Shell。

完整 Shell 参考、项目到 Shell 的映射以及常用命令，请参阅 AGENTS.md。

注意： 支持性服务（PostgreSQL、Redis 等）仍通过 docker compose -f .devcontainer/docker-compose.yaml up 进行管理。

---

贡献

[!NOTE] Daytona 是遵循 GNU AFFERO GENERAL PUBLIC LICENSE 开源的，其版权归属所有贡献者（详见 NOTICE 文件）。如果您希望为本项目贡献力量，请阅读 Developer Certificate of Origin Version 1.1 和 贡献指南，以开始您的贡献之旅。

Daytona 快速上手指南

Daytona 是一个专为 AI 生成代码和 Agent 工作流设计的安全、弹性基础设施运行时。它提供完全隔离的“沙盒”（Sandbox），支持在 90ms 内启动，可执行 Python、TypeScript 和 JavaScript 代码，并保留状态快照。

环境准备

在开始之前，请确保满足以下条件：

• 操作系统：Linux、macOS 或 Windows（WSL2 推荐）。
• 网络访问：能够访问 app.daytona.io（官方托管服务）或具备 Docker 环境（如需本地部署）。
• 开发语言环境（任选其一）：
  • Python 3.8+
  • Node.js 16+
  • Go 1.20+
  • Ruby 3.0+
  • Java 8+ (Gradle/Maven)
• 账号与密钥：需要注册 Daytona 账号并获取 API Key。

安装步骤

1. 获取 API Key

1. 访问 app.daytona.io 注册账号。
2. 登录后进入 Dashboard，导航至 API Keys 页面。
3. 点击生成新的 API Key 并复制保存。

2. 安装 SDK

根据你使用的编程语言，选择以下一种方式安装客户端库：

Python

pip install daytona

TypeScript / Node.js

npm install @daytona/sdk

Ruby

gem install daytona

Go

go get github.com/daytonaio/daytona/libs/sdk-go

Java (Maven) 在 pom.xml 中添加依赖：

<dependency>
  <groupId>io.daytona</groupId>
  <artifactId>sdk</artifactId>
  <version>0.1.0</version>
</dependency>

(注：目前官方未提供特定的中国镜像源，如遇下载缓慢，可配置对应语言包管理器的国内镜像，如 PyPI 清华源或 npm 淘宝源)

基本使用

以下示例展示如何初始化客户端、创建沙盒并运行一段简单的代码。请将 YOUR_API_KEY 替换为你刚才生成的密钥。

Python 示例

from daytona import Daytona, DaytonaConfig

# 初始化配置
config = DaytonaConfig(api_key="YOUR_API_KEY")
daytona = Daytona(config)

# 创建沙盒
sandbox = daytona.create()

# 执行代码
response = sandbox.process.code_run('print("Hello World!")')
print(response.result)

TypeScript 示例

import { Daytona } from "@daytona/sdk";

async function main() {
  // 初始化客户端
  const daytona = new Daytona({ apiKey: "YOUR_API_KEY" });
  
  // 创建沙盒
  const sandbox = await daytona.create();
  
  // 执行代码
  const response = await sandbox.process.codeRun('print("Hello World!")');
  console.log(response.result);
}

main();

Ruby 示例

require 'daytona'

# 初始化配置
config = Daytona::Config.new(api_key: 'YOUR_API_KEY')
daytona = Daytona::Daytona.new(config)

# 创建沙盒
sandbox = daytona.create

# 执行代码
response = sandbox.process.code_run(code: 'print("Hello World!")')
puts response.result

Go 示例

package main

import (
  "fmt"
  "github.com/daytonaio/daytona/libs/sdk-go/pkg/daytona"
)

func main() {
  // 初始化客户端
  client := daytona.NewDaytona(daytona.WithApiKey("YOUR_API_KEY"))
  
  // 创建沙盒
  sandbox, err := client.CreateSandbox()
  if err != nil {
    panic(err)
  }
  
  // 执行代码
  response, err := sandbox.Process.CodeRun("print(\"Hello World!\")")
  if err != nil {
    panic(err)
  }
  
  fmt.Println(response.Result)
}

运行上述代码后，Daytona 将在云端秒级启动一个隔离环境，执行你的代码并返回结果。你可以利用此机制构建复杂的 AI Agent 工作流或进行安全的代码测试。