Loading...

Производительность

Что такое WebSocket? Рукопожатие с обновлением протокола, прокси и тайм-ауты

HTTP строится вокруг вопроса и ответа: браузер спрашивает, сервер отвечает, и обмен закончен. WebSocket превращает один HTTP-запрос в соединение, которое остаётся открытым, так что любая сторона может отправить сообщение в тот момент, когда оно у неё появилось. В этом руководстве описаны рукопожатие, случаи, когда WebSocket — правильный инструмент, причины обрывов соединений за прокси и способ пропустить WebSocket через CDN.

9 мин чтения Средний Обновлено

Что такое WebSocket? Рукопожатие с обновлением протокола, прокси и тайм-ауты

Почему обычного 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 секунд.