Установка OBS Studio на Debian 13, 12, 11: полное руководство

OBS Studio (Open Broadcaster Software) — это мощное приложение для записи видео с экрана и потокового вещания. Оно широко используется геймерами, стримерами, преподавателями и IT-специалистами для записи уроков, вебинаров, игр и презентаций. OBS поддерживает захват экрана, веб-камеры, микшера, сцен, источников и многое другое.

В этом руководстве я покажу три способа установки OBS Studio на Debian:

  1. APT — из официальных репозиториев Debian (просто, но версия зависит от релиза)
  2. Flatpak — актуальная версия из Flathub (рекомендуется)
  3. Сборка из исходников — для самых свежих версий (только Debian 13)
МетодВерсияОбновленияДля кого
APTDebian 13: 30.2.x; Debian 12: 29.0.x; Debian 11: 26.1.xЧерез
apt upgrade		Те, кому нужна
стабильная версия из
репозитория
Flatpak
(рекомендуемый)		Последняя (32.1.x+)Через
flatpak update		Большинство
пользователей
Сборка из
исходников		Последняя (32.1.x+)Вручную
(скрипт-помощник)		Только Debian 13
(требует CMake 3.31+ и Qt6)

⚠️ Важно: Сборка из исходников работает только на Debian 13 из-за требований к CMake и Qt6. На Debian 12 и 11 используйте APT или Flatpak.

Оглавление

Предварительные требования

Перед установкой убедитесь, что:

  • У вас есть графическая среда (GNOME, KDE, Xfce и т.д.)
  • Вы имеете права sudo (администратора)

⚠️ ВАЖНО: Проверьте права sudo перед установкой

Если вы не уверены, есть ли у вашего пользователя права администратора, выполните в терминале:

sudo whoami

Что делает: sudo — выполняет команду от имени суперпользователя; whoami — показывает имя текущего пользователя.

✅ Ожидаемый вывод в терминале:

root

❌ Если выводит is not in the sudoers file — сначала пройдите наше руководство по настройке sudo.

Способ 1: Установка OBS Studio через APT

Шаг 1: Обновите систему

sudo apt update && sudo apt upgrade -y

Шаг 2: Установите OBS Studio

sudo apt install -y obs-studio

Шаг 3: Проверьте установку

obs --version

✅ Ожидаемый вывод (зависит от версии Debian):

  • Debian 13: OBS Studio 30.2.3
  • Debian 12: OBS Studio 29.0.2
  • Debian 11: OBS Studio 26.1.2

Способ 2: Установка OBS Studio через Flatpak (рекомендуемый)

Flatpak даёт самую свежую версию OBS Studio на любой версии Debian.

Шаг 1: Установите Flatpak (если ещё не установлен)

Если Flatpak не установлен, сначала пройдите наше руководство по установке Flatpak на Debian.

Шаг 2: Добавьте репозиторий Flathub (если ещё не добавлен)

sudo flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo

Шаг 3: Установите OBS Studio

sudo flatpak install flathub com.obsproject.Studio

Шаг 4: Проверьте установку

flatpak info com.obsproject.Studio

✅ Ожидаемый вывод: ID: com.obsproject.Studio, Version: 32.1.2

Способ 3: Сборка OBS Studio из исходников (только Debian 13)

Этот способ подходит только для Debian 13 (Trixie), так как требует CMake 3.31+ и Qt6. Не пытайтесь собрать на Debian 12 или 11.

Шаг 1: Установите зависимости для сборки

sudo apt install -y ca-certificates cmake extra-cmake-modules ninja-build pkg-config build-essential clang clang-format ccache curl git zsh python3-dev swig \
libavcodec-dev libavdevice-dev libavfilter-dev libavformat-dev libavutil-dev libswresample-dev libswscale-dev libx264-dev \
libcurl4-openssl-dev libmbedtls-dev libgl1-mesa-dev libjansson-dev libluajit-5.1-dev libx11-dev libxcb-randr0-dev \
libxcb-shm0-dev libxcb-xinerama0-dev libxcb-composite0-dev libxcomposite-dev libxinerama-dev libxcb1-dev libx11-xcb-dev \
libxcb-xfixes0-dev libcmocka-dev libxss-dev libglvnd-dev libgles2-mesa-dev libwayland-dev librist-dev libsrt-openssl-dev \
libpci-dev libpipewire-0.3-dev libqrcodegencpp-dev uthash-dev libsimde-dev qt6-base-dev qt6-base-private-dev qt6-svg-dev \
qt6-wayland qt6-image-formats-plugins libasound2-dev libfontconfig-dev libfreetype6-dev libjack-jackd2-dev libpulse-dev \
libsndio-dev libspeexdsp-dev libudev-dev libv4l-dev libva-dev libvlc-dev libvpl-dev libdrm-dev nlohmann-json3-dev \
libwebsocketpp-dev libasio-dev

Шаг 2: Определите последнюю стабильную версию

OBS_TAG=$(curl -fsSL https://api.github.com/repos/obsproject/obs-studio/tags?per_page=20 | python3 -c 'import json, re, sys
for tag in json.load(sys.stdin):
    name = tag.get("name", "")
    if re.fullmatch(r"[0-9]+\.[0-9]+\.[0-9]+", name):
        print(name)
        break')
printf '%s\n' "$OBS_TAG"

✅ Ожидаемый вывод: 32.1.2 (или новее)

Шаг 3: Скачайте исходный код

git clone --recursive --branch "$OBS_TAG" https://github.com/obsproject/obs-studio.git "$HOME/obs-studio-source"
cd "$HOME/obs-studio-source"

Шаг 4: Настройка, компиляция и установка

cmake --preset ubuntu \
  -DCMAKE_BUILD_TYPE=Release \
  -DCMAKE_INSTALL_PREFIX=/usr/local \
  -DOBS_COMPILE_DEPRECATION_AS_WARNING=ON \
  -DENABLE_AJA=OFF \
  -DENABLE_BROWSER=OFF \
  -DENABLE_WEBRTC=OFF \
  -DENABLE_NVENC=OFF \
  -DENABLE_FFMPEG_NVENC=OFF

cmake --build build_ubuntu --parallel "$(nproc)"
sudo cmake --install build_ubuntu
sudo ldconfig

Шаг 5: Проверьте установку

command -v obs
/usr/local/bin/obs --version

✅ Ожидаемый вывод: /usr/local/bin/obs и версия 32.1.2.

Шаг 6: Скрипт для обновления (опционально)

Создайте скрипт для автоматического обновления сборки. Полный код скрипта приведён в оригинале. Краткая версия:

sudo tee /usr/local/bin/update-obs-source.sh > /dev/null << 'SCRIPT'
#!/usr/bin/env bash
set -euo pipefail

SOURCE_DIR="$HOME/obs-studio-source"
BUILD_DIR="$SOURCE_DIR/build_ubuntu"
OBS_BIN="/usr/local/bin/obs"
MIN_CMAKE="3.28.0"
TAGS_API="https://api.github.com/repos/obsproject/obs-studio/tags?per_page=20"

# ... (полный скрипт см. в оригинале)
SCRIPT

sudo chmod +x /usr/local/bin/update-obs-source.sh

Запуск обновления:

update-obs-source.sh

Запуск OBS Studio

Запуск из терминала

Для APT и source-сборки:

obs

Для Flatpak:

flatpak run com.obsproject.Studio

Запуск из меню приложений

Найдите OBS Studio в меню приложений (категория «Мультимедиа» или «Видео»).

Настройка захвата экрана на Wayland

Если вы используете Wayland (GNOME по умолчанию), для захвата экрана нужны дополнительные пакеты:

Для GNOME:

sudo apt install -y xdg-desktop-portal xdg-desktop-portal-gnome pipewire

Для KDE Plasma:

sudo apt install -y xdg-desktop-portal xdg-desktop-portal-kde pipewire

Выйдите из системы и зайдите снова после установки.

Решение типичных проблем

8.1 Ошибка: Нет захвата экрана на Wayland

Симптом: В списке источников нет Screen Capture (PipeWire) или чёрный экран.

Причина: Отсутствуют порталы Wayland и PipeWire.

Пошаговое решение:

Установите порталы (см. раздел «Настройка захвата экрана на Wayland»), затем выйдите из системы и зайдите снова.

8.2 Ошибка: Недоступны аппаратные кодеки (NVENC, VA-API)

Симптом: В настройках вывода нет аппаратных кодеков.

Причина: Не установлены драйверы для видеокарты.

Пошаговое решение:

Для NVIDIA: Установите драйверы NVIDIA

Для AMD/Intel:

sudo apt install -y mesa-va-drivers vainfo
vainfo | grep -E 'VAProfile.*EntrypointEnc'

8.3 Ошибка: OBS Studio не запускается

Симптом: При запуске из меню ничего не происходит.

Пошаговое решение:

Запустите из терминала, чтобы увидеть ошибку:

obs --verbose 2>&1 | head -50

Временно переименуйте папку с настройками:

mv ~/.config/obs-studio ~/.config/obs-studio.bak
obs

8.4 Ошибка: Flatpak-версия не видит установленные плагины

Симптом: Плагины, установленные через APT, не видны в Flatpak-версии.

Причина: Flatpak изолирован и не видит системные плагины.

Пошаговое решение:

Устанавливайте плагины через Flatpak или используйте APT-версию OBS.

8.5 Ошибка: Сборка из исходников на Debian 12 или 11

Симптом: cmake --preset ubuntu выдаёт ошибку.

Причина: Слишком старая версия CMake или отсутствие Qt6.

Пошаговое решение:

Используйте APT или Flatpak. Сборка из исходников поддерживается только на Debian 13.

Чек-лист: что проверить после установки

  • [ ] OBS Studio установлен: obs --version (APT) или flatpak info com.obsproject.Studio (Flatpak) показывает версию
  • [ ] Программа запускается: команда запуска открывает окно OBS
  • [ ] Захват экрана работает: добавьте источник Screen Capture (PipeWire) или Screen Capture (XSHM)
  • [ ] Микрофон работает: в аудиомикшере виден уровень сигнала
  • [ ] Можно записать тестовое видео: нажмите Start Recording, затем Stop Recording
  • [ ] Для сборки из исходников: which obs → /usr/local/bin/obs

Обновление OBS Studio

Обновление APT-версии

sudo apt update && sudo apt install --only-upgrade obs-studio -y

Обновление Flatpak-версии

sudo flatpak update com.obsproject.Studio

Обновление source-сборки

update-obs-source.sh

Удаление OBS Studio

Удаление APT-версии

sudo apt remove obs-studio
sudo apt autoremove

Удаление Flatpak-версии

sudo flatpak uninstall com.obsproject.Studio
sudo flatpak uninstall --unused

Удаление source-сборки

sudo rm -f /usr/local/bin/obs /usr/local/bin/update-obs-source.sh
sudo rm -rf /usr/local/share/obs
sudo rm -rf ~/obs-studio-source
sudo ldconfig

Удаление пользовательских настроек (опционально)

rm -rf ~/.config/obs-studio
rm -rf ~/.var/app/com.obsproject.Studio

Часто задаваемые вопросы (FAQ)

Вопрос: Какая версия OBS Studio в Debian 13?
Ответ: Debian 13 (Trixie) содержит OBS Studio 30.2.x в официальных репозиториях.

Вопрос: Какой способ установки выбрать?
Ответ: Flatpak — самая свежая версия с автоматическими обновлениями. APT — стабильная, но устаревшая (особенно на Debian 11/12).

Вопрос: Можно ли установить OBS Studio на Debian 11?
Ответ: Да, через APT (версия 26.1.x) или Flatpak (последняя версия).

Вопрос: Почему не работает захват экрана на Wayland?
Ответ: Установите xdg-desktop-portal и pipewire (см. раздел «Настройка захвата экрана на Wayland»).

Вопрос: Как использовать Browser Source в OBS?
Ответ: В сборке из исходников Browser Source отключён. Используйте Flatpak-версию, где он включён.

Заключение

Теперь OBS Studio установлен на вашем Debian. Вы можете записывать видео с экрана, вести прямые эфиры и создавать профессиональный контент.

Что дальше?

Связанные записи