Elnevezett alagutak
Alapértelmezés szerint a Termbridge a Cloudflare fiók nélküli Quick Tunneljeit (trycloudflare.com) használja. Ezek kényelmesek, de intenzív használat esetén sebességkorlátozás alá eshetnek.
Ha gyakran használja a Termbridge-t, állítson be elnevezett alagutat a Cloudflare-fiókjával.
Miért érdemes elnevezett alagutat használni?
- Nincsenek sebességkorlátozások: intenzív használat esetén a Quick Tunnel 429 hibákat adhat vissza
- Kiszámítható URL: véletlenszerű karakterláncok helyett állandó aldomaint kap
- Egyéni domain: használja saját domainjét, például
term.example.com - Nagyobb megbízhatóság: az elnevezett alagutak stabilabbak hosszú munkamenetekhez
Beállítás
1. Hozzon létre egy Cloudflare-fiókot
Regisztráljon itt: cloudflare.com, ha még nincs fiókja.
2. Hozzon létre alagutat a Zero Trustban
- Lépjen ide: Cloudflare Zero Trust
- Navigáljon a Networks → Tunnels menüpontra
- Kattintson a Create a tunnel lehetőségre
- Csatlakozóként válassza a Cloudflared lehetőséget
- Nevezze el az alagutat (e.g.
termbridge) - Másolja ki az alagút tokenjét
3. Adjon hozzá nyilvános állomásnevet
- A tunnel beállításaiban lépjen a Public Hostname részhez
- Adjon meg egy gazdagépnevet, amely erre mutat:
http://localhost:8080(vagy az Ön által választott portra) - Használjon ilyen aldomaint:
term.example.com
4. Futtassa a Termbridge-t a tokenjével
Shell
termbridge --port 8080 --tunnel-token <TOKEN> --tunnel-url https://term.example.com
Vagy használjon környezeti változókat:
Shell
export TERMBRIDGE_TUNNEL_TOKEN=<TOKEN>
export TERMBRIDGE_TUNNEL_URL=https://term.example.com
termbridge --port 8080
Megjegyzés Az elnevezett alagutakhoz szükség van a
--portkapcsolóra, mert az állomásnév egy adott portra van beállítva.
Konfigurációs lehetőségek
| Kapcsoló | Környezeti változó | Leírás |
|---|---|---|
--port <port> |
- | Helyi port (elnevezett alagutakhoz kötelező) |
--tunnel-token <token> |
TERMBRIDGE_TUNNEL_TOKEN |
Az alagút tokenje |
--tunnel-url <url> |
TERMBRIDGE_TUNNEL_URL |
Nyilvános állomásnév: URL |
Az alagút teljes kikapcsolása
Ha saját fordított proxyval vagy nyilvános URL-vel rendelkezik:
Shell
termbridge --no-tunnel --public-url https://your-server.com
Vagy:
Shell
export TERMBRIDGE_TUNNEL=none
export TERMBRIDGE_PUBLIC_URL=https://your-server.com
termbridge
A Termbridge kihagyja az alagút indítását, és az Ön által megadott URL értéket használja a QR kódhoz.
Hibaelhárítás
„429 Too Many Requests”
Ez azt jelenti, hogy a Quick Tunnel sebességkorlátozás alá esik. Megoldások:
- Várjon néhány percet, majd próbálja újra
- Állítsa le az összes elavult
cloudflared-folyamatot:pkill cloudflared - Váltson elnevezett alagútra (ajánlott)
Elindul az alagút, de a URL nem működik
- Ellenőrizze, hogy a Cloudflare-ban szereplő állomásnév megegyezik-e ezzel:
--tunnel-url - Ellenőrizze, hogy a Cloudflare-ben megadott port megegyezik-e ezzel:
--port - Győződjön meg róla, hogy a cloudflared naprakész:
cloudflared update
Nem sikerül csatlakozni az elnevezett alagúthoz
- Ellenőrizze, hogy helyes-e a token
- Ellenőrizze, vannak-e hibák a Cloudflare Zero Trust vezérlőpultján
- Futtassa közvetlenül a
cloudflared tunnel run <TOKEN>-t a hibaüzenetek megtekintéséhez