Function Compute：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，隨沙箱銷毀失效。