WebSocket начинается как HTTP/1.1 request с `Upgrade: websocket`. Пока сервер не ответил `101 Switching Protocols`, двустороннего канала нет. Поэтому первый вопрос не «почему сокет молчит», а «какой статус получил upgrade и дошёл ли он до cloudflared и origin».

Cloudflare поддерживает proxied WebSockets, в том числе через обычный HTTP route Tunnel. Отдельный нестандартный протокол в ingress обычно не нужен: connector должен попасть на сервис, который понимает Upgrade, а все reverse proxies на пути — сохранить заголовки и соединение.

Четыре участка проверяются одним timestamp

УчастокСигналЕсли сигнала нет
browser → edgeNetwork WS requestURL/CSP/DNS/client code
Cloudflare edge101 либо 4xx/5xx + Ray/request dataWAF/Access/route
edge → cloudflaredconnector log в это времяhostname не ведёт в tunnel
cloudflared → originorigin access log/upgradeservice URL/port/TLS/Host
после 101frames и ping/pongapp protocol/idle/reconnect

Минимальный клиент отделяет UI от транспорта

const ws = new WebSocket('wss://ws.example.com/socket');
ws.onopen = () => console.log('open');
ws.onmessage = event => console.log('message', event.data);
ws.onerror = () => console.log('error');
ws.onclose = event => console.log('close', event.code, event.reason);

Тест выполняйте на странице, которой разрешён нужный connect-src в CSP. В DevTools Network выберите WS request: `101` подтверждает upgrade, Frames — дальнейший обмен. Не печатайте в console production token; используйте отдельную тестовую учётную запись и короткоживущую авторизацию.

HTTP status сразу сокращает поиск

Статус/симптомВероятный слойПроверка
301/302origin/Access redirectне превращается ли Upgrade в login page
401/403Access, WAF или app authpolicy event и cookie/header
404path/ingress/rewriteточный route и origin path
502cloudflared не подключился к serviceпорт, protocol, cert, logs
101, затем мгновенный closeorigin app/protocolclose code и server log
101, обрыв в простоеidle timeout/нет heartbeatping/pong и интервалы

Первоначальный upgrade проходит через WAF и rate limiting как HTTP request. После установления канала WAF уже не инспектирует каждое сообщение. Поэтому block event ищут на момент handshake, а содержимое frames диагностируют в приложении.

Ingress обязан вести на настоящий слушающий сервис

ingress:
  - hostname: ws.example.com
    service: http://127.0.0.1:8080
    originRequest:
      httpHostHeader: app.internal.example
  - service: http_status:404

Конфигурация условная. Порт должен совпадать с listener origin. Если service URL начинается с HTTPS, `cloudflared` проверяет сертификат origin; для private CA укажите `caPool` и правильный `originServerName`, а не включайте `noTLSVerify`. `httpHostHeader` нужен только когда внутренний reverse proxy маршрутизирует по Host.

  • Проверьте catch-all 404 в конце ingress и порядок hostname rules.
  • Убедитесь, что reverse proxy передаёт Upgrade и Connection для HTTP/1.1.
  • Не путайте протокол соединения cloudflared с edge (QUIC/HTTP2) и WebSocket приложения.
  • Сверьте TLS SNI origin с именем в сертификате.
  • Не открывайте origin наружу ради диагностики; тестируйте локально рядом с connector.

Логи связывают replica и origin

Cloudflare Tunnel Live logs и серверные cloudflared logs показывают путь connector → origin. Документация отмечает: если при `websocket: bad handshake` у tunnel нет событий, трафик не маршрутизирован к нему; если события есть, частая причина — неверный ingress, недоступный origin или ошибка TLS verification. При нескольких replicas записывайте connector ID.

После 101 начинается другая задача

Длинное соединение может завершиться при сетевом переключении, idle timeout или обновлении Cloudflare edge. Официальная рекомендация — heartbeat и reconnect. Клиент использует exponential backoff с jitter, восстанавливает авторизацию и подписки идемпотентно, а сервер не считает reconnect новой бизнес-операцией.

МеханизмЗачемОшибка реализации
ping/pongобнаружить мёртвое соединениеслишком частый трафик/нет timeout
close codeразличить auth и сетьвсе ошибки превращены в 1006
backoff + jitterне устроить reconnect stormфиксированная пауза у всех клиентов
resume cursorне потерять сообщенияповтор без дедупликации
session affinityвернуться к stateful originstate хранится только в памяти replica

Контрольный прогон заканчивается восстановлением

  1. Открыть минимальный WS client и получить 101 на production hostname/path.
  2. Сопоставить timestamp с Cloudflare, cloudflared и origin logs.
  3. Повторить без Access/WAF bypass, используя штатную тестовую identity.
  4. Оставить соединение без frames и проверить heartbeat/idle поведение.
  5. Перезапустить одну replica connector и измерить reconnect клиента.
  6. Послать повтор subscribe/message и проверить идемпотентность.
  7. Проверить несколько клиентов за NAT без ложного rate limit на handshake.

Для разбора нужны URL без токена, timestamp UTC, handshake status/headers без cookies, close code, ingress fragment, версии cloudflared и логи трёх участков. Tunnel token и Access credentials удалите. Исправление подтверждено, когда handshake даёт 101, frames проходят, а плановый обрыв восстанавливается без дублей и reconnect storm.

Проверенные источники