Function Compute：雲沙箱自訂網域名

綁定自訂網域名後，您可以使用：

• 控制鏈路網域名稱：訪問雲沙箱 API，例如 https://api.example.com。

• 資料鏈路網域名稱：訪問沙箱內服務，例如 https://{port}-{sandboxId}.example.com。

以 example.com 為例：

使用限制

• 為雲沙箱綁定自訂網域名時，必須選擇雲沙箱所在的地區。

• 當前控制鏈路網域名稱僅支援 api. 開頭的單網域名稱，例如 api.example.com。

• 資料鏈路網域名稱為控制鏈路網域名稱去掉 api. 首碼後的泛網域名稱，例如 *.example.com。

• 必須使用 HTTPS 協議。

• 必須上傳可覆蓋資料鏈路泛網域名稱的認證，例如 *.example.com。僅覆蓋 api.example.com 的單網域名稱認證不滿足要求。

• 私密金鑰必須為未加密的 RSA PEM 格式。如果您的私密金鑰是 -----BEGIN PRIVATE KEY----- 格式，可先轉換為 -----BEGIN RSA PRIVATE KEY----- 格式。

• 不支援中文網域名稱。

• 同一個主帳號預設最多可綁定 5 個雲沙箱自訂網域名。如需提高上限，請聯絡服務技術服務人員。

• 自訂網域名需要完成備案或接入備案，具體要求以控制台校正結果為準。

私密金鑰格式轉換樣本：

openssl rsa -in pkcs8.key -out pkcs1.key

1. 添加自訂網域名

1. 登入Function Compute雲沙箱控制台。

2. 在左側導覽列選擇 云沙箱 > 域名管理。

3. 選擇雲沙箱所在地區。

4. 單擊 添加自定义域名。

5. 在 添加自定义域名 頁面填寫控制鏈路網域名稱，例如 api.example.com。

6. 按頁面提示擷取控制鏈路 CNAME 和資料鏈路 CNAME，用於下一步佈建網域名解析。

重要：自訂網域名必須選擇與雲沙箱相同的地區，否則網域名稱解析和認證校正可能無法生效。

2. 佈建網域名解析

登入雲解析 DNS 控制台，將自訂網域名解析到雲沙箱提供的 CNAME。

樣本：如果您的主帳號 ID 為 119085698835****，雲沙箱所在地區為華北 2（北京），資料鏈路 CNAME 可配置為：

119085698835****.cn-beijing.e2b.fc.aliyuncs.com

配置完成後，建議等待 DNS 生效再提交或驗證。您可以使用以下命令檢查解析結果：

dig +short CNAME api.example.com
dig +short CNAME test.example.com

其中 test.example.com 用於驗證 *.example.com 泛網域名稱解析是否生效。

3. 配置 HTTPS 認證

雲沙箱自訂網域名強制使用 HTTPS。請在添加網域名稱時上傳認證和私密金鑰。

認證要求：

• 認證必須在有效期間內。

• 認證和私密金鑰必須匹配。

• 認證必須覆蓋資料鏈路泛網域名稱。例如控制鏈路網域名稱為 api.example.com 時，認證應覆蓋 *.example.com。

4. 在 SDK 中使用自訂網域名

網域名稱添加成功後，將 SDK 中的 API 地址和資料鏈路基礎網域名稱替換為您綁定的自訂網域名。

TypeScript 樣本：

import { Sandbox } from "e2b";

const sandbox = await Sandbox.create("code-interpreter-v1", {
  apiKey: process.env.E2B_API_KEY,
  apiUrl: "https://api.example.com",
  domain: "example.com",
});

const host = sandbox.getHost(8000);
console.log(`https://${host}`);

Python 樣本：

from e2b import Sandbox

sandbox = Sandbox.create(
    template="code-interpreter-v1",
    api_key=os.environ["E2B_API_KEY"],
    api_url="https://api.example.com",
    domain="example.com",
)

host = sandbox.get_host(8000)
print(f"https://{host}")

如果沙箱 ID 為 sandbox-id，訪問連接埠為 8000，SDK 返回的訪問地址形如：

https://8000-sandbox-id.example.com

5. 驗證自訂網域名

完成配置後，可按以下步驟驗證：

1. 使用 SDK 或 OpenAPI 建立一個雲沙箱。

2. 在沙箱中啟動一個 HTTP 服務，例如監聽 8000 連接埠。

3. 調用 sandbox.getHost(8000) 擷取訪問網域名稱。

4. 使用瀏覽器或 curl 訪問 https://{port}-{sandboxId}.example.com。

樣本：

curl -v https://8000-sandbox-id.example.com

如果返回沙箱內服務響應，說明資料鏈路網域名稱已生效。

常見問題

注意事項

• sandbox.getHost(port) 返回的是 host，訪問時通常需要拼接 https://。

• 自訂網域名適合生產或長期訪問情境；臨時調試也可以繼續使用雲沙箱預設訪問網域名稱。

• 不要在未鑒權的連接埠服務中暴露敏感性資料、內部調試介面或長期有效憑證。