P2P LiveFree live streaming · peer-to-peer delivery

Обучение

Как устроена эта система и как её настроить — без предварительных знаний.

Как работает одноранговая трансляция

Один сервер, много зрителей

Без однорангового обмена каждый зритель скачивает каждую секунду видео с вашего исходного сервера. Десять зрителей — десятикратный трафик. Тысяча зрителей — тысячекратный.

Видео приходит кусочками

Поток HLS — это список небольших файлов по несколько секунд каждый. Поскольку всем зрителям нужны одни и те же файлы в одном порядке, тот, у кого файл уже есть, может отдать его тому, у кого его нет.

Зрители помогают друг другу

При одноранговом обмене первый зритель берёт кусочек видео с исходного сервера и передаёт его остальным напрямую, из браузера в браузер. Исходный сервер отдаёт каждый кусочек гораздо реже.

Один зритель ведёт

Рой выбирает одного зрителя ведущим. Ведущий идёт немного впереди, качает с исходного сервера и снабжает остальных. Если он закроет вкладку, другой примет роль меньше чем за секунду.

Ничто никогда не зависит от соседа

Если кусочек не пришёл вовремя от другого зрителя, браузер просто скачает его с исходного сервера. Одноранговый обмен может только удешевить доставку, но не сделать её менее надёжной.

Первые шаги

Для начала нужно только одно: веб-адрес плейлиста HLS. Он заканчивается на .m3u8 и должен быть доступен из интернета. Всё, что ниже, — о том, как получить такой адрес в зависимости от того, что у вас есть сейчас.

Если у вас уже есть адрес HLS

  1. Войдите и откройте Мой канал.
  2. Вставьте адрес в поле Адрес потока HLS (.m3u8). Он должен начинаться с http:// или https://.
  3. Дайте каналу название и нажмите Сохранить.
  4. Нажмите Проверить поток сейчас. Через несколько секунд статус сменится на В ЭФИРЕ.
  5. Откройте страницу своего канала и запустите воспроизведение. Затем откройте ту же страницу во втором браузере — именно тогда включается peer-to-peer: для обмена нужны два зрителя, иначе делиться не с кем.

Если проверка сообщает, что поток недоступен, почти всегда дело в одном из двух: адрес недоступен извне вашей сети или исходный сервер не отправляет заголовок Access-Control-Allow-Origin. Без него браузеры отказываются воспроизводить поток с другого сервера.

Если ваш источник — RTMP (большинство кодировщиков, OBS)

Кодировщик отправляет RTMP на сервер, а сервер записывает HLS. С этим справится любой из nginx-rtmp, MediaMTX, Flussonic или ffmpeg. Минимальный вариант на ffmpeg, на машине, которая принимает поток:

ffmpeg -listen 1 -i rtmp://0.0.0.0:1935/live/mystream \
       -c copy -f hls \
       -hls_time 4 -hls_list_size 6 -hls_flags delete_segments+independent_segments \
       /var/www/live/mystream/playlist.m3u8

Раздавайте /var/www/live любым веб-сервером, добавьте заголовок CORS и укажите здесь https://yourhost/live/mystream/playlist.m3u8 как адрес потока.

-c copy означает, что видео не перекодируется, поэтому процессор почти не нагружается. Используйте этот вариант, если кодировщик уже выдаёт H.264 и AAC, — а так делают почти все.

Если ваш источник — SRT

SRT — транспорт для доставки потока: он надёжно передаёт поток между серверами, но ни один браузер не умеет его воспроизводить. Принимайте и упаковывайте его так же:

ffmpeg -i "srt://0.0.0.0:9000?mode=listener&latency=200" \
       -c copy -f hls \
       -hls_time 4 -hls_list_size 6 -hls_flags delete_segments+independent_segments \
       /var/www/live/mystream/playlist.m3u8

Если ваш источник — multicast (UDP или RTP)

Эта система не может читать multicast-адрес — и ни один браузер не может. Это не недостающая функция, а природа multicast. Multicast доставляет одну копию потока множеству получателей в сети, которая настроена его передавать; поэтому внутри сети оператора он работает прекрасно, а в публичном интернете его нет вовсе. У браузера нет способа присоединиться к multicast-группе.

Поэтому multicast преобразуется один раз — на машине внутри сети, которая его принимает, — а в интернет выходит результат в HLS:

ffmpeg -i "udp://@239.0.0.1:1234?fifo_size=1000000&overrun_nonfatal=1" \
       -c copy -f hls \
       -hls_time 4 -hls_list_size 6 -hls_flags delete_segments+independent_segments \
       /var/www/live/channel1/playlist.m3u8

Для RTP используйте rtp://@239.0.0.1:1234. Если multicast-источник в MPEG-2 или другом кодеке, который браузеры не воспроизводят, замените -c copy настоящим кодированием:

-c:v libx264 -preset veryfast -b:v 3000k -g 100 -c:a aac -b:a 128k

Одно преобразование обслуживает любое число зрителей, потому что дальше распространением занимается рой peer-to-peer.

Если ваш источник — IP-камера (RTSP)

ffmpeg -rtsp_transport tcp -i rtsp://user:password@camera.local/stream1 \
       -c:v libx264 -preset veryfast -g 50 -c:a aac \
       -f hls -hls_time 2 -hls_list_size 5 -hls_flags delete_segments \
       /var/www/live/camera1/playlist.m3u8

Заголовок CORS — один раз и навсегда

Чем бы ни создавался ваш HLS, веб-сервер, который отдаёт его зрителям, должен отправлять:

Access-Control-Allow-Origin: *

В nginx:

location /live/ {
    add_header Access-Control-Allow-Origin * always;
    add_header Cache-Control "no-cache" always;
    types { application/vnd.apple.mpegurl m3u8; video/mp2t ts; }
    root /var/www;
}

Без него проверка потока сообщит, что CORS отсутствует, и ни один браузер не воспроизведёт поток — ни с peer-to-peer, ни без него.

Откуда берётся ваш поток

Поддерживается напрямую

HLS по HTTP или HTTPS

Вставьте адрес плейлиста в панель управления. Больше ничего не нужно.

https://origin.example.com/live/stream/playlist.m3u8

Записанный файл

Отдавайте его как HLS по HTTP. Подойдёт любой веб-сервер.

https://files.example.com/vod/show/playlist.m3u8

Требует предварительного преобразования

Multicast (UDP или RTP)

Браузеры не могут подключиться к multicast-группе, поэтому и этот сервер не может её читать. Сначала преобразуйте поток в HLS в своей сети.

udp://@239.0.0.1:1234 → HLS

SRT

Транспорт подачи. Примите его на сервере, упакуйте в HLS, затем укажите эту систему на полученный плейлист.

srt://host:9000 → HLS

RTMP

Отправьте его на сервер, который собирает HLS, и используйте здесь адрес этого плейлиста.

rtmp://host/app/key → HLS

RTSP (камеры)

Типично для IP-камер. Преобразуйте в HLS с помощью ffmpeg или медиасервера, затем используйте полученный адрес.

rtsp://camera/stream → HLS

Откуда это различие

Всё, что воспроизводит зритель, его браузер загружает по HTTP как файл с URL. На этом держится вся часть peer-to-peer: два зрителя могут поделиться фрагментом видео, только если оба называют его одинаково. URL и есть это имя.

Multicast, SRT, RTMP и RTSP — это транспорты: они передают поток с одной машины на другую. Ни один из них не создаёт адресуемых файлов, и ни один браузер не говорит ни на одном из них. Поэтому их сначала преобразуют, и поэтому преобразование выполняется один раз, а не для каждого зрителя.

Как выбрать длину сегмента

-hls_time задаёт длительность каждого фрагмента. Это единственная настройка, над которой стоит подумать:

  • 2 секунды — меньше задержка, больше запросов, меньше времени, чтобы узел успел передать фрагмент до того, как он понадобится.
  • 4 секунды — хорошее значение по умолчанию; его используют примеры выше.
  • 6 секунд и больше — наибольшие шансы, что peer-to-peer будет работать хорошо, ценой задержки.

Peer-to-peer лучше работает с более длинными сегментами: у зрителя больше времени, чтобы передать фрагмент другому, прежде чем он понадобится при воспроизведении. Если жёстких требований к задержке нет, четыре секунды — разумная отправная точка.

Стабильные URL сегментов

Два зрителя делятся фрагментом видео, только когда оба запрашивают один и тот же URL. Если ваш CDN выдаёт каждому зрителю свой адрес для одного и того же сегмента — токен на зрителя, имя хоста на сервер, — то никакие два зрителя не узнают фрагмент как тот же самый, и рой ничего не доставляет. Проверка потока предупреждает об этом, когда может это обнаружить.

Наблюдение за потоком

Что означает разгрузка

Это доля видео, которую ваши зрители доставили друг другу. При двух-трёх зрителях она обычно мала; при десятках часто превышает половину.

На странице вашего канала

Строка состояния под плеером простыми словами сообщает, что происходит: работает ли peer-to-peer, не единственный ли вы зритель и нет ли проблем с воспроизведением. Если в ней сказано, что поток недоступен, там же указана причина.

В панели управления

Проверить поток сейчас сразу запускает проверку потока: она загружает ваш плейлист так же, как это сделал бы браузер, и сообщает, доступен ли он, настроен ли CORS и что обнаружено внутри.

Как выглядит нормальная работа

  • Два зрителя — peer-to-peer подключается, но разгрузка остаётся небольшой. Одному зрителю приходится загружать с исходного сервера, чтобы второму было что получить.
  • Десять зрителей — разгрузка обычно достигает от трети до половины.
  • Десятки зрителей — разгрузка больше половины — это нормально, и трафик исходного сервера перестаёт расти вместе с аудиторией. Ради этого всё и делается.

Нулевая разгрузка при нескольких зрителях — повод разобраться: обычно это значит, что зрители не могут связаться друг с другом, и это исправляет ретранслятор TURN. Чаще всего так бывает в мобильных сетях.

Если зрители сообщают об ошибках

Страница Аналитика в реальном времени у администратора показывает ошибки, о которых сообщили зрители, по каждому потоку, включая протокол HTTP, которым шёл неудачный запрос. Если поток нормально воспроизводится на вашей машине, но не работает у зрителей в других местах, обычно дело в CDN или в географии, а не в самом потоке, — и именно эта колонка помогает их различить.

Глоссарий

HLS
HTTP Live Streaming. Способ передавать видео в виде списка небольших файлов, которые любой браузер скачивает по обычному HTTP.
Плейлист (.m3u8)
Текстовый файл, который по порядку перечисляет кусочки вашего потока. Именно этот адрес вы вставляете в панель управления.
Сегмент
Небольшой файл видео, обычно длиной от 2 до 6 секунд. Именно ими обмениваются зрители.
Исходный сервер
Сервер, откуда поток действительно берётся: ваш кодировщик, упаковщик или CDN. Одноранговый обмен уменьшает объём, который ему приходится отдавать.
Рой
Все, кто смотрит один и тот же поток одновременно. Они обмениваются сегментами друг с другом.
Ведущий
Зритель, которого рой выбрал, чтобы качать с исходного сервера и снабжать остальных.
Сосед
Другой зритель, с которым ваш браузер соединён напрямую.
WebRTC
Браузерная технология, позволяющая двум зрителям обмениваться данными напрямую, минуя сервер.
STUN
Небольшая вспомогательная служба, которая сообщает браузеру, как его собственный адрес выглядит снаружи, чтобы два зрителя смогли найти друг друга.
TURN
Ретранслятор на случай, когда два зрителя не могут связаться напрямую — обычное дело в мобильных сетях. Этот сервер умеет работать таким ретранслятором.
Разгрузка
Доля видео, доставленная зрителями, а не вашим исходным сервером. Чем выше, тем дешевле.
CORS
Правило, позволяющее веб-странице читать файлы с другого сервера. Ваш исходный сервер должен это разрешать, иначе браузеры откажутся воспроизводить поток.
Multicast
Способ отправить одну копию потока многим получателям в управляемой сети. Браузеры её принимать не умеют, поэтому сначала нужно преобразовать в HLS.
SRT
Транспорт для надёжной передачи потока между серверами через интернет. Это формат подачи, а не то, что может воспроизвести браузер.
RTMP
Более старый протокол, до сих пор широко используемый для передачи потока от кодировщика к серверу. Браузеры не воспроизводят его напрямую.
Перекодирование
Повторное кодирование видео в другой формат или качество. Нужно, когда источник изначально не подходит для браузеров.
Упаковка
Нарезка входящего потока на сегменты HLS и запись плейлиста — без обязательного перекодирования видео.