← Cloudflare Workers / workers / wrangler / commands

Tunnel

Управление Cloudflare Tunnels прямо из Wrangler. Создавайте, запускайте и управляйте туннелями, которые надежно подключают ваши локальные сервисы к сети Cloudflare: публичные IP-адреса не требуются.

Wrangler управляет cloudflared бинарный файл автоматически. При первом использовании Wrangler предложит вам скачать cloudflared в локальный каталог кеша. Этого можно избежать, установив cloudflared самостоятельно и добавить его в свой PATH, либо задав CLOUDFLARED_PATH переменную окружения, чтобы она указывала на существующий бинарный файл.

Создайте новый удалённо управляемый Cloudflare Tunnel.

wrangler tunnel create <NAME>

• NAME string обязательно
  • Имя туннеля. Должно быть уникальным в пределах вашего аккаунта.

Tunnels, созданные через Wrangler, всегда управляется удаленно : настройте их в Панель управления Cloudflare ↗ или через API.

После создания используйте wrangler tunnel run с идентификатором туннеля, чтобы запустить туннель.

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

Следующие глобальные флаги работают для любой команды:

• --help boolean
  • Показать справку.
• --config string (не поддерживается Pages)
  • Путь к вашему конфигурационный файл Wrangler.
• --cwd string
  • Выполнить так, как если бы Wrangler был запущен в указанном каталоге вместо текущего рабочего каталога.

Удалить Cloudflare Tunnel из вашего аккаунта.

wrangler tunnel delete <TUNNEL> [OPTIONS]

• TUNNEL string обязательно
  • Имя или UUID туннеля для удаления.
• --force boolean необязательно
  • Пропустить запрос подтверждения.

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.

Следующие глобальные флаги работают для любой команды:

• --help boolean
  • Показать справку.
• --config string (не поддерживается Pages)
  • Путь к вашему конфигурационный файл Wrangler.
• --cwd string
  • Выполнить так, как если бы Wrangler был запущен в указанном каталоге вместо текущего рабочего каталога.

Отображает сведения о Cloudflare Tunnel, включая его ID, имя, статус и время создания.

wrangler tunnel info <TUNNEL>

• TUNNEL string обязательно
  • Имя или UUID туннеля для проверки.

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

Следующие глобальные флаги работают для любой команды:

• --help boolean
  • Показать справку.
• --config string (не поддерживается Pages)
  • Путь к вашему конфигурационный файл Wrangler.
• --cwd string
  • Выполнить так, как если бы Wrangler был запущен в указанном каталоге вместо текущего рабочего каталога.

Получить список всех Cloudflare Tunnel в вашей учётной записи.

wrangler tunnel list

Вывод включает ID, имя, статус и дату создания для каждого туннеля. Отображаются только неудалённые туннели.

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

Следующие глобальные флаги работают для любой команды:

• --help boolean
  • Показать справку.
• --config string (не поддерживается Pages)
  • Путь к вашему конфигурационный файл Wrangler.
• --cwd string
  • Выполнить так, как если бы Wrangler был запущен в указанном каталоге вместо текущего рабочего каталога.

Запустите Cloudflare Tunnel с помощью cloudflared демон. Это устанавливает постоянное соединение между вашим локальным компьютером и сетью Cloudflare.

wrangler tunnel run [TUNNEL] [OPTIONS]

• TUNNEL string необязательно
  • Имя или UUID туннеля для запуска. Обязательно, если не указано --token указан.
• --token string необязательно
  • Токен туннеля для прямого использования. Пропускает аутентификацию через API.
• --log-level string (по умолчанию: info) необязательно
  • Уровень логирования для cloudflared. Не влияет на логи Wrangler (управляется WRANGLER_LOG). Один из вариантов: debug, info, warn, error, fatal.

Именованные туннели управляется удаленно : настройте правила ingress (какие локальные сервисы открыть) в Панель управления Cloudflare ↗ или через API, прежде чем запустить туннель.

Запустить туннель можно двумя способами:

По имени или ID туннеля (получает токен через API):

npx wrangler tunnel run my-app

По токену (аутентификация через API не требуется, что удобно для CI/CD или удалённых серверов):

npx wrangler tunnel run --token eyJhIjoiNGE2MjY...

Нажмите Ctrl+C чтобы остановить туннель. Wrangler отправит сигнал корректного завершения работы для cloudflared перед завершением работы.

Следующие глобальные флаги работают для любой команды:

• --help boolean
  • Показать справку.
• --config string (не поддерживается Pages)
  • Путь к вашему конфигурационный файл Wrangler.
• --cwd string
  • Выполнить так, как если бы Wrangler был запущен в указанном каталоге вместо текущего рабочего каталога.

Создайте бесплатный временный туннель без учетной записи Cloudflare с помощью Quick Tunnels. Это удобно для быстрых демонстраций, тестирования вебхуков или предоставления доступа к локальным серверам разработки.

wrangler tunnel quick-start <URL>

• URL string обязательно
  • Локальный URL-адрес для передачи наружу (например, http://localhost:8080).

Туннелю присваивается случайный *.trycloudflare.com поддомен и действует на протяжении всего процесса.

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

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

Следующие глобальные флаги работают для любой команды:

• --help boolean
  • Показать справку.
• --config string (не поддерживается Pages)
  • Путь к вашему конфигурационный файл Wrangler.
• --cwd string
  • Выполнить так, как если бы Wrangler был запущен в указанном каталоге вместо текущего рабочего каталога.