Siirry sisältöön

Nimetyt tunnelit

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

Oletusarvoisesti Termbridge käyttää Cloudflare-palvelun tiliä vaatimattomia Quick Tunnels -tunneleita (trycloudflare.com). Ne ovat käteviä, mutta runsas käyttö voi johtaa nopeusrajoituksiin.

Jos käytät Termbridge-ohjelmaa usein, määritä nimetty tunneli Cloudflare-tililläsi.

Miksi käyttää nimettyä tunnelia?

  • Ei nopeusrajoituksia: Quick Tunnels voi aiheuttaa 429-virheitä runsaan käytön yhteydessä
  • Yhtenäinen URL: Saat pysyvän aliverkkotunnuksen satunnaisen merkkijonon sijaan
  • Oma verkkotunnus: Käytä omaa verkkotunnustasi, kuten term.example.com
  • Parempi luotettavuus: Nimetyt tunnelit toimivat vakaammin pitkissä istunnoissa

Määritys

1. Luo Cloudflare-tili

Rekisteröidy osoitteessa cloudflare.com, jos sinulla ei vielä ole tiliä.

2. Luo tunneli Zero Trustissa

  1. Siirry osoitteeseen Cloudflare Zero Trust
  2. Siirry kohtaan Networks → Tunnels
  3. Napsauta Create a tunnel
  4. Valitse yhdistäjäksi Cloudflared
  5. Anna tunnelille nimi (e.g., termbridge)
  6. Kopioi tunnelin tunniste

3. Lisää julkinen isäntänimi

  1. Siirry tunnelin asetuksissa kohtaan Public Hostname
  2. Lisää isäntänimi, joka osoittaa kohteeseen http://localhost:8080 (tai valitsemaasi porttiin)
  3. Käytä aliverkkotunnusta, kuten term.example.com

4. Suorita Termbridge tunnisteellasi

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

Tai käytä ympäristömuuttujia:

Shell
export TERMBRIDGE_TUNNEL_TOKEN=<TOKEN>
export TERMBRIDGE_TUNNEL_URL=https://term.example.com

termbridge --port 8080

Huomautus --port-valitsin on pakollinen nimettyjen tunnelien yhteydessä, sillä isäntänimi on määritetty osoittamaan tiettyyn porttiin.

Asetusvaihtoehdot

Valitsin Ympäristömuuttuja Kuvaus
--port <port> - Paikallinen portti (pakollinen nimetyille tunneleille)
--tunnel-token <token> TERMBRIDGE_TUNNEL_TOKEN Tunnelin tunniste
--tunnel-url <url> TERMBRIDGE_TUNNEL_URL Julkinen isäntänimesi URL

Tunnelin poistaminen käytöstä

Jos käytössäsi on oma käänteinen välityspalvelin tai julkinen URL:

Shell
termbridge --no-tunnel --public-url https://your-server.com

Tai:

Shell
export TERMBRIDGE_TUNNEL=none
export TERMBRIDGE_PUBLIC_URL=https://your-server.com

termbridge

Termbridge ohittaa tunnelin käynnistämisen ja käyttää antamaasi URL-arvoa QR-koodia varten.

Vianmääritys

"429 Liian monta pyyntöä"

Tämä tarkoittaa, että Quick Tunnels -tunneleihin sovelletaan nopeusrajoituksia. Ratkaisut:

  1. Odota muutama minuutti ja yritä uudelleen
  2. Lopeta kaikki vanhat cloudflared-prosessit: pkill cloudflared
  3. Siirry käyttämään nimettyä tunnelia (suositeltavaa)

Tunneli käynnistyy, mutta URL ei toimi

  • Varmista, että kohteen Cloudflare isäntänimi vastaa kohteen --tunnel-url isäntänimeä
  • Tarkista, että kohteen Cloudflare portti vastaa kohteen --port porttia
  • Varmista, että cloudflared on ajan tasalla: cloudflared update

Nimetty tunneli ei muodosta yhteyttä

  • Varmista, että tunniste on oikea
  • Tarkista, näkyykö Cloudflare Zero Trust-hallintapaneelissa virheitä
  • Kokeile suorittaa cloudflared tunnel run <TOKEN> suoraan nähdäksesi virheilmoitukset