GPUtw 說明文件

連接埠與 Raw TCP/UDP

從運行中的執行個體開放 Web app 與 raw socket。

HTTP 連接埠

HTTP 連接埠會透過 <port>-<instance-id>.gputw.ai 提供。每個連接埠可設為 privatepublic,或使用密碼保護的 unlisted

存取模式與密碼

private 連接埠需要擁有者 session。public 連接埠會對任何取得連結的人開放。unlisted 連接埠會先顯示密碼頁,通過後才代理到容器。

  • Private: 只有擁有者能透過控制台 handoff 開啟
  • Public: 任何取得網址的人都能連到服務
  • Unlisted: 取得網址的人仍需通過 GPUtw 密碼頁
Info

密碼會以 bcrypt hash 儲存在伺服器端,永遠不會回傳到瀏覽器。若未輸入新密碼,既有 unlisted 密碼會保留。

Raw TCP/UDP 端點

Raw TCP/UDP exposure 會建立平台分配的 L4 端點,例如 tcp.gputw.ai:31000udp.gputw.ai:31001。這適合已經有自身驗證或協定安全性的非 HTTP 服務。

Warning

Raw 端點不使用 HTTP 擁有者 session、public/unlisted 模式或密碼閘門。請勿將 Jupyter、ComfyUI、terminal 或其他未驗證 Web UI 以 raw 方式暴露。

GPUtw 會阻擋已知未驗證 UI 連接埠,並要求改用 HTTP 連接埠存取控制。

限制與計費

使用者連接埠必須在 1024-65535 之間,且不可使用保留連接埠 222264439000-9999。若範本提供 Web UI,8080 是免費範本 Web UI 連接埠。每個執行個體包含三個額外免費計費連接埠;超過後,HTTP 或 raw TCP/UDP exposure 都會加入設定的每小時連接埠費用。

API 權限

管理 HTTP 連接埠與 raw TCP/UDP exposure 需要具備 ports:manage 的 API 金鑰。執行個體必須是 RUNNING,且屬於同一帳號。

PATCH/api/instances/{id}/portsPOST/api/instances/{id}/exposuresDELETE/api/instances/{id}/exposures/{exposureId}