Почему обычного HTTP недостаточно
Классический HTTP — это запрос и ответ. Клиент спрашивает, сервер отвечает, и пока его не спросят, сервер снова заговорить не может. Для страницы, которая меняется по клику пользователя, этого достаточно. А для окна чата, биржевого тикера или игры у сервера есть новости, о которых клиент не спрашивал.
У обходных путей есть названия. Polling раз в несколько секунд спрашивает, не изменилось ли что-нибудь; большинство ответов — «нет», и каждый стоит полноценного запроса. Long polling держит запрос открытым, пока серверу не будет что сказать, и затем начинает заново. Оба способа работают, и оба добавляют задержку и накладные расходы, подгоняя запрос и ответ под то, для чего они не предназначены.
WebSocket (RFC 6455) решает это на уровне протокола: одно соединение, открытое один раз, по которому клиент и сервер отправляют сообщения когда угодно и в обе стороны, с несколькими байтами служебной разметки на сообщение.
Рукопожатие с обновлением протокола
WebSocket начинает жизнь как HTTP. Браузер отправляет запрос GET с Upgrade: websocket и Connection: Upgrade, случайным Sec-WebSocket-Key и версией протокола. Сервер, который согласен, отвечает 101 Switching Protocols со значением Sec-WebSocket-Accept, вычисленным из ключа; оно доказывает, что сервер понял запрос, а не воспроизвёл закэшированный ответ.
После 101 на этом соединении HTTP заканчивается. То же соединение TCP и TLS теперь несёт кадры WebSocket: текстовые или бинарные сообщения и небольшие служебные кадры ping, pong и close. Схема URL — ws://, а поверх TLS — wss://. На публичном сайте всегда используйте wss://: он работает на порту 443, как HTTPS, и проходит через сети, блокирующие всё необычное.
Это форма для HTTP/1.1. У HTTP/2 и HTTP/3 есть собственный способ передавать WebSocket (RFC 8441 и RFC 9220), но обновление протокола HTTP/1.1 всё ещё то, на чём большинство серверов и прокси говорят с приложением.
Рукопожатие: запрос и ответ
GET /chat HTTP/1.1
Host: app.example.com
Upgrade: websocket
Connection: Upgrade
Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==
Sec-WebSocket-Version: 13
HTTP/1.1 101 Switching Protocols
Upgrade: websocket
Connection: Upgrade
Sec-WebSocket-Accept: s3pPLMBiTxaQ9kYGzzhZRbK+xOo=
Когда использовать WebSocket, а когда нет
Хорошо подходит. Чаты и виджеты поддержки, живые дашборды и биржевые экраны, многопользовательские игры, совместные редакторы, присутствие («кто онлайн») и любое приложение, где сервер отправляет события, а клиент быстро отвечает.
Server-Sent Events (SSE) — более простой выбор, когда говорит только сервер: ленты новостей, логи сборки, индикаторы прогресса, уведомления. SSE — это обычный HTTP с ответом, который продолжает передаваться потоком, сам переподключается и проходит везде, где проходит HTTP.
Обычный HTTP по-прежнему правильный выбор для всего, что построено на запросе и ответе: страницы, API, загрузки файлов. Их можно кэшировать, а сообщение WebSocket — нельзя. Здоровая архитектура использует оба: HTTP для загрузки данных и ресурсов, один WebSocket для живых обновлений.
Почему соединения WebSocket обрываются за прокси
WebSocket проходит через каждый узел между браузером и вашим приложением: корпоративные прокси, балансировщики, CDN, nginx перед приложением. Каждый из них должен сделать правильно две вещи.
Пропустить обновление протокола. Upgrade и Connection — это hop-by-hop заголовки: прокси не пересылает их, пока ему не скажут. Если какой-то узел их отбрасывает, ваше приложение получает обычный GET и отвечает 400 или 404, а браузер сообщает, что рукопожатие не удалось.
Позволить простой. Прокси закрывают соединения, по которым какое-то время ничего не происходило. WebSocket может молчать минутами между сообщениями, поэтому лимит простоя, рассчитанный на HTTP, его закрывает. В nginx этот лимит — proxy_read_timeout, по умолчанию 60 секунд: если бэкенд ничего не отправляет 60 секунд, nginx закрывает соединение, и браузер видит код закрытия 1006.
Решение состоит из двух частей. Увеличьте лимит простоя на узлах, которые несут трафик WebSocket, и пусть приложение отправляет ping или небольшое heartbeat-сообщение чаще, чем самый короткий лимит простоя на пути; обычно это каждые 20–30 секунд. Пока идут данные, соединение остаётся открытым.
nginx перед приложением на WebSocket
Если nginx проксирует запросы к вашему приложению, location для WebSocket нуждается в HTTP/1.1 в сторону бэкенда, двух заголовках обновления и тайм-аутах длиннее вашего интервала heartbeat. map отправляет Connection: upgrade для запросов WebSocket и обычным образом закрывает обычные, так что один location обслуживает оба вида.
proxy_read_timeout — это время, которое nginx ждёт, пока бэкенд что-нибудь отправит; proxy_send_timeout — время, которое он ждёт при отправке бэкенду. Ни один из них не ограничивает общую длительность соединения: сокет, по которому раз в 30 секунд идёт сообщение, может оставаться открытым днями.
nginx: проксирование соединений WebSocket к приложению на порту 3000
# http {} level
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
server {
# ...
location /ws/ {
proxy_pass http://127.0.0.1:3000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
proxy_set_header Host $host;
# longer than the app's ping interval
proxy_read_timeout 300s;
proxy_send_timeout 300s;
}
}
WebSocket на cdn.com.tr
На cdn.com.tr WebSocket — это настройка каждого правила доставки. Создайте правило для пути, который ваше приложение использует для WebSocket, например /ws/ или /socket.io/, и включите Разрешить подключения WebSocket. Edge передаёт рукопожатие посетителя вашему origin, и как только origin отвечает 101, соединение между ними остаётся открытым, пока идут данные. Ответы на этом пути не кэшируются, а это именно то, что нужно живому соединению.
В том же правиле есть два тайм-аута, каждый от 1 до 3 600 секунд: сколько edge ждёт, пока origin что-нибудь отправит, и сколько ждёт при отправке на origin. По умолчанию — 60 секунд. На домене ваших приложений Managed Container WebSocket включён по умолчанию, и оба тайм-аута составляют 300 секунд, если правило не задаёт другие значения. Установите тайм-аут чтения выше интервала ping вашего приложения, и простаивающие сокеты останутся открытыми.
Дайте WebSocket собственное правило. Остальной сайт сохраняет кэширование, оптимизацию изображений и сжатие, а путь WebSocket получает соединение, проходящее напрямую до вашего origin. Поля показаны в руководстве по подключению к источнику; те же тайм-ауты подходят и для долгих HTTP-запросов, которые иначе заканчиваются 504 Gateway Timeout.
Как не терять клиентов
Даже при правильных тайм-аутах соединения заканчиваются: телефон меняет сеть, ноутбук засыпает, развёртывается новая версия вашего приложения. Считайте закрытый сокет обычным событием и проектируйте с расчётом на него.
Переподключайтесь автоматически, с задержкой, которая растёт после каждой неудачной попытки (например 1, 2, 4 и 8 секунд, до предела), плюс небольшой случайной составляющей, чтобы тысячи клиентов не переподключались в одну и ту же секунду.
Продолжайте, а не начинайте заново. При переподключении отправляйте ID или метку времени последнего сообщения, чтобы сервер мог повторить то, что клиент пропустил.
Отправляйте heartbeat с сервера или с клиента, если ваша библиотека этого не делает, и считайте отсутствующий pong признаком мёртвого соединения.
Socket.IO и многие клиентские библиотеки WebSocket делают большую часть этого за вас; проверьте, что это включено.
Где WebSocket раскрывается
Сообщения и индикаторы набора приходят в тот же миг, как отправлены, без запроса каждые несколько секунд.
Цены, заказы и метрики попадают на экран по мере изменения.
Ходы, курсоры и правки передаются между игроками или редакторами с минимальной задержкой.
Как настроить
Пошаговые руководства в справочном центре:
WebSocket: частые вопросы
WebSocket быстрее HTTP?
Для частых небольших сообщений — да: после рукопожатия каждое сообщение несёт несколько байт служебной разметки вместо полного набора заголовков HTTP, а сервер может отправлять, не дожидаясь запроса. Для страниц, файлов и ответов API лучше подходит HTTP, и его можно кэшировать.
Чем ws:// отличается от wss://?
wss:// — это WebSocket поверх TLS, как https:// — HTTP поверх TLS. Он зашифрован и гораздо надёжнее проходит через прокси и файрволы. Используйте wss:// на любом публичном сайте.
Почему мой WebSocket закрывается ровно через 60 секунд?
Прокси на пути закрывает соединения, простаивающие 60 секунд, — это значение proxy_read_timeout по умолчанию в nginx. Увеличьте тайм-аут на этом узле и пусть приложение отправляет ping каждые 20–30 секунд.
Работают ли соединения WebSocket через CDN?
Да, если CDN пропускает обновление протокола. На cdn.com.tr вы включаете WebSocket в правиле доставки для этого пути; тогда соединение доходит до вашего origin и остаётся открытым, пока идут данные.
Можно ли кэшировать сообщения WebSocket?
Нет. Сообщения относятся к одному живому соединению. Кэшируйте HTTP-часть приложения — страницы, ресурсы и ответы API — а путь WebSocket держите в отдельном правиле.
Как долго соединение WebSocket может оставаться открытым?
На cdn.com.tr общая длительность не ограничена: пока идут данные, соединение остаётся открытым. Вы задаёте в правиле, сколько оно может простаивать, — до 3 600 секунд.