DeepSeek 模板

headless 单任务

--profile headless 执行一个任务，打印最终答案后退出：

result = sandbox.commands.run(
    'dsh --profile headless "用一句话介绍 DeepSeek Harness" 2>&1',
    timeout=0,
)
print(result.stdout)

模型 API Key 未注入或无效时，dsh 以非零码退出并给出明确错误（错误输出在 stderr，下表为经 2>&1 合并后的错误原文）：

Web UI

镜像内置一键启动脚本，沙箱内执行一条命令即可启动 Web UI。脚本后台启动 dsh web（仅监听 127.0.0.1:8080，Token 鉴权），就绪后在 stdout 输出 DSH_WEB_TOKEN 与 DSH_WEB_LAUNCH_URL；脚本幂等，Web UI 已在运行时直接回显现有 token，不重复启动：

import re

r = sandbox.commands.run("/opt/deepseek-harness/start.sh", timeout=180)
print(r.stdout)
# 输出形如：
# DSH_WEB_TOKEN=<token>
# DSH_WEB_LAUNCH_URL=http://127.0.0.1:8080/?token=<token>

token = re.search(r"DSH_WEB_TOKEN=(\S+)", r.stdout).group(1)

用 SDK 端口代理把沙箱内 8080 端口映射为公网可访问地址。默认平台域名（*.e2b.fc.aliyuncs.com）下该地址仅适合 curl / SDK 层验证，Web UI 无法在浏览器中使用；要在浏览器中使用 Web UI，须先绑定自定义域名，参见浏览器访问：

host = sandbox.get_host(8080)
print(f"https://{host}/?token={token}")

DEEPSEEK_API_KEY 未注入时，start.sh 非零退出并提示通过 envs 注入。

浏览器访问（自定义域名 + --trusted-host）

默认平台域名（*.e2b.fc.aliyuncs.com）下 Web UI 无法在浏览器中使用，原因有二：

1. 平台对默认域名的 HTTP 响应强制添加 Content-Disposition: attachment，浏览器打开会下载 HTML 文件而非渲染页面。

2. dsh 对 /api 请求设有浏览器信任栅栏，默认只信任 loopback 主机名；经平台域名代理访问时 Host 不被信任，/api 全部返回 403，页面为空壳。

默认域名仅适合 curl / SDK 层验证：不带 token 访问返回 401（dsh 原生鉴权提示），带 token 访问返回 303 并签发会话 cookie，携带 cookie 再访返回 200。

要在浏览器中使用 Web UI，须先绑定自定义域名，并在启动时通过 --trusted-host 把公网主机名加入信任列表：

1. 绑定自定义域名：控制台添加域名、DNS 解析与 HTTPS 证书的完整步骤见云沙箱自定义域名。要点：配置控制链路域名 api.<你的自定义域名> 与数据链路泛域名 *.<你的自定义域名>，证书须覆盖泛域名，域名需按所在地域要求完成备案。

2. SDK 换用自定义域名：将 OPTS 替换为与控制台一致的配置（api_key 须为绑定该域名同一账号下的 Key），后续 Template.build(...)、Sandbox.create(...) 等所有调用均使用新的 OPTS。替换 OPTS 后需重新执行 Sandbox.create(...) 创建沙箱，本步骤的 sandbox.get_host(8080) 才会返回自定义域名下的主机名：

   OPTS = {
       "api_key": "<你的 E2B API Key>",
       "api_url": "https://api.<你的自定义域名>",
       "domain": "<你的自定义域名>",
   }

3. 带 --trusted-host 启动并访问：start.sh 额外参数原样透传给 dsh web，将 sandbox.get_host(8080) 返回的公网主机名传入：

   host = sandbox.get_host(8080)   # 8080-<sandbox_id>.<你的自定义域名>
   
   r = sandbox.commands.run(
       f"/opt/deepseek-harness/start.sh --trusted-host {host}",
       timeout=180,
   )
   token = re.search(r"DSH_WEB_TOKEN=(\S+)", r.stdout).group(1)
   
   print(f"https://{host}/?token={token}")

浏览器打开输出的 URL 即可使用 Web UI。首次进入会弹出 Internal Testing Notice（DeepSeek Harness 0.1 内测期提示），单击 Continue 关闭；必须先选 workspace 才能对话（单击 Choose workspace 选择一个目录），之后模型流式回复，界面含思考过程折叠与每轮 Token 用量统计。输出的 URL 同样含 token，按凭据处理；首次访问建立会话后，改用不带 ?token= 的 URL 即可。

关于 --trusted-host 与鉴权：

• 加入信任列表只影响信任栅栏，鉴权不变：不带 token 访问仍返回 401，首次访问后由会话 cookie 承接（30 天有效）。

• 可重复传入多个主机名；条目带端口号时精确匹配，不带端口号时匹配任意端口。

• dsh 重启后 token 会变化，已签发的浏览器会话 cookie 仍有效。

排障：若访问返回代理层 403（JSON 错误体），带 X-Access-Token: <sandbox._envd_access_token> 请求头重试。_envd_access_token 是 Python SDK 的内部属性（e2b==2.31.0 实测可用，后续版本可能重命名或移除），对应 Sandbox Access Token，随沙箱销毁失效。