Код 101 Switching Protocols: что значит и как работает WebSocket
101 Switching Protocols («переключение протоколов») — сервер согласился сменить протокол и дальше общается с клиентом по-новому. На сайтах так открывается WebSocket — соединение для чатов и уведомлений без перезагрузки страницы. Это не ошибка: 101 значит, что переход прошёл успешно.
Содержание 8
Что означает код 101
Клиент предлагает сменить протокол заголовком Upgrade, а сервер соглашается ответом 101. В ответе сервер обязан прислать свой заголовок Upgrade с протоколом, на который переходит, и выбрать он может только протокол из списка клиента. Дальше соединение работает по новому протоколу.
Сменить протокол так можно только из HTTP/1.1. В HTTP/2 кода 101 нет: стандарт HTTP/2 убрал его, и похожий переход там делают иначе — расширенным запросом CONNECT.
Как открывается WebSocket
Браузер отправляет запрос с просьбой перейти на WebSocket:
GET /ws/ HTTP/1.1
Host: example.com
Upgrade: websocket
Connection: Upgrade
Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==
Sec-WebSocket-Version: 13Если сервер согласен, он отвечает 101:
HTTP/1.1 101 Switching Protocols
Upgrade: websocket
Connection: Upgrade
Sec-WebSocket-Accept: s3pPLMBiTxaQ9kYGzzhZRbK+xOo=Sec-WebSocket-Key — случайное значение от браузера, а Sec-WebSocket-Accept сервер вычисляет из него, чтобы браузер убедился: ответил сервер, который понимает WebSocket. Если вместо 101 пришёл другой код, WebSocket не открывается.
Как настроить nginx для WebSocket
nginx передаёт WebSocket приложению через proxy_pass. Когда приложение отвечает 101, nginx соединяет браузер с приложением и дальше пересылает данные в обе стороны.
Заголовки Upgrade и Connection действуют только на одном участке пути — от браузера до nginx, — и приложению nginx их сам не передаёт. Их задают в настройках явно. Ещё нужна строка proxy_http_version 1.1: nginx из Ubuntu 24.04 по умолчанию обращается к приложению по HTTP/1.0, а сменить протокол можно только в HTTP/1.1.
Команды из этого раздела выполняйте на сервере — как к нему подключиться, рассказано в инструкции Как подключиться к VPS по SSH. Если вы ни разу не открывали терминал, начните с инструкции Как открыть терминал: там всё по шагам.
Настройки nginx меняют в файле настроек сайта. Он лежит в папке /etc/nginx/sites-available/ — это тот файл, который вы создавали по инструкции Как разместить сайт на VPS: nginx с нуля. Откройте его на сервере, подставив вместо example.com имя своего файла:
sudo nano /etc/nginx/sites-available/example.comНайдите в файле блок location, через который запросы идут к приложению, — в нём есть строка proxy_pass. Как перемещаться по файлу и вставлять текст, рассказано в разделе про nano. Блок должен выглядеть так:
location /ws/ {
proxy_pass http://127.0.0.1:3000;
include proxy_params;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_read_timeout 1h;
}Адрес /ws/ и порт 3000 — примеры: подставьте путь, по которому приложение ждёт WebSocket, и порт, на котором оно работает. Если приложение принимает WebSocket по тому же адресу, что и сайт, добавьте четыре последние строки в его блок location.
Строка proxy_read_timeout 1h нужна для долгих соединений: если 60 секунд по WebSocket не идут данные, nginx закрывает соединение. Вместо этого можно настроить в приложении периодическую отправку ping.
Сохраните файл — Ctrl+O, Enter, затем Ctrl+X — и проверьте настройки:
sudo nginx -tВ ответе должны быть слова syntax is ok и test is successful. Если вместо них сообщение об ошибке, в нём указаны файл и номер строки: исправьте строку и проверьте снова. Когда проверка прошла, примените настройки:
sudo systemctl reload nginxЕсли команда ничего не ответила, настройки применены.
Как проверить
Команду выполняйте в терминале на своём компьютере, подставив адрес своего сайта. Если терминал вам незнаком, начните с инструкции Как открыть терминал. Вместо /ws/ — путь WebSocket вашего приложения:
curl -i --http1.1 -H 'Connection: Upgrade' -H 'Upgrade: websocket' -H 'Sec-WebSocket-Version: 13' -H 'Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==' https://example.com/ws/Если в первой строке ответа стоит 101, переход работает. После заголовков могут появиться непонятные символы — это уже данные WebSocket. Команда сама не завершится, пока соединение открыто: остановите её клавишами Ctrl+C.
Если WebSocket не открывается
| Что видно | Причина и что сделать |
|---|---|
| Вместо 101 приходит другой код | Приложение не получило заголовки Upgrade и Connection: проверьте, что строки из примера стоят в том блоке location, который обслуживает адрес WebSocket |
| 502 Bad Gateway | nginx не смог связаться с приложением: проверьте, что оно запущено и слушает порт из proxy_pass |
| Соединение рвётся через минуту без сообщений | Сработал proxy_read_timeout, по умолчанию 60 секунд: поднимите его или включите в приложении отправку ping |
Чем 101 отличается от соседних кодов
| Код | Когда возникает |
|---|---|
| 100 | Промежуточный ответ: можно отправлять тело запроса |
| 101 | Сервер перешёл на протокол из заголовка Upgrade |
| 200 | Успешный ответ без смены протокола |
| 426 | Upgrade Required: сервер отказывается работать по текущему протоколу и в заголовке Upgrade называет нужный |
| 502 | nginx не получил ответ от приложения |
Источники
- RFC 9110, раздел 15.2.2 — определение кода 101; раздел 7.8 — заголовок Upgrade; раздел 15.5.22 — код 426.
- RFC 6455, раздел 1.3 — пример рукопожатия WebSocket с ключом и ответом Sec-WebSocket-Accept.
- RFC 9113, раздел 8.6 — в HTTP/2 кода 101 нет, похожий переход делают расширенным CONNECT.
- Документация nginx: проксирование WebSocket — заголовки Upgrade и Connection передают явно, нужен
proxy_http_version 1.1, без данных соединение закрывается через 60 секунд. - Документация nginx: proxy_read_timeout — по умолчанию 60 секунд.
- Исходный код nginx 1.24.0: ngx_http_upstream.c — после ответа 101 nginx пересылает данные между клиентом и приложением в обе стороны.
Сверено 19 октября 2026 года.
Что почитать дальше
- proxy_pass в nginxкак передать запросы приложению.
- Ошибка 502 Bad Gatewayкогда nginx не может связаться с приложением.
- Код 100 Continueдругой промежуточный ответ.
- Коды ответа HTTPполный список с расшифровкой.