infra

环境要求

• 一台支持 KVM 虚拟化的 Linux 主机（Firecracker 微虚拟机依赖 KVM）
• 已安装 Docker 与 Docker Compose（单机 Embed 部署方式）
• 想跳过自建时，需在 e2b.dev 获取 E2B Cloud API key

安装与启动步骤

1. 1准备 Linux 环境

   准备一台带 KVM 的 Linux 主机，装好 Docker 和 Docker Compose；没有 KVM 或不想运维就直接走 E2B Cloud。

2. 2下载部署文件

   新建 e2b 目录，并从仓库 main 分支下载 embed/compose 下的 compose.yaml 与 .env 两个文件。

   mkdir e2b && cd e2b
   curl -fsSL --remote-name-all "https://raw.githubusercontent.com/e2b-dev/runtime/main/embed/compose/{compose.yaml,.env}"

   复制

3. 3启动整套服务

   在刚创建的 e2b 目录里执行，-d 后台运行，--wait 会等各容器就绪后返回，其中包含真实 Firecracker 沙箱。

   docker compose up -d --wait

   复制

4. 4云端创建沙箱

   不想自建时，用 e2b.dev 领取的 API key 配合官方 SDK 创建沙箱并执行命令，适合快速验证。

   from e2b import Sandbox
   
   with Sandbox.create() as sandbox:
       result = sandbox.commands.run('echo "Hello from E2B!"')
       print(result.stdout)

   复制

5. 5考虑 Terraform 部署

   同一个 Embed 包也以 GCP Terraform 和 Kubernetes manifest 形式提供；生产自建需参考企业版方案。

关键配置

如何确认成功

docker compose up -d --wait 成功返回即表示容器已就绪，可用 docker compose ps 查看状态；云端路径会打印 Hello from E2B!

常见问题

注意事项

• 单机 Embed 部署是评估用途，不要直接当作生产环境使用。
• 项目用 Go 编写，Apache-2.0 许可，公开云、企业专属部署和单机 Embed 共用同一套代码。
• 更多细节请查阅仓库内 embed/README.md（Run it yourself）与 docs/ARCHITECTURE.md。
• 自建生产环境建议走企业版，runtime 会部署在你自己云的账号内，数据留在本地。