Daytona

Zobrazit jako Markdown Upravit na GitHub Dokumentace na 1675df8

Daytona umožňuje spouštět terminál a náhled Termbridge v cloudovém sandboxu. Využijte ho, když potřebujete reprodukovatelné prostředí nebo cloudový náhled, případně chcete nechat notebook v klidu.

Požadavky

Klíč Daytona API
Repozitář URL, který může sandbox naklonovat
Přihlašovací údaje Git, pokud je repozitář soukromý

Rychlý začátek

Nastavte backend na Daytona a zadejte konfiguraci repozitáře:

Shell

export TERMBRIDGE_BACKEND=sandbox-daytona
export TERMBRIDGE_DAYTONA_API_KEY=your_key
export TERMBRIDGE_SANDBOX_REPO=https://github.com/you/your-repo.git
export TERMBRIDGE_SANDBOX_BRANCH=main
export TERMBRIDGE_SANDBOX_PATH=your-repo
export TERMBRIDGE_SANDBOX_NAME=termbridge-sandbox
export TERMBRIDGE_SANDBOX_PUBLIC=true
export TERMBRIDGE_SANDBOX_PREVIEW_PORT=5173
export TERMBRIDGE_SANDBOX_DELETE_ON_EXIT=true

Poté spusťte Termbridge jako obvykle:

Shell

npx termbridge

Vždy nastavte TERMBRIDGE_SANDBOX_REPO (nebo --sandbox-repo). Pokud tato hodnota chybí, Termbridge nyní použije vestavěný výchozí repozitář, který není veřejně přístupný, takže sandbox se vytvoří, ale klonování selže (#2).

Připojení k Daytona

Proměnná	Účel
`TERMBRIDGE_DAYTONA_API_KEY`	Váš klíč Daytona API
`TERMBRIDGE_DAYTONA_API_URL`	Koncový bod API (výchozí hodnota `https://app.daytona.io/api`)
`TERMBRIDGE_DAYTONA_TARGET`	Cílová oblast Daytona (volitelné)

Tyto hodnoty se předávají SDK Daytona. Pokud některá není nastavena, SDK použije vlastní proměnnou DAYTONA_API_KEY, DAYTONA_API_URL nebo DAYTONA_TARGET.

Přímý režim sandboxu (bez tunelu)

V přímém režimu běží server Termbridge uvnitř sandboxu a Cloudflare se zcela vynechá. Sdílený odkaz URL je odkazem Daytona pro náhled serveru v sandboxu.

Shell

export TERMBRIDGE_BACKEND=sandbox-daytona
export TERMBRIDGE_SANDBOX_DIRECT=true
export TERMBRIDGE_SANDBOX_SERVER_PORT=8080

Výchozí hodnota TERMBRIDGE_SANDBOX_SERVER_PORT (nebo --port) je 8080. Přímý režim vytvoří veřejný sandbox, pokud nenastavíte TERMBRIDGE_SANDBOX_PUBLIC=false, a UI skryje přepínač terminálů.

Náhled můžete stále zapnout nastavením TERMBRIDGE_SANDBOX_PREVIEW_PORT; v přímém režimu se tato hodnota předá jako port serveru --proxy.

Klonování repozitáře

Termbridge vytvoří sandbox a naklonuje do jeho pracovního adresáře váš repozitář.

Použijte tato nastavení:

Proměnná	Účel
`TERMBRIDGE_SANDBOX_REPO`	URL repozitáře ke klonování (vždy nastavte, viz rychlý úvod)
`TERMBRIDGE_SANDBOX_BRANCH`	Větev, kterou chcete načíst (volitelné)
`TERMBRIDGE_SANDBOX_PATH`	Cesta k repozitáři v sandboxu (volitelné)
`TERMBRIDGE_SANDBOX_NAME`	Název sandboxu (volitelné, výchozí hodnota `termbridge-<random hex>`)

Pokud není nastavena hodnota TERMBRIDGE_SANDBOX_PATH, Termbridge ji odvodí z názvu repozitáře.

Soukromé repozitáře

Při klonování soukromých repozitářů zadejte přihlašovací údaje git:

Shell

export TERMBRIDGE_SANDBOX_GIT_USERNAME=your_github_username
export TERMBRIDGE_SANDBOX_GIT_TOKEN=your_github_token

Podporována je také proměnná TERMBRIDGE_SANDBOX_GIT_PASSWORD, která v případě nastavení přepíše token.

Programovací agenti

Termbridge může nainstalovat programovací agenty do sandboxu a synchronizovat vaše místní ověření, aby byli ihned připraveni k použití.

Úplné nastavení, automatický režim a informace o zabezpečení najdete v průvodci Programovací agenti.

Režim náhledu

Chcete-li zobrazit náhled, nastavte TERMBRIDGE_SANDBOX_PREVIEW_PORT na port, který používá váš vývojový server uvnitř sandboxu.

Pro Vite se ujistěte, že server naslouchá na všech síťových rozhraních:

Shell

npm run dev -- --host 0.0.0.0 --port 5173

Termbridge načte odkaz Daytona pro náhled a předá ho přes server Termbridge, aby se náhled načetl v UI.

Veřejné a soukromé sandboxy

Proměnná	Funkce
`TERMBRIDGE_SANDBOX_PUBLIC=true`	Vytvoří veřejný sandbox
`TERMBRIDGE_SANDBOX_PUBLIC=false`	Vytvoří soukromý sandbox

Není-li proměnná nastavena, sandboxy jsou soukromé, s výjimkou přímého režimu, ve kterém jsou veřejné.

U soukromých sandboxů Termbridge při předávání náhledu automaticky předá také jeho token.

Úklid a životní cyklus

Chcete-li sandboxy odstranit při ukončení Termbridge:

Shell

export TERMBRIDGE_SANDBOX_DELETE_ON_EXIT=true

U krátkodobých nebo testovacích sandboxů použijte předponu:

Shell

export TERMBRIDGE_SANDBOX_NAME=termbridge-test-$(date +%s)
export TERMBRIDGE_SANDBOX_DELETE_ON_EXIT=true

Tím budete mít využívání sandboxů pod kontrolou a předejdete problémům s kvótou disku.

Příznaky CLI

Daytona lze také konfigurovat pomocí příznaků. Příznak má přednost před odpovídající proměnnou prostředí.

Příznak	Proměnná prostředí	Účel
`--backend sandbox-daytona`	`TERMBRIDGE_BACKEND`	Použít backend Daytona
`--sandbox-repo <url>`	`TERMBRIDGE_SANDBOX_REPO`	URL repozitáře
`--sandbox-branch <branch>`	`TERMBRIDGE_SANDBOX_BRANCH`	Větev
`--sandbox-path <path>`	`TERMBRIDGE_SANDBOX_PATH`	Cesta k repozitáři v sandboxu
`--sandbox-name <name>`	`TERMBRIDGE_SANDBOX_NAME`	Název sandboxu
`--sandbox-preview-port <port>`	`TERMBRIDGE_SANDBOX_PREVIEW_PORT`	Port náhledu
`--sandbox-public`	`TERMBRIDGE_SANDBOX_PUBLIC=true`	Vytvořit veřejný sandbox
`--sandbox-direct`	`TERMBRIDGE_SANDBOX_DIRECT=true`	Spustit server uvnitř sandboxu (bez tunelu)

Pro soukromý sandbox neexistuje žádný příznak; použijte TERMBRIDGE_SANDBOX_PUBLIC=false. Vestavěný výstup termbridge --help stále zobrazuje názvy --daytona-* a --backend daytona, které jsou odmítány (#1).

Řešení problémů

Náhled je prázdný

Ověřte, že vývojový server běží uvnitř sandboxu.
Použijte --host 0.0.0.0, aby byl port náhledu dostupný.
Zkontrolujte, zda TERMBRIDGE_SANDBOX_PREVIEW_PORT odpovídá portu vývojového serveru.

Vytvoření sandboxu selže kvůli kvótě

Odstraňte staré sandboxy na ovládacím panelu Daytona.
Pro krátkodobé relace použijte TERMBRIDGE_SANDBOX_DELETE_ON_EXIT=true.

Klonování repozitáře selže

Zkontrolujte adresu URL repozitáře, větev a přihlašovací údaje.
Ověřte, že token Git má oprávnění ke čtení repozitáře.