Установка 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)

Метод	Версия	Обновления	Для кого
APT	Debian 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"
cd "$SOURCE_DIR" || git clone --recursive https://github.com/obsproject/obs-studio.git "$SOURCE_DIR"
git -C "$SOURCE_DIR" fetch --tags
LATEST_TAG=$(git -C "$SOURCE_DIR" tag -l | grep -E '^[0-9]+\.[0-9]+\.[0-9]+$' | sort -V | tail -1)
git -C "$SOURCE_DIR" checkout "$LATEST_TAG"
git -C "$SOURCE_DIR" submodule update --init --recursive
rm -rf "$SOURCE_DIR/build_ubuntu"
cmake --preset ubuntu -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr/local \
  -DENABLE_BROWSER=OFF -DENABLE_NVENC=OFF -S "$SOURCE_DIR" -B "$SOURCE_DIR/build_ubuntu"
cmake --build "$SOURCE_DIR/build_ubuntu" --parallel "$(nproc)"
sudo cmake --install "$SOURCE_DIR/build_ubuntu"
sudo ldconfig
echo "OBS Studio обновлён до версии $LATEST_TAG"
SCRIPT
sudo chmod +x /usr/local/bin/update-obs-source.sh

Полная версия скрипта:

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

# Keep local OBS source and update logs in the current user's home directory.
SOURCE_DIR="$HOME/obs-studio-source"
BUILD_DIR="$SOURCE_DIR/build_ubuntu"
OBS_BIN="/usr/local/bin/obs"
MIN_CMAKE="3.28.0"
LOG_FILE="$HOME/obs-studio-source-update.log"
TAGS_API="https://api.github.com/repos/obsproject/obs-studio/tags?per_page=20"

log() {
  printf "%s\n" "$1"
}

fail() {
  printf "Error: %s\n" "$1" >&2
  exit 1
}

version_ge() {
  [ "$(printf "%s\n%s\n" "$2" "$1" | sort -V | head -n 1)" = "$2" ]
}

latest_stable_tag() {
  curl -fsSL "$TAGS_API" | 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'
}

if [ "$(id -u)" -eq 0 ]; then
  fail "Run this script as a regular user. It uses sudo only for the install step."
fi

for cmd in awk cmake curl git grep head ninja nproc python3 sort sudo; do
  command -v "$cmd" >/dev/null 2>&1 || fail "$cmd is required but not installed."
done

# shellcheck disable=SC1091
. /etc/os-release
if [ "${ID:-}" != "debian" ] || [ "${VERSION_CODENAME:-}" != "trixie" ]; then
  fail "This script is written for Debian 13 (Trixie). OBS 32.x needs Debian 13's CMake and Qt6 toolchain."
fi

CMAKE_VERSION="$(cmake --version | awk 'NR==1 {print $3}')"
version_ge "$CMAKE_VERSION" "$MIN_CMAKE" || fail "CMake $MIN_CMAKE or newer is required. Installed version: $CMAKE_VERSION"

CURRENT_VERSION="$($OBS_BIN --version 2>/dev/null | grep -m1 -oE '[0-9]+\.[0-9]+\.[0-9]+' || true)"
CURRENT_VERSION="${CURRENT_VERSION:-none}"
LATEST_TAG="$(latest_stable_tag)"
[ -n "$LATEST_TAG" ] || fail "Could not detect the latest stable OBS Studio tag from GitHub."

log "Current installed version: $CURRENT_VERSION"
log "Latest available version: $LATEST_TAG"

if [ "$CURRENT_VERSION" = "$LATEST_TAG" ]; then
  log "OBS Studio is already up to date."
  exit 0
fi

read -r -p "Continue with the OBS Studio update? [y/N] " REPLY
case "$REPLY" in
  [Yy]|[Yy][Ee][Ss]) ;;
  *)
    log "Update canceled."
    exit 0
    ;;
esac

printf "%s Starting OBS Studio update to %s\n" "$(date '+%F %T')" "$LATEST_TAG" >> "$LOG_FILE"

if [ -e "$SOURCE_DIR" ] && [ ! -d "$SOURCE_DIR/.git" ]; then
  fail "$SOURCE_DIR exists but is not a Git checkout. Move it out of the way and rerun the script."
fi

if [ ! -d "$SOURCE_DIR/.git" ]; then
  log "Cloning the OBS Studio source tree..."
  git clone --recursive https://github.com/obsproject/obs-studio.git "$SOURCE_DIR"
else
  log "Refreshing the OBS Studio source tree..."
  git -C "$SOURCE_DIR" fetch --tags --force origin
fi

log "Checking out OBS Studio $LATEST_TAG..."
git -C "$SOURCE_DIR" checkout "$LATEST_TAG"
git -C "$SOURCE_DIR" submodule sync --recursive
git -C "$SOURCE_DIR" submodule update --init --recursive

log "Removing the previous build directory..."
rm -rf "$BUILD_DIR"

log "Configuring OBS Studio..."
(
  cd "$SOURCE_DIR"
  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
)

log "Compiling OBS Studio. This can take several minutes..."
cmake --build "$BUILD_DIR" --parallel "$(nproc)"

log "Installing OBS Studio to /usr/local..."
sudo cmake --install "$BUILD_DIR"

log "Refreshing the dynamic linker cache..."
sudo ldconfig

NEW_VERSION="$($OBS_BIN --version 2>/dev/null | grep -m1 -oE '[0-9]+\.[0-9]+\.[0-9]+' || true)"
[ -n "$NEW_VERSION" ] || fail "OBS Studio installed, but the version check failed."

printf "%s Finished OBS Studio update to %s\n" "$(date '+%F %T')" "$NEW_VERSION" >> "$LOG_FILE"
log "OBS Studio is now updated to $NEW_VERSION"
log "Binary path: $OBS_BIN"
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. Вы можете записывать видео с экрана, вести прямые эфиры и создавать профессиональный контент.

Что дальше?

• Изучите официальную документацию OBS Studio
• Установите FFmpeg для обработки видео
• Настройте драйверы NVIDIA для аппаратного кодирования