Трансляция игр из LXC-контейнера: Steam + Sunshine + Moonlight
Обновлено 14 ноября 2026

Зачем и как устроено
Steam-игры можно запускать на домашнем сервере под Calculate, а картинку и звук получать на TV-приставке по локальной сети. Весь игровой стек — Steam, Sunshine и их зависимости — живёт внутри одного LXC-контейнера. Это позволяет поставить трансляцию на серверную сборку Calculate Linux без graphical-профиля и без Xorg на хосте: достаточно Calculate Scratch Server, а всю графику контейнер поднимает у себя. Хосту нужны LXC с cl-lxc и модуль ядра uinput, а для игр без нативной версии — ещё и видеокарта; сам контейнер переезжает на другой сервер копированием своего каталога.
Работает это так. Внутри контейнера разворачивается игровая сессия без физического монитора, Sunshine захватывает экран и кодирует кадр программным видеокодеком x264, а клиент Moonlight на приставке отображает кадр и передаёт обратно ввод с геймпада. Игры с нативной версией под Linux при этом обходятся процессором хоста: графические библиотеки Steam работают на программной растеризации. Играм, у которых такой версии нет и которые запускаются через совместимость Proton, нужна видеокарта хоста — их слой DirectX работает поверх Vulkan. Достаточно узла рендеринга: карта остаётся доступной и хосту.

Подготовка хоста
Установите на хост app-containers/cl-lxc и LXC; порядок установки и общая механика работы с cl-lxc описаны в статье про LXC-контейнеры, здесь они не повторяются.
Отдельно включите на хосте модуль ядра uinput: через него Sunshine создаёт виртуальный геймпад, который видит Steam. Ядро Calculate собирает его как загружаемый модуль (CONFIG_INPUT_UINPUT=m), поэтому добавьте его в автозагрузку — в Calculate за это отвечает служба modules в уровне boot и каталог /etc/modules-load.d:
/etc/modules-load.d/uinput.conf
uinput
Одного модуля мало. Контейнер по умолчанию не пускают к устройствам ввода, а управление внутри него не запускает собственную службу устройств, поэтому в конфиг контейнера /var/calculate/lxc/steam/config на хосте допишите доступ к узлам и проброс каталога событий:
/var/calculate/lxc/steam/config
lxc.cgroup2.devices.allow = c 10:223 rwm lxc.cgroup2.devices.allow = c 13:* rwm lxc.mount.entry = /dev/input dev/input none bind,optional,create=dir
Строка mknod /dev/uinput c 10 223 в стартовом скрипте сессии нужна только на случай, когда модуль был загружен уже после запуска контейнера. Проверьте совпадение групп: узлы /dev/input/event* на хосте принадлежат группе input, и её номер в контейнере может отличаться от хостового — сравните вывод getent group input там и там и, при расхождении, заведите в контейнере группу с номером хоста и включите в неё пользователя сессии.
После этих изменений перезапустите контейнер и убедитесь изнутри, что узлы на месте: ls /dev/input показывает не менее одного event<N>, а cat /sys/class/input/event<N>/device/name называет устройство, созданное Sunshine.
Состав контейнера
Создайте контейнер обычным способом, дав ему имя steam:
cl-lxc -c steam
Внутри контейнера опишите игровой стек в пользовательском наборе — одним файлом /etc/portage/sets/custom, по пакету на строку:
/etc/portage/sets/custom
net-misc/sunshine games-util/steam-launcher x11-base/xorg-server x11-drivers/xf86-input-libinput x11-wm/openbox x11-apps/xrandr x11-terms/xterm x11-apps/xdpyinfo media-video/pipewire media-video/wireplumber media-libs/netpbm net-dns/avahi sys-apps/dbus
Там же задайте флаги Sunshine: для трансляции без видеокарты нужны X — захват экрана сессии X11, и x264 — программный видеокодек:
/etc/portage/package.use/custom
net-misc/sunshine X x264
Установите пакеты набора командой cl-update: она ставит всё, что перечислено в наборе, и ей же восстанавливают стек после обновления профиля (cl-lxc -p), которое переносит файлы custom:
cl-update
Здесь x11-base/xorg-server работает как Xvfb (виртуальный X-сервер без монитора), media-video/pipewire с wireplumber дают звуковую подсистему, net-dns/avahi — обнаружение хоста в сети, sys-apps/dbus — шину, без которой Steam-рантайм не запускается.
Sunshine в контейнере
Веб-интерфейс Sunshine доступен по адресу https://<IP-хоста>:47990; пароль задайте однократно при первом входе. В конфиге Sunshine ~/.config/sunshine/sunshine.conf пользователя сессии укажите:
~/.config/sunshine/sunshine.conf
encoder = software origin_web_ui_allowed = lan upnp = disabled gamepad = auto
Значение encoder = software фиксирует программный кодек, origin_web_ui_allowed = lan открывает веб-интерфейс клиентам локальной сети, а upnp = disabled отключает автоматическую настройку портов на роутере: контейнеру она не нужна. Во время трансляции Sunshine использует порты 47984 и 47989 по TCP, диапазон 47998–48000 по UDP и 47990 по TCP для веб-интерфейса.
Параметр gamepad задаёт тип геймпада, который Sunshine создаёт на сервере: auto выбирает его по сообщению клиента, также доступны x360, xone, ds4, ds5, switch и generic. Родственные параметры motion_as_ds4 и touchpad_as_ds4 работают только при gamepad = auto, а параметр gamepad_driver относится к Windows и на Linux значения не имеет.
Если на хосте есть видеокарта
Кодирование кадра можно отдать видеокарте хоста — процессор освободится под игру. Одной замены encoder в конфиге для этого мало: кодек должен быть собран в пакете Sunshine, на хосте — работать драйвер карты, а контейнер должен видеть её устройства. Ниже полные пути для NVENC (NVIDIA) и VAAPI (AMD и Intel); каждый шаг заканчивается проверкой, по которой видно, что результат получен.
Карты NVIDIA
Поддержка NVENC встраивается в Sunshine при сборке всегда, отдельных USE-флагов у пакета для неё нет.
Установите драйвер на хосте — от имени root:
emerge -a x11-drivers/nvidia-drivers
Загрузите модуль ядра nvidia командой modprobe nvidia (сам модуль собирается эбилдом драйвера) и убедитесь, что lsmod его показывает.
Установите тот же драйвер внутри контейнера — от имени root, версии хоста и контейнера должны совпадать, иначе пользовательские библиотеки не договорятся с модулем ядра:
emerge -a x11-drivers/nvidia-drivers
Пробросьте устройства видеокарты из хоста в контейнер — в файле /var/calculate/lxc/steam/config на хосте:
/var/calculate/lxc/steam/config
lxc.mount.entry = /dev/nvidia0 dev/nvidia0 none bind,optional,create=file lxc.mount.entry = /dev/nvidiactl dev/nvidiactl none bind,optional,create=file lxc.mount.entry = /dev/nvidia-uvm dev/nvidia-uvm none bind,optional,create=file lxc.mount.entry = /dev/nvidia-uvm-tools dev/nvidia-uvm-tools none bind,optional,create=file
и добавьте пользователя сессии в группу video — ей принадлежат эти узлы на хосте. После изменений перезапустите контейнер и проверьте результат изнутри: nvidia-smi должен показывать карту и версию драйвера. Если карта не видна, устройств в контейнере нет — проверьте строки проброса и что модуль nvidia загружен на хосте.
Карты AMD и Intel
Кодек VAAPI встраивается в Sunshine только с одноимённым флагом, поэтому допишите vaapi к строке sunshine в /etc/portage/package.use/custom контейнера — с учётом флагов из «Состава контейнера» строка выглядит так:
/etc/portage/package.use/custom
net-misc/sunshine X x264 vaapi
Переустановите пакет, чтобы флаг вступил в силу:
emerge -a sunshine
Внутри контейнера должна стоять Mesa с драйвером вашего производителя: переменная VIDEO_CARDS — radeonsi для AMD и intel для встроенной графики Intel; задайте её в /etc/portage/make.conf контейнера и обновите систему командой cl-update. На хосте драйвер для этих карт входит в систему: модули ядра amdgpu, i915 или xe загружаются автоматически, отдельной установки не требуется.
Пробросьте узел рендеринга в контейнер — в /var/calculate/lxc/steam/config на хосте:
/var/calculate/lxc/steam/config
lxc.mount.entry = /dev/dri dev/dri none bind,optional,create=dir
и добавьте пользователя сессии в группы video и render — им принадлежит узел /dev/dri/renderD128.
Проверьте доступность кодеков внутри контейнера утилитой vainfo (пакет media-libs/libva-utils): в выводе должны быть перечислены профили H.264 и HEVC с точками входа кодирования — VAEntrypointEncSlice и родственными. Если вывода нет или профили отсутствуют, устройств в контейнере не видно или не совпадает версия Mesa.
Для игр, которым нужна видеокарта, тем же способом проверьте Vulkan. Установите в контейнере dev-util/vulkan-tools (там же, где вы ставили остальной стек, — из пользовательского набора) и посмотрите список устройств:
vulkaninfo --summary
В выводе должны быть имя устройства (deviceName) и поддержки поверхностей VK_KHR_xlib_surface или VK_KHR_xcb_surface; отсутствие устройства означает, что Mesa собрана без нужного набора VIDEO_CARDS или узлы не проброшены. Если сессия контейнера запускается с переменными LIBGL_ALWAYS_SOFTWARE=1 и GALLIUM_DRIVER=llvmpipe, после проброса карты их уберите — иначе программы продолжат растеризовать на процессоре, несмотря на доступное устройство.
Переключение кодека
Когда устройства видны из контейнера (vainfo или nvidia-smi показали результат), замените в sunshine.conf строку encoder = software на encoder = vaapi для AMD и Intel или на encoder = nvenc для NVIDIA — остальные строки конфига менять не нужно, — и перезапустите Sunshine в контейнере. Признаком аппаратного кодирования служит загрузка процессора во время трансляции: с аппаратным кодеком она заметно ниже, чем в режиме software.
Звук
Звуковой путь вручную настраивать не нужно: Sunshine сам создаёт виртуальный sink в звуковой подсистеме контейнера и делает его системным по умолчанию, поэтому параметры вроде audio_sink в конфиге не выставляйте. Внутри контейнера работают PipeWire и WirePlumber; сессионную шину D-Bus запускайте в стартовом скрипте сессии через dbus-launch. Играм на SDL звук передавайте через PulseAudio-совместимый интерфейс — переменной окружения SDL_AUDIODRIVER=pulse.
Автозапуск сессии без монитора
Физического дисплея у контейнера нет, поэтому подготовьте сессию к автоматическому запуску при загрузке контейнера — стандартным openrc-сервисом. В эталонной конфигурации это скрипт /etc/init.d/steam-desktop, добавленный в runlevel default. Он создаёт устройство /dev/uinput (mknod c 10 223), каталог run-данных пользователя /run/user/<uid> и от имени обычного пользователя запускает скрипт сессии, который последовательно включает PipeWire, WirePlumber, PulseAudio-совместимый слой, Xvfb, оконный менеджер, Sunshine и Steam.
Роль X-сервера играет Xvfb: запускайте его на номере дисплея, свободном на хосте (в эталонной конфигурации — :7). Так как 3D-ускорителя нет, OpenGL включайте в программном режиме, задав сессии переменные окружения LIBGL_ALWAYS_SOFTWARE=1 и GALLIUM_DRIVER=llvmpipe — при таком наборе Steam и игры работают на растеризации процессором.

Автозапуск контейнера после перезагрузки хоста
cl-lxc не настраивает запуск контейнера при загрузке машины, а служба lxc на хосте по умолчанию ни в одном уровне запуска не состоит — проверьте это командой rc-update show -v. Без этой настройки после перезагрузки хоста контейнер не поднимется сам, и с приставки подключиться не удастся: транслировать будет нечего.
Для каждого контейнера заводится отдельная служба — её имя должно совпадать с именем контейнера, иначе при запуске служба сообщит о несовпадении имён. Для контейнера steam это так:
rc-update add lxc.steam boot
Служба сама находит конфиг контейнера в каталоге, который возвращает lxc-config lxc.lxcpath (в сборке cl-lxc это /var/calculate/lxc), поэтому отдельных указаний пути не требуется. После добавления проверьте результат:
Клиент на приставке
На стороне приставки используйте клиент Moonlight под Android TV; хост в нём укажите по IP-адресу. При первом подключении Moonlight показывает четырёхзначный PIN — введите его в веб-интерфейсе Sunshine, и клиент появится в списке разрешённых. Дальше на приставке доступны приложения из Steam: Desktop, Low Res Desktop и Steam Big Picture.

Геймпад подключите по Bluetooth к самой приставке и сделайте это до запуска трансляции: Sunshine создаёт устройства ввода только на время активной сессии, и отключённый на приставке пульт он показать играм не сможет. Проверить передачу контроллера можно по журналу консоли sunshine.log в каталоге состояния сессии: строка вида Gamepad will be … означает, что геймпад создан. Порядок запуска тоже важен: сначала подключение с приставки, затем запуск игры — иначе игра перечислит доступные устройства на своём старте и геймпад не увидит.
Переносимость контейнера и требования к хосту
Весь стек живёт внутри контейнера, поэтому перенос на другой сервер сводится к копированию каталога /var/calculate/lxc/steam вместе с репозиторием профиля, если используете собственный. Чтобы это работало, весь функциональный стек держите описанным в наборе /etc/portage/sets/custom. Новому хосту нужны только LXC с cl-lxc и модуль uinput: ядро Calculate единое для всех изданий, десктопная сборка не требуется, и серверное издание CLS подходит без изменений.
Основная нагрузка при трансляции — программное кодирование x264. Для комфортных 1080p при 60 кадрах в секунду хосту нужен многоядерный процессор с AVX2; практичный ориентир — не менее шести ядер. Контейнер работает в сетевом неймспейсе хоста: порты Sunshine слушают непосредственно на IP-адресе хоста, NAT не требуется, но правила файрвола хоста должны пропускать перечисленные выше порты.
См. также
- LXC-контейнеры в Calculate — установка cl-lxc, профили контейнеров и параметры Portage внутри контейнера.