CLI-viite

Näytä Markdown-muodossa Muokkaa palvelussa GitHub Dokumentaatio: 1675df8

Peruskäyttö

Suorita vain komento – argumentteja ei tarvita:

Shell

npx termbridge

Tämä käynnistää kaiken: paikallisen palvelimen, tmux-istunnon ja oletustunnelin Cloudflare.

Komennon termbridge suorittaminen ilman alikomentoa vastaa komentoa termbridge start.

Voit myös suorittaa termbridge start-komennon erikseen kaikkien valitsimien kanssa:

Shell

termbridge start --port 8080 --proxy 5173 --session dev --kill-on-exit --no-qr --tunnel cloudflare

Valitsimet

Valitsin	Kuvaus	Oletus
`--port <port>`	Käytä tiettyä porttia satunnaisen sijaan	Satunnainen
`--proxy <port>`	Välitä paikallinen kehityspalvelin (ottaa käyttöön Terminal/Preview-näkymät)	-
`--session <name>`	Nimeä tmux-istuntosi	Luodaan automaattisesti
`--kill-on-exit`	Siivoa tmux-istunnot, kun Termbridge sulkeutuu	Ei käytössä
`--no-qr`	Älä tulosta QR-koodia (hyödyllinen skripteissä)	Ei käytössä
`--no-tunnel`	Poista tunneli käytöstä (edellyttää `--public-url`)	Ei käytössä
`--public-url <url>`	Julkinen URL, kun tunneli on poissa käytöstä	-
`--tunnel <provider>`	Tunnelipalveluntarjoaja (`cloudflare` tai `none`)	cloudflare
`--tunnel-token <token>`	Käytä nimetyn Cloudflare-tunnelin tunnusta (edellyttää `--port`)	-
`--tunnel-url <url>`	Nimetyn tunnelin julkinen URL (pakollinen valitsimen `--tunnel-token` kanssa)	-
`--backend <backend>`	Päätteen taustajärjestelmä (`tmux` tai `sandbox-daytona`)	tmux
`--sandbox-repo <url>`	Kloonattavan repon URL Daytona-hiekkalaatikkoon	-
`--sandbox-branch <branch>`	Hiekkalaatikossa käyttöön otettava haara	-
`--sandbox-path <path>`	Repon polku hiekkalaatikossa	Johdetaan repon nimestä
`--sandbox-name <name>`	Hiekkalaatikon nimi	Satunnainen `termbridge-<hex>`
`--sandbox-preview-port <port>`	Hiekkalaatikon esikatseluportti	-
`--sandbox-public`	Luo julkinen hiekkalaatikko	Ei käytössä (käytössä suorassa tilassa)
`--sandbox-direct`	Suorita palvelin Daytona-hiekkalaatikossa (ei tunnelia)	Ei käytössä
`--dev-proxy-url <url>`	Välitä esikatseluliikenne tähän URL-osoitteeseen kohteen `localhost:<proxy port>` sijaan (käytössä kehitysskripteissä)	-
`-h`, `--help`	Tulosta ohjeteksti	-

Mikä tahansa muu valitsin aiheuttaa virheen unknown option: <flag>. Valitsinta --version ei ole.

Valitsin ohittaa vastaavan ympäristömuuttujan yhtä poikkeusta lukuun ottamatta: TERMBRIDGE_TUNNEL ohittaa tällä hetkellä arvot --tunnel ja --no-tunnel (#5).

Huomautus Sisäänrakennetun termbridge --help-tulosteen luettelossa on edelleen valitsimia --daytona-* ja --backend tmux | daytona. Nämä nimet hylätään; käytä yllä olevan taulukon valitsimia --sandbox-* ja --backend sandbox-daytona (#1).

Esimerkkejä

Liity olemassa olevaan tmux-istuntoon

Jos tmux-istunto on jo käynnissä:

Shell

termbridge --session my-session

Kiinteä portti ja mukautettu istunto

Shell

termbridge --port 8080 --session codex

Siisti sulkeutuminen (ei jäännösistuntoja)

Shell

termbridge --kill-on-exit

Skriptaus (ei QR-tulostetta)

Shell

termbridge --no-qr

Välitä Vite-kehityspalvelin

Shell

# Start your Vite app first
cd my-app && npm run dev  # runs on port 5173

# Then start Termbridge with proxy
termbridge --proxy 5173

Vaihda Terminal- ja Preview-näkymien välillä Views-painikkeella. Preview lataa sovelluksesi välityspalvelimen kautta HMR-tuella.

Nimetty Cloudflare-tunneli (tunnuspohjainen)

Jos sinulla on Cloudflare-tili ja haluat välttää trycloudflaren nopeusrajoitukset:

Shell

termbridge --port 8080 --tunnel-token <TOKEN> --tunnel-url https://term.example.com

Poista tunneli käytöstä (käytä omaa julkista URL-osoitettasi)

Shell

termbridge --no-tunnel --public-url https://example.com

Ympäristömuuttujat

Termbridge lukee ympäristömuuttujat komentotulkista ja .env-tiedostosta siinä hakemistossa, josta suoritat sen. Komentotulkissa jo asetetut muuttujat ohittavat .env-tiedoston arvot.

Ydinasetukset

Muuttuja	Kuvaus
`TERMBRIDGE_SESSIONS=2`	Luo käynnistyksen yhteydessä useita tmux-istuntoja
`TERMBRIDGE_TMUX_CWD=/path`	Uusien tmux-istuntojen työhakemisto
`TERMBRIDGE_PUBLIC_URL=https://example.com`	Julkinen URL, kun tunneli on poissa käytöstä
`TERMBRIDGE_TUNNEL=none`	Poista tunneli käytöstä
`TERMBRIDGE_TUNNEL_TOKEN=<token>`	Nimetyn tunnelin tunnus (edellyttää `TERMBRIDGE_TUNNEL_URL`)
`TERMBRIDGE_TUNNEL_URL=https://term.example.com`	Nimetyn tunnelin julkinen URL

Lisäasetukset

Daytona-suoratila asettaa nämä arvot hiekkalaatikon sisällä suorittamalleen palvelimelle. Voit asettaa ne myös itse.

Muuttuja	Kuvaus
`TERMBRIDGE_HOST=0.0.0.0`	Osoite, johon palvelin sidotaan (oletus `127.0.0.1`). Tulostettu paikallinen URL näyttää aina `127.0.0.1`.
`TERMBRIDGE_COOKIE_SAMESITE=lax`	Istuntoevästeen `SameSite`-arvo: `lax`, `strict` tai `none` (oletus `Lax` tai `None` suorassa tilassa)
`TERMBRIDGE_SHARE_FILE=/path/share-url.txt`	Kirjoita jakamisen URL myös tähän tiedostoon
`TERMBRIDGE_HIDE_TERMINAL_SWITCHER=1`	Piilota päätteen valitsin kohdassa UI
`TERMBRIDGE_TMUX_PATH_PREFIX=/path/bin`	Lisää tämä etuliitteeksi arvoon `PATH` jokaisessa tmux-istunnossa, jonka Termbridge käynnistää tai johon se liittyy (syötetään istuntoon `export`-komentona)

Kehitys

Muuttuja	Kuvaus
`TERMBRIDGE_INSECURE_COOKIE=1`	Salli HTTP-evästeet (vain paikallisessa kehityksessä)
`TERMBRIDGE_PROXY_PORT=5173`	dev:beam:proxy-komentosarjan välityspalvelimen portti
`TERMBRIDGE_DEV_UI=http://127.0.0.1:5000`	Ohita Vite-kehityksen UI URL
`TERMBRIDGE_DEV_PORT=3000`	Ohita Termbridge-palvelimen portti kehityksessä (oletus `8787`)
`TERMBRIDGE_DEV_SESSION=codex`	tmux-istunnon nimi kohteelle `dev:beam` (oletus `codex`)
`TERMBRIDGE_SKIP_BUILD=1`	Ohita `dev:beam`-kohdan CLI-koontiversio

Hiekkalaatikko (Daytona)

Muuttuja	Kuvaus
`TERMBRIDGE_BACKEND=sandbox-daytona`	Käytä Daytona-hiekkalaatikkotaustajärjestelmää
`TERMBRIDGE_SANDBOX_DIRECT=true`	Suorita Termbridge hiekkalaatikossa
`TERMBRIDGE_SANDBOX_SERVER_PORT=8080`	Hiekkalaatikossa ajettavan palvelimen portti
`TERMBRIDGE_SANDBOX_AGENTS=claude-code,codex`	Asenna automaattisesti ja synkronoi agenttien todennustiedot
`TERMBRIDGE_SANDBOX_AGENT_ENV=...`	Ylimääräiset välitettävät ympäristömuuttujat
`TERMBRIDGE_SANDBOX_AGENT_AUTH_PATHS=...`	Synkronoitavat paikalliset todennustiedostot

Katso täydelliset Daytona-määritykset Daytona-oppaasta.

Termbridge-ohjelman pysäyttäminen

Paina Ctrl+C päätteessä, jossa Termbridge on käynnissä. Tämä:

Sulkee tunnelin (jos se on käytössä)
Pysäyttää paikallisen palvelimen
Pitää tmux-istunnot käynnissä (ellet käyttänyt --kill-on-exit-asetusta)

tmux-istuntosi säilyvät oletusarvoisesti, joten voit yhdistää niihin myöhemmin uudelleen.