Клиент Cloudflare Tunnel

Содержит клиент командной строки для Cloudflare Tunnel — демон туннелирования, который проксирует трафик из сети Cloudflare к вашим источникам. Этот демон находится между сетью Cloudflare и вашим источником (например, веб-сервером). Cloudflare привлекает клиентские запросы и отправляет их вам через этот демон, не требуя открытия дыр в вашем брандмауэре — ваш источник может оставаться максимально закрытым. Обширная документация доступна в разделе Cloudflare Tunnel документации Cloudflare. Все варианты использования, связанные с проксированием к вашим источникам, доступны под cloudflared tunnel help.

Вы также можете использовать cloudflared для доступа к источникам Tunnel (которые защищены с помощью cloudflared tunnel) для TCP-трафика на уровне 4 (т.е. не HTTP/websocket), что актуально для таких случаев, как SSH, RDP и т.д. Такие варианты использования доступны под cloudflared access help.

Вместо этого вы можете использовать клиент WARP для доступа к частным источникам за Tunnel для трафика уровня 4 без необходимости использования команд cloudflared access на стороне клиента.

Перед началом работы

Перед использованием Cloudflare Tunnel вам необходимо выполнить несколько шагов в панели управления Cloudflare: добавить сайт в свою учетную запись Cloudflare. Обратите внимание, что сегодня можно использовать Tunnel без сайта (например, для частной маршрутизации), но по историческим причинам это требование все еще необходимо:

Установка `cloudflared`

Загрузки доступны в виде отдельных бинарных файлов, образа Docker, а также пакетов Debian, RPM и Homebrew. Вы также можете найти релизы здесь в репозитории cloudflared на GitHub.

Вы можете установить на macOS через Homebrew или загрузив последний релиз для Darwin amd64
Бинарные файлы, пакеты Debian и RPM для Linux можно найти здесь
Образ Docker с cloudflared доступен на DockerHub
Вы можете установить на машины Windows, следуя инструкциям здесь
Чтобы собрать из исходного кода, установите необходимую версию Go, указанную в разделе Разработка ниже. Затем выполните make cloudflared.

Пользовательская документация для Cloudflare Tunnel доступна по адресу https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel/

Создание туннелей и маршрутизация трафика

После установки вы можете аутентифицировать cloudflared в своей учетной записи Cloudflare и начать создавать туннели для обслуживания трафика к вашим источникам.

Создайте туннель по этой инструкции
Направьте трафик в этот туннель:
- Через публичные записи DNS в Cloudflare
- Или через публичное имя хоста, направляемое балансировщиком нагрузки Cloudflare
- Или из частного трафика клиента WARP

TryCloudflare

Хотите протестировать Cloudflare Tunnel, прежде чем добавлять сайт в Cloudflare? Вы можете сделать это с помощью TryCloudflare, используя документацию доступную здесь.

Устаревшие версии

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

Например, по состоянию на январь 2023 года Cloudflare будет поддерживать cloudflared версии с 2023.1.1 по 2022.1.1.

Разработка

Требования

GNU Make
capnp
go >= 1.26
Дополнительные инструменты:

Сборка

Чтобы собрать cloudflared локально, выполните make cloudflared

Тестирование

Чтобы локально запустить тесты, выполните make test

Линтинг

Чтобы отформатировать код и поддерживать его качество, используйте make fmt и make lint

Моки

После изменений в интерфейсах может потребоваться перегенерировать моки, поэтому выполните make mocks

Хуки Git

Чтобы избежать ошибок CI, вы можете установить pre-push хуки, которые запускают линтинг и тесты перед каждым push:

make install-hooks

Это настроит git на использование хуков в .githooks/, которые выполняют make fmt-check lint test перед каждым push.

cloudflared v2026.8.1

Категории