RU

Приложения

Публикация сервиса через Cloudflare Tunnel

Публикация приложения на Debian или Ubuntu без открытия входящих портов с помощью Cloudflare Tunnel, защита интерфейса администрирования через Cloudflare Access, обновление и резервное копирование.

9 мин чтения, обновлено 18 ноября 2026 г.

На этой странице

Ваши значения

Укажите их один раз, и команды в руководстве обновятся.

Это руководство объясняет, как опубликовать приложение, размещённое на вашем сервере, не открывая входящих портов. Программа cloudflared устанавливает исходящее соединение с Cloudflare. Посетители попадают на https://app.ваш-домен.com, Cloudflare управляет сертификатом и передаёт запросы в этот туннель.

К концу руководства приложение будет по-прежнему слушать только локально, туннель будет запускаться вместе с сервером, а вы научитесь ограничивать доступ к важному интерфейсу кругом идентифицированных пользователей.

Заказать сервер

Это руководство подходит для серверов, которыми вы управляете самостоятельно:

Предварительные требования

  • Сервер под управлением Debian 12 или 13 либо Ubuntu 22.04 или 24.04
  • Доступ по SSH под пользователем с правами sudo
  • Учётная запись Cloudflare
  • Активный домен в этой учётной записи
  • Приложение, которое слушает локально, например на 127.0.0.1:3000

Добавьте домен в Cloudflare

Если домена ещё нет в Cloudflare:

  1. Добавьте его в панели управления и выберите тарифный план.
  2. Проверьте импортированные записи DNS. Особенно проверьте записи MX и записи почты, так как автоматическое сканирование может что-то пропустить.
  3. Отключите DNSSEC у вашего регистратора, если он включён.
  4. Замените серверы имён домена на те, которые укажет 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.yml
YAML
tunnel: 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:

  1. Перейдите в Zero Trust > Access controls > Applications.
  2. Выберите Create new application, затем Self-hosted and private.
  3. Выберите Add public hostname и укажите app.ваш-домен.com.
  4. В разделе Access policies создайте политику с действием Allow и правилом Include типа Emails, содержащим ваш адрес.
  5. Выберите способ входа. Если вы хотите получать код по электронной почте, добавьте One-time PIN в Zero Trust > Integrations > Identity providers.
  6. Выберите Create.

Названия могут меняться: при расхождениях следуйте документации Cloudflare Access.

Вы также можете попросить cloudflared проверять токен Access. Тег Application Audience (AUD) Tag находится в Additional settings приложения. В config.yml дополните соответствующее правило:

YAML
ingress:
  - hostname: app.ваш-домен.com
    service: http://127.0.0.1:3000
    originRequest:
      access:
        required: true
        teamName: TEAM_NAME
        audTag:
          - AUD_TAG
  - service: http_status:404

TEAM_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.

Публикация другого сервиса

Добавьте правило перед завершающим правилом:

YAML
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:

  1. Перейдите в Networking > Tunnels и выберите Create a tunnel.
  2. Назовите туннель, выберите свою систему и выполните на сервере предложенную команду. Она содержит секретный токен.
  3. На вкладке Routes выберите Add route, затем Published application.
  4. Укажите поддомен, домен и 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:3000

ERR_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/cloudflared

An A, AAAA, or CNAME record with that host already exists

Имя уже используется в вашей DNS-зоне. Удалите старую запись в Cloudflare, убедившись, что она больше не нужна, либо выберите другое имя. Чтобы намеренно заменить запись:

Терминал
sudo cloudflared tunnel route dns --overwrite-dns hms-tunnel app.ваш-домен.com

cloudflared service is already installed

На машине уже есть служба. Добавьте приложение в существующий туннель либо удалите службу, прежде чем начинать заново:

Терминал
sudo cloudflared service uninstall

possible 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. Как правило, оно безвредно и не требует действий.

Ссылки