Публикация сервиса через Cloudflare Tunnel
Публикация приложения на Debian или Ubuntu без открытия входящих портов с помощью Cloudflare Tunnel, защита интерфейса администрирования через Cloudflare Access, обновление и резервное копирование.
На этой странице
Ваши значения
Укажите их один раз, и команды в руководстве обновятся.
Это руководство объясняет, как опубликовать приложение, размещённое на вашем сервере, не открывая входящих портов. Программа cloudflared устанавливает исходящее соединение с Cloudflare. Посетители попадают на https://app.ваш-домен.com, Cloudflare управляет сертификатом и передаёт запросы в этот туннель.
К концу руководства приложение будет по-прежнему слушать только локально, туннель будет запускаться вместе с сервером, а вы научитесь ограничивать доступ к важному интерфейсу кругом идентифицированных пользователей.
Заказать сервер
Это руководство подходит для серверов, которыми вы управляете самостоятельно:
Предварительные требования
- Сервер под управлением Debian 12 или 13 либо Ubuntu 22.04 или 24.04
- Доступ по SSH под пользователем с правами
sudo - Учётная запись Cloudflare
- Активный домен в этой учётной записи
- Приложение, которое слушает локально, например на
127.0.0.1:3000
Добавьте домен в Cloudflare
Если домена ещё нет в Cloudflare:
- Добавьте его в панели управления и выберите тарифный план.
- Проверьте импортированные записи DNS. Особенно проверьте записи MX и записи почты, так как автоматическое сканирование может что-то пропустить.
- Отключите DNSSEC у вашего регистратора, если он включён.
- Замените серверы имён домена на те, которые укажет Cloudflare. Для домена, обслуживаемого в HostMyServers, см. руководство DNS-сервер.
Используемые порты
| Порт | Направление | Назначение | Действие |
|---|---|---|---|
| 7844/tcp и 7844/udp | Исходящий | Соединение туннеля с Cloudflare | Разрешить, если исходящий трафик фильтруется |
| 443/tcp | Исходящий | Вспомогательные функции, например проверка обновлений | Необязательно |
| 3000/tcp | Локальный | Приложение из примера | Не открывать |
| Нет | Входящий | Туннелю не нужны входящие порты | Открывать нечего |
Шаг 1: проверьте приложение
Приложение должно отвечать на локальном интерфейсе:
curl -I http://127.0.0.1:3000
sudo ss -ltnp | grep 3000Адрес прослушивания должен быть 127.0.0.1. Если приложение работает в Docker, публикуйте его порт в виде 127.0.0.1:3000:3000. Публикация 3000:3000 осталась бы доступной из Интернета, потому что Docker добавляет собственные правила брандмауэра.
Шаг 2: установите cloudflared
Добавьте официальный репозиторий Cloudflare и установите пакет:
sudo mkdir -p --mode=0755 /usr/share/keyrings
curl -fsSL https://pkg.cloudflare.com/cloudflare-main.gpg | sudo tee /usr/share/keyrings/cloudflare-main.gpg >/dev/null
echo 'deb [signed-by=/usr/share/keyrings/cloudflare-main.gpg] https://pkg.cloudflare.com/cloudflared any main' | sudo tee /etc/apt/sources.list.d/cloudflared.list
sudo apt-get update
sudo apt-get install -y cloudflared
cloudflared --versionШаг 3: создайте туннель
Аутентифицируйте cloudflared. Команда выведет URL, который нужно открыть в браузере и выбрать там свой домен:
sudo cloudflared tunnel loginСертификат учётной записи сохраняется в /root/.cloudflared/cert.pem. Затем создайте туннель:
sudo cloudflared tunnel create hms-tunnel
sudo cloudflared tunnel listЗапишите выведенный идентификатор, здесь он называется TUNNEL_UUID. Скопируйте его файл учётных данных в каталог, который использует служба:
sudo install -d -m 700 /etc/cloudflared
sudo install -m 600 /root/.cloudflared/TUNNEL_UUID.json /etc/cloudflared/TUNNEL_UUID.jsonШаг 4: настройте туннель
sudo nano /etc/cloudflared/config.ymltunnel: TUNNEL_UUID
credentials-file: /etc/cloudflared/TUNNEL_UUID.json
ingress:
- hostname: app.ваш-домен.com
service: http://127.0.0.1:3000
- service: http_status:404Правила читаются по порядку. Последнее правило, без имени хоста, обязательно: оно отвечает 404 на любой запрос, не соответствующий ни одному сервису.
Проверьте файл и маршрутизацию URL:
sudo cloudflared tunnel --config /etc/cloudflared/config.yml ingress validate
sudo cloudflared tunnel --config /etc/cloudflared/config.yml ingress rule https://app.ваш-домен.comШаг 5: защитите интерфейс администрирования
Пропустите этот шаг, только если сервис предназначен для публичного доступа и имеет собственную аутентификацию. Для интерфейса администрирования создайте защиту до публикации имени: без приложения Access адрес открыт для всего Интернета.
В панели управления Cloudflare:
- Перейдите в Zero Trust > Access controls > Applications.
- Выберите Create new application, затем Self-hosted and private.
- Выберите Add public hostname и укажите
app.ваш-домен.com. - В разделе Access policies создайте политику с действием Allow и правилом Include типа Emails, содержащим ваш адрес.
- Выберите способ входа. Если вы хотите получать код по электронной почте, добавьте One-time PIN в Zero Trust > Integrations > Identity providers.
- Выберите Create.
Названия могут меняться: при расхождениях следуйте документации Cloudflare Access.
Вы также можете попросить cloudflared проверять токен Access. Тег Application Audience (AUD) Tag находится в Additional settings приложения. В config.yml дополните соответствующее правило:
ingress:
- hostname: app.ваш-домен.com
service: http://127.0.0.1:3000
originRequest:
access:
required: true
teamName: TEAM_NAME
audTag:
- AUD_TAG
- service: http_status:404TEAM_NAME — это имя вашей команды Cloudflare One, то, что стоит перед .cloudflareaccess.com. Затем снова выполните проверку из шага 4.
Шаг 6: опубликуйте доменное имя
Создайте запись DNS, указывающую на туннель:
sudo cloudflared tunnel route dns hms-tunnel app.ваш-домен.comЕсли вы управляете несколькими доменами, убедитесь в панели управления, что запись CNAME создана в нужной зоне. Она должна указывать на TUNNEL_UUID.cfargotunnel.com.
Шаг 7: запустите туннель как службу
sudo cloudflared service install
systemctl status cloudflared --no-pagerКоманда создаёт службу cloudflared, включает её автозапуск и запускает её с /etc/cloudflared/config.yml.
Проверка результата
sudo journalctl -u cloudflared --no-pager -n 50 | grep 'Registered tunnel connection'
sudo cloudflared tunnel info hms-tunnel
curl -I https://app.ваш-домен.comВ журналах должны быть зарегистрированные соединения, а URL должен отвечать. Если вы создали приложение Access, откройте адрес в окне приватного просмотра: страница входа должна появиться раньше самого приложения.
С вашего компьютера прямой доступ должен завершаться ошибкой:
curl -m 5 -I http://IP_ВАШЕГО_СЕРВЕРА:3000Закрытие ставшего ненужным доступа
Если приложение раньше публиковалось на веб-портах, а теперь их больше никто не использует, удалите соответствующие правила UFW:
sudo ufw status numbered
sudo ufw delete allow 80/tcp
sudo ufw delete allow 443/tcpТуннель работает при закрытой политике входящих соединений. Обязательно сохраните правило SSH, если только вы не используете частную сеть, например Tailscale.
Файл cert.pem позволяет управлять всеми туннелями учётной записи, тогда как службе нужен только файл учётных данных туннеля. Если вы не управляете туннелями с этого сервера, удалите его:
sudo shred -u /root/.cloudflared/cert.pemПеред любой командой управления, например tunnel route dns или tunnel info, придётся снова выполнить sudo cloudflared tunnel login. Удаление этого файла не отзывает содержащийся в нём токен: для этого удалите токен Cloudflare Tunnel API Token или Argo Tunnel API Token в My Profile > API Tokens.
Публикация другого сервиса
Добавьте правило перед завершающим правилом:
ingress:
- hostname: app.ваш-домен.com
service: http://127.0.0.1:3000
- hostname: docs.ваш-домен.com
service: http://127.0.0.1:8080
- service: http_status:404Проверьте конфигурацию, создайте DNS-имя и перезапустите службу:
sudo cloudflared tunnel --config /etc/cloudflared/config.yml ingress validate
sudo cloudflared tunnel route dns hms-tunnel docs.ваш-домен.com
sudo systemctl restart cloudflaredЕсли cert.pem был удалён, можно также создать в DNS Cloudflare запись CNAME на TUNNEL_UUID.cfargotunnel.com.
Вариант: управление туннелем из панели управления
Cloudflare позволяет также управлять туннелем удалённо, без config.yml:
- Перейдите в Networking > Tunnels и выберите Create a tunnel.
- Назовите туннель, выберите свою систему и выполните на сервере предложенную команду. Она содержит секретный токен.
- На вкладке Routes выберите Add route, затем Published application.
- Укажите поддомен, домен и URL сервиса, например
http://127.0.0.1:3000.
На одной машине может работать только одна служба cloudflared. Добавляйте свои приложения в существующий туннель, а не устанавливайте второй.
Ограничения, которые нужно знать
- Приложение видит запросы как приходящие от
cloudflared. Реальный адрес посетителя находится в заголовкеCF-Connecting-IP. - Размер запросов зависит от вашего тарифного плана Cloudflare: 100 МБ на планах Free и Pro.
- Условия Cloudflare ограничивают раздачу видео и крупных файлов на планах Free, Pro и Business.
- Для поддомена с несколькими уровнями, например
a.b.ваш-домен.com, нужен расширенный сертификат. - Это руководство охватывает веб-приложения. Для SSH и других протоколов TCP также требуется настройка на стороне клиента.
Обновление
cloudflared, установленный из пакета, обновляется через APT, после чего службу нужно перезапустить. Текущий трафик ненадолго прерывается:
sudo apt-get update
sudo apt-get install --only-upgrade -y cloudflared
sudo systemctl restart cloudflared
cloudflared --versionРезервное копирование и восстановление
Каталог /etc/cloudflared содержит конфигурацию и файл учётных данных туннеля:
sudo tar -czf /root/cloudflared-$(date +%F).tar.gz -C /etc cloudflared
sudo chmod 600 /root/cloudflared-$(date +%F).tar.gzСрок действия этого файла учётных данных не истекает, и он позволяет запускать туннель: храните архив в зашифрованном виде за пределами сервера.
Чтобы восстановить архив на сервере, где установлен cloudflared, подставьте вместо ГГГГ-ММ-ДД его дату:
sudo tar -xzf /root/cloudflared-ГГГГ-ММ-ДД.tar.gz -C /etc
sudo cloudflared service installЕсли вы не хотите, чтобы трафик получали оба сервера, сначала остановите туннель на старом сервере.
Если что-то пошло не так
Ошибка 1033
Cloudflare не находит ни одного активного экземпляра туннеля. Проверьте службу и её журналы:
systemctl status cloudflared --no-pager
sudo journalctl -u cloudflared --no-pager -n 100Если служба работает, проверьте, что CNAME указывает на правильный TUNNEL_UUID.cfargotunnel.com.
Ошибка 502 и Unable to reach the origin service
Туннель подключён, но cloudflared не может связаться с приложением. Убедитесь, что оно работает, затем сравните его порт и протокол со строкой service:
curl -I http://127.0.0.1:3000ERR_TOO_MANY_REDIRECTS
Приложение перенаправляет HTTP на HTTPS, тогда как в правиле используется http://. Отключите это перенаправление в приложении либо укажите в service схему https:// с действительным сертификатом.
x509: certificate signed by unknown authority или certificate is valid for
Если приложение работает по HTTPS, cloudflared не распознаёт его сертификат. Укажите центр сертификации через caPool либо ожидаемое имя через originServerName в originRequest. Используйте noTLSVerify только на время диагностики.
remote error: tls: handshake failure
Публичное имя не покрыто сертификатом, часто потому, что это поддомен с несколькими уровнями. Используйте один уровень либо закажите расширенный сертификат.
Tunnel credentials file ... doesn't exist or is not a file
Путь credentials-file неверен. Убедитесь, что он совпадает с файлом, находящимся в /etc/cloudflared:
sudo ls -l /etc/cloudflaredAn A, AAAA, or CNAME record with that host already exists
Имя уже используется в вашей DNS-зоне. Удалите старую запись в Cloudflare, убедившись, что она больше не нужна, либо выберите другое имя. Чтобы намеренно заменить запись:
sudo cloudflared tunnel route dns --overwrite-dns hms-tunnel app.ваш-домен.comcloudflared service is already installed
На машине уже есть служба. Добавьте приложение в существующий туннель либо удалите службу, прежде чем начинать заново:
sudo cloudflared service uninstallpossible conflicting configuration
Существуют два файла конфигурации, часто /root/.cloudflared/config.yml и /etc/cloudflared/config.yml. Оставьте файл из /etc/cloudflared и укажите его явно:
sudo cloudflared --config /etc/cloudflared/config.yml service installТуннель не подключается
cloudflared использует QUIC поверх UDP и переключается на HTTP/2 поверх TCP, если UDP не проходит. Поэтому исходящий порт 7844 должен быть открыт. Проверьте его с сервера:
sudo apt-get install -y netcat-openbsd
nc -vz -w 3 region1.v2.argotunnel.com 7844
nc -uvz -w 3 region1.v2.argotunnel.com 7844Проверка UDP может пройти, даже если пакеты фильтруются: наиболее показательна проверка TCP. Если ваши локальные правила верны, а порт остаётся заблокированным, обратитесь в поддержку из личного кабинета.
failed to sufficiently increase receive buffer size
Это сообщение касается буфера UDP для QUIC. Как правило, оно безвредно и не требует действий.