OBS Web: как связать OBS с веб-управлением через WebSocket

Короткий ответ: под obs web обычно имеют в виду управление OBS через веб-интерфейс: браузерную панель, remote control, overlay или собственную админку. Технически это чаще всего делается через OBS WebSocket: OBS поднимает WebSocket-сервер, а веб-клиент отправляет команды

В OBS Studio 28+ WebSocket уже встроен. Проверьте:

Tools -> obs-websocket Settings

Обычно локальный адрес:

ws://127.0.0.1:4455

Содержание

Что можно делать через obs web
Минимальная проверка через Node.js
Веб-панель и безопасность
Минимальная архитектура панели
Чем obs web отличается от overlay
Частые ошибки
Что почитать дальше по WebSocket

Что можно делать через obs web

Через WebSocket можно:

получать список сцен;
переключать активную сцену;
узнавать статус записи/стрима;
менять источники;
включать и выключать элементы;
строить веб-панель управления для оператора.

Пример задач: кнопки “Сцена 1”, “Сцена 2”, “Начать запись”, “Показать заставку”, “Выключить микрофон”

Минимальная проверка через Node.js

npm init -y
npm install obs-websocket-js

import OBSWebSocket from "obs-websocket-js";

const obs = new OBSWebSocket();

await obs.connect("ws://127.0.0.1:4455", "ВАШ_ПАРОЛЬ");

const scenes = await obs.call("GetSceneList");

for (const scene of scenes.scenes) {
  console.log(scene.sceneName);
}

await obs.disconnect();

Запуск:

node obs-check.mjs

Если список сцен выводится, OBS готов к веб-управлению

Веб-панель и безопасность

Если веб-панель открывается только на том же компьютере, можно подключаться к 127.0.0.1. Если панель на другом устройстве, нужен IP компьютера с OBS, firewall и понятная схема доступа

Не открывайте порт obs-websocket в интернет без защиты. Через него можно управлять OBS. Минимум — пароль, лучше — VPN или закрытая сеть

Для публичной веб-панели безопаснее сделать backend-прокси: браузер обращается к вашему серверу, а сервер уже управляет OBS. Так пароль от OBS не попадает в клиентский JavaScript

Минимальная архитектура панели

Практичная схема для своей панели:

Browser UI -> ваш backend -> OBS WebSocket

Frontend показывает кнопки и статус. Backend хранит пароль OBS и проверяет, имеет ли пользователь право переключать сцены. OBS остается доступен только серверу или локальной сети

Если панель полностью локальная и открывается на том же компьютере, можно делать проще:

Browser UI -> ws://127.0.0.1:4455 -> OBS

Но тогда пароль попадет в клиентский код. Для личного локального инструмента это иногда допустимо, для публичного сайта — нет

Чем obs web отличается от overlay

Overlay — это веб-страница, которую OBS показывает как browser source. Она может вообще не управлять OBS, а просто отображать графику

Web control — это веб-интерфейс, который отправляет команды OBS

Иногда они объединяются: overlay показывает состояние, а панель управления переключает сцены. Но технически это разные задачи

Частые ошибки

Первая ошибка — путать OBS WebSocket и browser source. Browser source показывает веб-страницу внутри OBS, а WebSocket управляет OBS

Вторая ошибка — отключить пароль ради удобства. Так можно случайно открыть управление сценами посторонним

Третья ошибка — подключаться из браузера напрямую к удаленному OBS через небезопасный канал. Для удаленного доступа продумайте сеть и wss

Четвертая ошибка — не проверять названия сцен перед переключением. Получайте GetSceneList, а не пишите имена наугад

Пятая ошибка — считать obs web отдельной официальной программой. Чаще это просто общее название веб-управления, которое внутри использует OBS WebSocket или сторонний remote-control инструмент