← Cloudflare Workers / workers / wrangler / commands

Tunnel

Správa Cloudflare Tunnels přímo z Wrangleru. Vytvářejte, spouštějte a spravujte tunely, které bezpečně propojují vaše lokální služby se sítí Cloudflare, bez nutnosti veřejných IP adres.

Wrangler spravuje cloudflared binárku automaticky. Při prvním použití vás Wrangler vyzve ke stažení cloudflared do místního adresáře mezipaměti. Tento krok můžete přeskočit instalací cloudflared sami a přidáte ho do svého PATH, nebo nastavením CLOUDFLARED_PATH proměnnou prostředí tak, aby ukazovala na existující binární soubor.

Vytvořte nový vzdáleně spravovaný Cloudflare Tunnel.

wrangler tunnel create <NAME>

• NAME string povinné
  • Název vašeho tunelu. Musí být v rámci účtu jedinečný.

Tunely vytvořené prostřednictvím Wrangler jsou vždy spravováno vzdáleně : nakonfigurujte je v Cloudflare dashboard ↗ nebo přes API.

Po vytvoření použijte wrangler tunnel run ID tunelu a spusťte tunel.

npx wrangler tunnel create my-app

Creating tunnel "my-app"
Created tunnel.
ID: f70ff985-a4ef-4643-bbbc-4a0ed4fc8415
Name: my-app

To run this tunnel, configure its ingress rules in the Cloudflare dashboard, then run:
   wrangler tunnel run f70ff985-a4ef-4643-bbbc-4a0ed4fc8415

Následující globální příznaky fungují u každého příkazu:

• --help boolean
  • Zobrazí nápovědu.
• --config string (Pages toto nepodporují)
  • Cesta k vašemu Konfigurační soubor Wrangler.
• --cwd string
  • Spustit, jako by byl Wrangler spuštěn v zadaném adresáři místo aktuálního pracovního adresáře.

Odstranit Cloudflare Tunnel z vašeho účtu.

wrangler tunnel delete <TUNNEL> [OPTIONS]

• TUNNEL string povinné
  • Název nebo UUID tunelu, který chcete odstranit.
• --force boolean volitelné
  • Přeskočit výzvu k potvrzení.

npx wrangler tunnel delete f70ff985-a4ef-4643-bbbc-4a0ed4fc8415

Are you sure you want to delete tunnel "f70ff985-a4ef-4643-bbbc-4a0ed4fc8415"? This action cannot be undone. (y/n)
Deleting tunnel f70ff985-a4ef-4643-bbbc-4a0ed4fc8415
Tunnel deleted.

Následující globální příznaky fungují u každého příkazu:

• --help boolean
  • Zobrazí nápovědu.
• --config string (Pages toto nepodporují)
  • Cesta k vašemu Konfigurační soubor Wrangler.
• --cwd string
  • Spustit, jako by byl Wrangler spuštěn v zadaném adresáři místo aktuálního pracovního adresáře.

Zobrazí podrobnosti o Cloudflare Tunnelu, včetně jeho ID, názvu, stavu a data vytvoření.

wrangler tunnel info <TUNNEL>

• TUNNEL string povinné
  • Název nebo UUID tunelu, který chcete prozkoumat.

npx wrangler tunnel info f70ff985-a4ef-4643-bbbc-4a0ed4fc8415

Getting tunnel details
ID: f70ff985-a4ef-4643-bbbc-4a0ed4fc8415
Name: my-app
Status: healthy
Created: 2025-01-15T10:30:00Z
Type: cfd_tunnel

Následující globální příznaky fungují u každého příkazu:

• --help boolean
  • Zobrazí nápovědu.
• --config string (Pages toto nepodporují)
  • Cesta k vašemu Konfigurační soubor Wrangler.
• --cwd string
  • Spustit, jako by byl Wrangler spuštěn v zadaném adresáři místo aktuálního pracovního adresáře.

Vypsat všechny Cloudflare Tunnels ve vašem účtu.

wrangler tunnel list

Výstup zahrnuje ID, název, stav a datum vytvoření pro každý tunel. Zobrazují se pouze tunely, které nebyly odstraněny.

npx wrangler tunnel list

Listing Cloudflare Tunnels

ID                                   Name       Status    Created
f70ff985-a4ef-4643-bbbc-4a0ed4fc8415 my-app     healthy   2025-01-15T10:30:00Z
550e8400-e29b-41d4-a716-446655440000 api-tunnel inactive  2025-01-10T15:45:00Z

Následující globální příznaky fungují u každého příkazu:

• --help boolean
  • Zobrazí nápovědu.
• --config string (Pages toto nepodporují)
  • Cesta k vašemu Konfigurační soubor Wrangler.
• --cwd string
  • Spustit, jako by byl Wrangler spuštěn v zadaném adresáři místo aktuálního pracovního adresáře.

Spusťte Cloudflare Tunnel pomocí cloudflared daemon. Tím se zahájí trvalé připojení mezi vaším lokálním počítačem a sítí Cloudflare.

wrangler tunnel run [TUNNEL] [OPTIONS]

• TUNNEL string volitelné
  • Název nebo UUID tunelu, který chcete spustit. Povinné, pokud není zadáno --token je zadáno.
• --token string volitelné
  • Token tunelu, který se použije přímo. Přeskočí ověření přes API.
• --log-level string (default: info) optional
  • Úroveň protokolu pro cloudflared. Neovlivňuje logy Wrangleru (ty se řídí WRANGLER_LOG). Jedna z těchto možností: debug, info, warn, error, fatal.

Named tunnels jsou spravováno vzdáleně : nakonfigurujte ingress pravidla (které lokální služby zpřístupnit) v Cloudflare dashboard ↗ nebo přes API před spuštěním tunelu.

Existují dva způsoby, jak spustit tunel:

Podle názvu nebo ID tunelu (načte token přes API):

npx wrangler tunnel run my-app

Podle tokenu (není potřeba autentizace API, hodí se pro CI/CD nebo vzdálené servery):

npx wrangler tunnel run --token eyJhIjoiNGE2MjY...

Stiskněte Ctrl+C pro ukončení tunelu. Wrangler odešle signál pro řízené ukončení cloudflared před ukončením.

Následující globální příznaky fungují u každého příkazu:

• --help boolean
  • Zobrazí nápovědu.
• --config string (Pages toto nepodporují)
  • Cesta k vašemu Konfigurační soubor Wrangler.
• --cwd string
  • Spustit, jako by byl Wrangler spuštěn v zadaném adresáři místo aktuálního pracovního adresáře.

Bez účtu Cloudflare spusťte bezplatný dočasný tunel pomocí Quick Tunnels. Hodí se to pro rychlá demo, testování webhooků nebo sdílení lokálních vývojových serverů.

wrangler tunnel quick-start <URL>

• URL string povinné
  • Lokální adresa URL, která se má zpřístupnit (například http://localhost:8080).

Tunelu je přiřazen náhodný *.trycloudflare.com subdoména a trvá po celou dobu procesu.

npx wrangler tunnel quick-start http://localhost:8080

Starting quick tunnel to http://localhost:8080...
Your tunnel URL: https://random-words-here.trycloudflare.com

Následující globální příznaky fungují u každého příkazu:

• --help boolean
  • Zobrazí nápovědu.
• --config string (Pages toto nepodporují)
  • Cesta k vašemu Konfigurační soubor Wrangler.
• --cwd string
  • Spustit, jako by byl Wrangler spuštěn v zadaném adresáři místo aktuálního pracovního adresáře.