Настройка nginx как прокси для WebSocket на личном VPS SANSARA (2026)

Если вы хотите поднять защищённый канал для WebSocket‑трафика через свой личный сервер, то nginx станет удобным шлюзом между браузером и вашим приложением. В SANSARA это делается быстро: регистрация → данные в кабинете → импорт в клиент на любом устройстве. Далее покажем, как настроить nginx в качестве WebSocket‑прокси на вашем выделенном узле и подключиться с iPhone, Android, Windows или macOS.

Коротко:

• WebSocket позволяет держать постоянное соединение между клиентом и сервером для чатов, стримов, игр.
• nginx может проксировать WebSocket‑трафик на ваш бэкенд‑сервер на том же или другом порту.
• В SANSARA вы получаете личный VPS с готовым подключением: регистрация → данные в кабинете → импорт в клиент.
• Доступно 9+ локаций в Европе и других регионах для выбора ближайшего узла.
• Поддерживаются iPhone, Android, Windows, macOS; старт «в один клик» без терминала.

Что это и кому подходит

WebSocket — это протокол, который создаёт постоянное двустороннее соединение между клиентом (например, браузером) и сервером. В отличие от обычных HTTP‑запросов, где соединение закрывается после ответа, WebSocket остаётся открытым, что удобно для:

• Онлайн‑чатов и мессенджеров.
• Стриминга данных в реальном времени.
• Многопользовательских игр.
• Удалённого управления устройствами.

nginx — популярный веб‑сервер, который часто используют как обратный прокси и балансировщик нагрузки. Он умеет проксировать и WebSocket‑трафик, перенаправляя его на ваш бэкенд‑сервер (например, Node.js, Go или Python приложение).

Кому подойдёт такая схема:

• Разработчикам, которые хотят вынести WebSocket‑сервер за nginx для единой точки входа.
• Пользователям SANSARA, которые хотят поднять свой защищённый канал для WebSocket‑приложений.
• Тем, кому нужен единый шлюз для HTTP и WebSocket на одном домене и порту.

Сравним два подхода к организации WebSocket‑трафика:

Для большинства сценариев с личным VPS SANSARA удобнее использовать nginx как прокси.

Как настроить по шагам (с личным VPS SANSARA)

Предположим, у вас уже есть личный VPS в SANSARA. Вы зарегистрировались, получили данные в кабинете и импортировали их в клиент на своём устройстве. Дальше настраиваем nginx.

Шаг 1. Убедитесь, что nginx установлен

На вашем личном сервере SANSARA обычно уже предустановлен веб‑сервер или панель управления. Если nginx нет, установите его (команды для Debian/Ubuntu):

`bash sudo apt update sudo apt install nginx `

Проверьте, что он запущен:

`bash sudo systemctl status nginx `

Если не запущен:

`bash sudo systemctl start nginx sudo systemctl enable nginx `

Шаг 2. Настройка виртуального хоста для WebSocket

Создайте или отредактируйте конфигурацию для вашего домена (например, /etc/nginx/sites-available/websocket.example.com):

`nginx server { listen 80; server_name websocket.example.com;

return 301 https://$server_name$request_uri; }

server { listen 443 ssl http2; server_name websocket.example.com;

ssl_certificate /path/to/your/fullchain.pem; ssl_certificate_key /path/to/your/privkey.pem;

root /var/www/websocket; index index.html;

location / { try_files $uri $uri/ =404; }

location /ws/ { proxy_pass http://localhost:8080; # ваш WebSocket‑сервер proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_read_timeout 86400s; # Долгий таймаут для WebSocket proxy_send_timeout 86400s; } } `

Ключевые моменты:

• proxy_pass указывает на ваш бэкенд‑сервер (здесь localhost:8080).
• proxy_http_version 1.1 обязателен для WebSocket.
• Upgrade и Connection "upgrade" позволяют nginx передать запрос на обновление до WebSocket.
• Длинные proxy_read_timeout и proxy_send_timeout нужны, чтобы соединение не обрывалось.

Активируйте конфиг:

`bash sudo ln -s /etc/nginx/sites-available/websocket.example.com /etc/nginx/sites-enabled/ sudo nginx -t # проверка синтаксиса sudo systemctl reload nginx `

Шаг 3. Запустите ваш WebSocket‑сервер

Пример на Node.js с ws:

`javascript const WebSocket = require('ws'); const wss = new WebSocket.Server({ port: 8080 });

wss.on('connection', (ws) => { console.log('Новое WebSocket‑соединение'); ws.send('Привет от WebSocket‑сервера!');

ws.on('message', (message) => { console.log('Получено:', message.toString()); ws.send(Эхо: ${message}); }); }); `

Запустите сервер (если используете systemd, настройте службу для автозапуска).

Шаг 4. Проверьте соединение

Откройте в браузере страницу вашего домена (например, https://websocket.example.com) и используйте JavaScript для теста:

`html <script> const ws = new WebSocket('wss://websocket.example.com/ws/'); ws.onopen = () => { console.log('WebSocket открыт'); ws.send('тест'); }; ws.onmessage = (event) => { console.log('Ответ:', event.data); }; </script> `

Если в консоли видите ответ от сервера — всё работает.

В SANSARA вам не нужно делать это вручную на каждом устройстве: вы настраиваете сервер один раз, а подключаетесь через кабинет и импорт конфигурации.

Устройства: iPhone, Android, Windows, macOS

SANSARA поддерживает все популярные платформы. После настройки nginx и WebSocket‑сервера на вашем личном VPS подключение на устройствах выглядит так:

• iPhone / Android:

Установите клиент, поддерживающий импорт конфигураций. В кабинете SANSARA скачайте файл конфигурации для мобильного устройства и импортируйте его в приложение. После этого все запросы (включая WebSocket) пойдут через ваш выделенный узел.

• Windows:

Скачайте десктопный клиент, импортируйте конфигурацию из кабинета SANSARA. Запустите подключение — теперь браузер и другие приложения используют ваш личный сервер как шлюз.

• macOS:

Аналогично Windows: установите клиент, импортируйте конфиг из кабинета, активируйте соединение.

Во всех случаях вам не нужен терминал или ручная настройка на клиентской стороне. WebSocket‑трафик автоматически проходит через настроенный nginx‑прокси на вашем VPS.

Если у вас возникли проблемы, вы всегда можете обратиться в Telegram‑бот SANSARA для помощи с настройкой.

Частые ошибки и как их избежать

1. 01nginx не передаёт заголовок Upgrade

Симптом: WebSocket не поднимается, соединение сбрасывается. Решение: убедитесь, что в location /ws/ есть: `nginx proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; `

1. 01Таймауты слишком короткие

Симптом: соединение обрывается через несколько минут. Решение: увеличьте proxy_read_timeout и proxy_send_timeout до значений вроде 86400s (сутки).

1. 01Ошибки SSL при wss://

Симптом: браузер блокирует соединение из‑за проблем с сертификатом. Решение: используйте валидные SSL‑сертификаты (например, от Let’s Encrypt) и правильно укажите пути в ssl_certificate и ssl_certificate_key.

1. 01Бэкенд‑сервер недоступен

Симптом: 502 Bad Gateway в логах nginx. Решение: проверьте, что ваш WebSocket‑сервер запущен на порту, указанном в proxy_pass, и слушает localhost или правильный IP.

1. 01Конфиг не применяется

Симптом: изменения в конфиге не работают. Решение: после правок выполните sudo nginx -t и sudo systemctl reload nginx.

FAQ

Итог

• Настройте nginx как обратный прокси для WebSocket, указав proxy_pass, Upgrade и Connection "upgrade".
• Используйте wss:// с валидным SSL‑сертификатом для браузеров.
• Увеличьте таймауты в nginx, чтобы WebSocket‑соединения не обрывались.
• На личном VPS SANSARA настройте сервер один раз, а на устройствах просто импортируйте конфигурацию из кабинета.
• Если что‑то не работает, проверьте логи nginx и бэкенда, а также обратитесь в Telegram‑бот SANSARA за помощью.