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 → edge | Network WS request | URL/CSP/DNS/client code |
| Cloudflare edge | 101 либо 4xx/5xx + Ray/request data | WAF/Access/route |
| edge → cloudflared | connector log в это время | hostname не ведёт в tunnel |
| cloudflared → origin | origin access log/upgrade | service URL/port/TLS/Host |
| после 101 | frames и ping/pong | app 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/302 | origin/Access redirect | не превращается ли Upgrade в login page |
| 401/403 | Access, WAF или app auth | policy event и cookie/header |
| 404 | path/ingress/rewrite | точный route и origin path |
| 502 | cloudflared не подключился к service | порт, protocol, cert, logs |
| 101, затем мгновенный close | origin app/protocol | close code и server log |
| 101, обрыв в простое | idle timeout/нет heartbeat | ping/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 origin | state хранится только в памяти replica |
Контрольный прогон заканчивается восстановлением
- Открыть минимальный WS client и получить 101 на production hostname/path.
- Сопоставить timestamp с Cloudflare, cloudflared и origin logs.
- Повторить без Access/WAF bypass, используя штатную тестовую identity.
- Оставить соединение без frames и проверить heartbeat/idle поведение.
- Перезапустить одну replica connector и измерить reconnect клиента.
- Послать повтор subscribe/message и проверить идемпотентность.
- Проверить несколько клиентов за 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.