跳到主要内容

浏览器与计算机操作

Kernel

为沙箱中的代码提供云浏览器。您的脚本在 E2B 中运行,并通过 CDP 用 Playwright 驱动 Kernel 上的 Chromium。

维护方
E2B
集成方式
kernel-browser template, CDP
软件包
kernel, @onkernel/sdk
语言
Python, TypeScript

配置

快速开始

将提示词粘贴到您的编程智能体中,或按以下步骤自行配置。

粘贴到您的编程智能体中

为这个项目添加 E2B 沙箱和 Kernel 浏览器。

  1. 1.使用项目的包管理器安装 e2b、Kernel SDK 和 Playwright(Python 用 e2b kernel playwright,TypeScript 用 e2b @onkernel/sdk playwright-core)。
  2. 2.代码需要 E2B_API_KEY 环境变量。如果尚未设置,请向我索要 API 密钥(在 https://console.e2b.dev/?tab=keys 获取)。切勿将其硬编码。KERNEL_API_KEY 也按同样方式向我索要。
  3. 3.按照 https://docs.e2b.dev/use-cases/remote-browser 上的云浏览器指南操作:从 kernel-browser 模板创建沙箱,在其 envs 中传入 KERNEL_API_KEY,并在沙箱中运行一个脚本,打开 Kernel 浏览器并通过 CDP 连接 Playwright。
  4. 4.运行一次,展示来自沙箱的输出,然后终止沙箱。

或自行配置

  1. 1. 安装 SDK

    pip install e2b kernel playwright
  2. 2. 设置 API 密钥

    E2B_API_KEY=e2b_***
    KERNEL_API_KEY=kernel_***
  3. 3. 启动沙箱和您的应用

    import os
    from e2b import Sandbox
    
    FASTAPI_APP = """
    from fastapi import FastAPI
    from fastapi.responses import HTMLResponse
    
    app = FastAPI()
    
    @app.get("/")
    def home():
        return HTMLResponse("<h1>Home</h1><p>Welcome to the app.</p>")
    """
    
    sandbox = Sandbox.create(
        "kernel-browser",
        envs={"KERNEL_API_KEY": os.environ["KERNEL_API_KEY"]},
        timeout=300,
    )
    
    sandbox.files.write("/home/user/app.py", FASTAPI_APP)
    sandbox.commands.run("pip install fastapi uvicorn", timeout=60)
    sandbox.commands.run(
        "uvicorn app:app --host 0.0.0.0 --port 8000",
        background=True,
        cwd="/home/user",
    )
  4. 4. 用 Kernel 浏览器截图

    app_url = f"https://{sandbox.get_host(8000)}"
    
    BROWSE_SCRIPT = f'''
    from kernel import Kernel
    from playwright.sync_api import sync_playwright
    
    kernel = Kernel()
    kb = kernel.browsers.create()
    
    with sync_playwright() as pw:
        browser = pw.chromium.connect_over_cdp(kb.cdp_ws_url)
        page = browser.new_page()
        page.goto("{app_url}/", wait_until="networkidle")
        page.screenshot(path="/home/user/home.png")
        print("Captured /")
        browser.close()
    '''
    
    sandbox.files.write("/home/user/browse.py", BROWSE_SCRIPT)
    result = sandbox.commands.run("python3 /home/user/browse.py", timeout=60)
    print(result.stdout)
    sandbox.kill()

安全

沙箱中运行的内容

您的应用和浏览脚本在 E2B 中运行,浏览器本身运行在 Kernel 的基础设施上。

  • 代码您的应用和脚本,运行在基于 kernel-browser 模板的沙箱中,已预装 Kernel SDK、Playwright 和 Browser Use。
  • 浏览器Chromium 运行在 Kernel 上,而不是沙箱中。脚本通过 CDP 连接它。
  • 网络任意沙箱端口都可以通过 get_host 获得公开的 HTTPS URL,让 Kernel 浏览器加载您启动的应用。
  • 密钥KERNEL_API_KEY 通过 envs 传入沙箱。您的 E2B 密钥保留在您的机器上。

已启动 30亿+ 个沙箱

为每个智能体 配一台机器