Поиск
Справочник

Код 101 Switching Protocols: что значит и как работает WebSocket

101 Switching Protocols («переключение протоколов») — сервер согласился сменить протокол и дальше общается с клиентом по-новому. На сайтах так открывается WebSocket — соединение для чатов и уведомлений без перезагрузки страницы. Это не ошибка: 101 значит, что переход прошёл успешно.

≈ 6 мин чтения
Содержание 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 Gatewaynginx не смог связаться с приложением: проверьте, что оно запущено и слушает порт из proxy_pass
Соединение рвётся через минуту без сообщенийСработал proxy_read_timeout, по умолчанию 60 секунд: поднимите его или включите в приложении отправку ping

Чем 101 отличается от соседних кодов

КодКогда возникает
100Промежуточный ответ: можно отправлять тело запроса
101Сервер перешёл на протокол из заголовка Upgrade
200Успешный ответ без смены протокола
426Upgrade Required: сервер отказывается работать по текущему протоколу и в заголовке Upgrade называет нужный
502nginx не получил ответ от приложения

Источники

Сверено 19 октября 2026 года.

Что почитать дальше