P2P Live — Руководство пользователя
Это руководство объясняет всё, что нужно ведущему трансляции и зрителю: как работает сервис, как зарегистрироваться, каким должен быть ваш поток, как встроить плеер, как проверить, что доставка от зрителя к зрителю (P2P) работает, какие действуют ограничения и как решить самые частые проблемы.
Коротко: зарегистрируйтесь, вставьте адрес своего HLS-потока (ссылку
.m3u8) — и вы получите публичную страницуhttps://p2p.gia.tv/ваше_имяи код для встраивания. Зрители этой страницы делятся видео друг с другом через свои браузеры, поэтому ваш стриминговый сервер или CDN отдаёт поток один раз, а не по разу на каждого зрителя.
Как это работает
На каждой странице канала стоит обычный HLS-плеер (hls.js), к которому подключён P2P-движок.
- Первый зритель канала загружает плейлист и сегменты видео с вашего исходного сервера (указанного адреса
.m3u8) — точно так же, как любой другой плеер. - Каждый следующий зритель открывает ту же страницу. Плееры находят друг друга через сервер сигнализации этого сайта (небольшой WebSocket-сервис) и соединяются напрямую, от браузера к браузеру, по каналам данных WebRTC.
- Каждый сегмент видео загружает с источника один зритель (лидер роя), а затем он пересылается остальным по P2P-соединениям. Если сегмент не пришёл от другого зрителя вовремя, плеер сам берёт его с источника, так что воспроизведение никогда не зависит от других зрителей.
- Каждый сегмент проверяется (хеш и анализ содержимого) перед тем, как попасть в плеер. Другой участник не может подмешать испорченные данные в воспроизведение зрителя.
- Плееры отправляют анонимную статистику (байты с источника, байты от других зрителей, остановки, подключённые участники), чтобы вы видели долю разгрузки в панели управления.
Что это значит для вас:
- Трафик: при 50 зрителях ваш источник несёт нагрузку примерно 1–3 зрителей. Чем больше зрителей у канала, тем выше разгрузка (обычно 80–97 %).
- Качество: зрители смотрят тот же HLS-поток в том же качестве. P2P меняет только то, откуда приходят байты.
- Надёжность: если другие зрители медленные или пропадают, плеер незаметно переключается на источник. Поэтому источник должен быть всегда доступен: P2P снижает его нагрузку, но не заменяет его.
- Конфиденциальность: участники обмениваются только сегментами видео и небольшими служебными сообщениями. Личные данные между зрителями не передаются. Через WebRTC зрители могут видеть IP-адреса друг друга, как в любом P2P-видеосервисе.
Требования
Ваш поток должен соответствовать этим требованиям. Кнопка Проверить поток сейчас в панели управления проверит большинство из них за вас.
| Требование | Зачем | Как проверить |
|---|---|---|
HLS (плейлист .m3u8) по http:// или https:// | Плеер — это HLS-плеер. RTMP, RTSP, DASH, приём WebRTC и обычные файлы MP4 напрямую не поддерживаются. | Откройте ссылку в браузере: должен загрузиться небольшой текстовый файл, начинающийся с #EXTM3U. |
Заголовок CORS Access-Control-Allow-Origin: * (или ровно https://p2p.gia.tv) у плейлистов и сегментов, с каждого узла вашей CDN | Без него браузеры отклоняют запросы с другого сайта. Без CORS поток не воспроизводится вообще, с P2P или без. Заголовок, где указан другой сайт, не подходит. | Панель управления → Проверить поток сейчас → «CORS». Или curl -sI -H 'Origin: https://p2p.gia.tv' ВАША_ССЫЛКА и найдите заголовок. |
| https://, если ваши зрители используют https (этот сайт работает по https) | Браузеры блокируют http://-медиа на https://-страницах (смешанное содержимое). | Убедитесь, что ссылка начинается с https://. |
| Постоянные адреса сегментов | Участники обмениваются сегментами по имени. Если каждый зритель получает для одного и того же сегмента ссылку с другим именем (токены на зрителя, подсказки балансировщика вроде lb_backend_hint, абсолютные ссылки на меняющихся серверах), делиться не получится. | Панель управления → Проверить поток сейчас → «Совместное использование». Или откройте медиаплейлист дважды: имена сегментов должны совпадать. Подписанные ссылки, одинаковые для всех зрителей, допустимы. |
| Длительность сегмента 2–10 с | Очень короткие сегменты (< 1 с) увеличивают объём сигнализации; очень длинные (> 10 с) задерживают обмен между участниками. | #EXT-X-TARGETDURATION в медиаплейлисте. |
| Кодеки: видео H.264, звук AAC или MP3 (сегменты TS или fMP4); H.265/HEVC — только там, где его поддерживает браузер | Декодеры браузера. | Через диагностический режим или проверку в панели управления. |
Требования к источнику
Проверка загружает плейлист с этого сервера. CDN или источник, который по-разному обслуживает зрителей в зависимости от страны или сети (геоблокировка, защита от хотлинков, региональные узлы без заголовков CORS), может выглядеть здесь исправным и всё равно не работать у части зрителей. Такие зрители видят под плеером Ошибка потока — источник отказал этому зрителю: HTTP 403 …, а у вас та же причина появляется в разделе Администрирование → Аналитика в реальном времени (если вы администратор сайта). Спросите у зрителя, какая причина показана, или попросите журнал событий из диагностического режима.
CORS
Самая частая проблема — с большим отрывом. Ваш источник должен отправлять Access-Control-Allow-Origin: * (или ровно адрес сайта https://p2p.gia.tv) в каждом ответе: для главного плейлиста, медиаплейлистов и сегментов. Примеры:
nginx
location /live/ {
add_header Access-Control-Allow-Origin * always;
add_header Access-Control-Allow-Headers Range always;
add_header Access-Control-Expose-Headers Content-Length always;
types { application/vnd.apple.mpegurl m3u8; video/mp2t ts; video/mp4 m4s mp4; }
}
Apache (.htaccess в каталоге HLS)
Header always set Access-Control-Allow-Origin "*"
Header always set Access-Control-Allow-Headers "Range"
Wowza Streaming Engine: Application → Properties → Custom → добавьте cupertinoUserHTTPHeaders = Access-Control-Allow-Origin: * (модуль cupertinostreaming) или используйте настройку CORS у HTTP-источника.
CDN (Cloudflare, Akamai, CloudFront, Bunny…): включите CORS в настройках источника или pull-зоны, указав * как разрешённый источник. В Cloudflare заголовок можно добавить через «Transform Rules → Response headers».
Проверка из командной строки (заголовок должен быть в выводе):
curl -sI -H "Origin: https://p2p.gia.tv" https://your-server.example.com/live/stream/playlist.m3u8 | grep -i access-control
Источники, которые хорошо работают
- Wowza, nginx-rtmp / nginx с модулем HLS, Ant Media, Red5, MistServer, SRS, OvenMediaEngine (выход HLS), Unified Streaming, Flussonic.
- OBS / vMix / аппаратные кодеры → RTMP → любой из перечисленных → HLS.
- Любая CDN, забирающая поток у перечисленных, включая сеть Tulix / SSH101.
- FFmpeg, записывающий HLS на веб-сервер:
ffmpeg -re -i input -c:v libx264 -preset veryfast -g 60 -c:a aac -f hls -hls_time 4 -hls_list_size 10 -hls_flags delete_segments /var/www/live/stream.m3u8. - HLS по запросу (плейлист с
#EXT-X-ENDLIST) тоже работает; P2P там даже эффективнее, потому что зрители находятся в разных местах записи и могут больше делиться.
Регистрация
- Перейдите на https://p2p.gia.tv/signup.
- Выберите имя пользователя: 3–20 символов — строчные латинские буквы, цифры и подчёркивание. Оно станет вашим публичным адресом
https://p2p.gia.tv/имя_пользователя, и изменить его потом нельзя. - Укажите адрес эл. почты и пароль (не меньше 8 символов).
- При желании сразу вставьте адрес
.m3u8и название канала или добавьте их позже в панели управления. - Примите Условия использования и Правила допустимого использования. У вас должны быть права на всё, что вы транслируете.
- Нажмите Создать канал. Вы сразу войдёте в систему и попадёте в панель управления.
На некоторых сайтах регистрация закрыта; в этом случае воспользуйтесь страницей контактов.
Панель управления
https://p2p.gia.tv/dashboard показывает:
- состояние потока (в эфире/не в эфире), время последней проверки и ошибку, если проверка не прошла;
- зрителей сейчас и максимум одновременных зрителей;
- разгрузку P2P — долю байтов видео, которую зрители получили от других зрителей, а не от вашего источника, и итоговые объёмы;
- качество — разрешение, битрейт, число вариантов, кодеки и результат проверки CORS, определённые по вашему плейлисту;
- форму настроек потока: адрес, название, описание, ссылка на миниатюру, отметка 18+, отметка «не в списке»;
- Поделиться и встроить — адрес вашей страницы, код для встраивания, адрес для встраивания и ссылку на диагностический режим;
- график зрителей за 24 часа (как только кто-нибудь посмотрел).
Проверить поток сейчас загружает ваш плейлист со стороны сервера и показывает: в эфире или нет, прямой эфир или VOD, целевую длительность, варианты, лучшее разрешение/битрейт, кодеки и наличие заголовка CORS. Потоки также проверяются автоматически раз в несколько минут; на главной странице показываются только каналы в эфире.
Если сайт отправляет письма, после регистрации панель управления попросит вас подтвердить адрес эл. почты (см. Частые вопросы).
Настройки канала
- Название / описание / миниатюра показываются на вашей странице и в сетке каналов на главной. Миниатюра должна быть ссылкой на изображение по https (JPEG/PNG/WebP, рекомендуется 16:9).
- Материалы для взрослых (18+) помечают канал значком. Такие каналы скрыты с главной страницы, если администратор не разрешил иное; страница и встраивание работают всегда. Трансляция материалов для взрослых без этой отметки нарушает Правила допустимого использования.
- Не в списке убирает канал с главной страницы и из sitemap. Страница и встраивание продолжают работать. Удобно для закрытых мероприятий или во время тестов.
Страница канала
https://p2p.gia.tv/имя_пользователя показывает плеер, название, описание, текущее число зрителей, ссылку для распространения, код для встраивания и небольшой блок диагностики.
Под видео есть строка состояния P2P:
| Состояние | Значение |
|---|---|
| P2P работает | Этот зритель получает сегменты от других участников (или он лидер роя и раздаёт другим). |
| P2P: запуск | Подключён к сигнализации, ждёт других участников или первого общего сегмента. Нормально для первого зрителя и в первые 10–20 секунд. |
| P2P не работает | См. текст рядом: WebRTC недоступен, встроенное воспроизведение (Safari на iOS), сигнализация недоступна или все участники не ответили. Видео продолжает идти с источника. |
Страница никогда не блокирует воспроизведение из-за P2P. Если что-то пошло не так, зритель просто смотрит с источника.
Мобильные устройства: Chrome и Firefox на Android поддерживают P2P. Safari на iOS воспроизводит HLS встроенными средствами (без Media Source Extensions), поэтому iPhone и iPad всегда смотрят с источника и в P2P не участвуют. Safari на компьютере участвует.
Встраивание
Скопируйте код для встраивания из панели управления или со страницы канала:
<iframe src="https://p2p.gia.tv/embed/user_name" width="854" height="480" frameborder="0" scrolling="no"
allow="autoplay; encrypted-media; fullscreen; picture-in-picture" allowfullscreen></iframe>
Варианты:
- Адаптивный размер: поместите iframe в контейнер и растяните его на весь контейнер:
<div style="position:relative;aspect-ratio:16/9;max-width:960px">
<iframe src="https://p2p.gia.tv/embed/user_name" style="position:absolute;inset:0;width:100%;height:100%;border:0"
allow="autoplay; encrypted-media; fullscreen; picture-in-picture" allowfullscreen></iframe>
</div>
- Без автозапуска:
https://p2p.gia.tv/embed/user_name?autoplay=0показывает кнопку воспроизведения. - Автозапуск начинается без звука (этого требуют браузеры); нажатие на «Включить звук» включает звук.
- WordPress: вставьте iframe в блок «Произвольный HTML». Wix/Squarespace/Webflow: используйте их элемент «код для встраивания».
- Атрибут
allow="autoplay …"важен: без него многие браузеры не разрешают автозапуск внутри iframe. - Зрители встроенного плеера и зрители страницы канала находятся в одном рое и делятся сегментами друг с другом.
Плеер без оформления сайта доступен по адресам https://p2p.gia.tv/?src=ВАШ_M3U8 (рабочий) и https://p2p.gia.tv/debug.html?src=ВАШ_M3U8 (диагностика). Они используют тот же P2P-движок и тот же рой, что и страница канала, потому что рой определяется по адресу потока.
Проверка
Чтобы увидеть P2P, нужны два плеера: один зритель всегда загружает с источника.
- Откройте страницу канала в одном браузере (например, Chrome). Дождитесь, пока пойдёт видео.
- Откройте ту же страницу во втором браузере (Firefox, Edge, другой профиль Chrome, окно инкогнито или другой компьютер/телефон в любой сети).
- Примерно через 10–20 секунд строка состояния второго плеера должна показать P2P работает. Первый становится лидером и показывает, что раздаёт другим.
- Для подробностей откройте ссылку Диагностический режим (также
https://p2p.gia.tv/debug.html?src=ВАШ_M3U8). Там видно каждый сегмент и его источник (ORIGIN или PEER), подключённых участников, байты в каждом направлении, состояние сигнализации, итоговый вывод о том, почему P2P работает или нет, и встроенную инструкцию по проверке.
Примечания:
- Две вкладки в одном браузере тоже подойдут, но браузеры замедляют фоновые вкладки — держите обе на виду.
- Корпоративные сети и некоторые мобильные операторы блокируют WebRTC (UDP). В большинстве таких случаев помогает TURN-сервер (его настраивает администратор сайта).
- Первый зритель всегда показывает загрузку с источника — так и должно быть. Смотрите на второго зрителя.
- Воспроизведение с источника, пока строка состояния показывает «P2P: запуск», нормально для первых сегментов.
Ограничения
| Параметр | Значение | Примечание |
|---|---|---|
| Каналов на учётную запись | 1 | Для других потоков создайте другие учётные записи. |
| Зрителей на канал (рой) | по умолчанию до 500 | Задаёт администратор. Сверх лимита новые зрители по-прежнему смотрят с источника, но без P2P. |
| Участников на зрителя | до 12 | Управляется автоматически (сайт может изменить это число). |
| Длина адреса потока | 1024 символа | |
| Название / описание | 120 / 600 символов | |
| Нагрузка на источник | от 1 до нескольких полных загрузок на рой | Лидер плюс зрители, у которых слишком медленные соседи. |
| Отдача плеера | ограничена на участника и в целом | Зрители с медленной отдачей автоматически раздают меньше. |
Решение проблем
«Поток не в эфире» в панели управления / видео нет совсем
- Откройте свой
.m3u8в браузере: должен загрузиться текстовый файл с#EXTM3U. Если нет, источник не работает или ссылка неверна. - Нажмите Проверить поток сейчас и прочитайте ошибку.
403/404— ссылка неверна или защищена;timeout— сервер не отвечает из интернета;no segments— плейлист пуст (кодер не запущен). - Адрес должен начинаться с
https://, если зрители заходят на этот сайт по https (смешанное содержимое браузеры блокируют).
У меня воспроизводится, а у зрителя в другой стране — нет
- Спросите зрителя, что написано в строке состояния под плеером. Ошибка потока — HTTP 403 или не удаётся подключиться к потоку означает, что ваш источник или CDN обслуживает этот регион иначе (геоограничение, защита от хотлинков, узел без заголовков CORS); проверка с этого сервера этого не увидит. Этот браузер не может декодировать поток — проблема с кодеками на его устройстве. P2P: запуск или P2P не работает при идущем видео — это нормально: P2P необязателен.
- Администратор сайта видит те же причины по каждому зрителю в разделе «Аналитика в реальном времени».
- Начиная с 2.1.0 библиотека плеера отдаётся самим сайтом (без сторонней CDN), так что заблокированная CDN со скриптами больше не может быть причиной.
В VLC воспроизводится, а в браузере — нет
- Почти всегда дело в CORS. См. CORS. VLC не нужен CORS, а браузерам нужен.
- Или в кодеке: браузеры, как правило, не воспроизводят видео MPEG-2, HEVC без аппаратной поддержки и звук AC-3/E-AC-3. Используйте H.264 + AAC.
«P2P не работает: сигнализация недоступна»
- Сеть зрителя блокирует соединения WebSocket или мешает расширение браузера. Видео продолжает идти с источника.
- Если так у всех, сайт перезапускается или стоящий перед ним прокси не пропускает соединения WebSocket (вопрос к администратору).
«P2P не работает: нет WebRTC» / «встроенное воспроизведение»
- Очень старые браузеры, некоторые «приватные» браузеры с выключенным WebRTC и Safari на iOS. С вашей стороны ничего делать не нужно.
«P2P: запуск» не проходит при двух зрителях
- Оба зрителя за строгими NAT/межсетевыми экранами, а TURN-сервера нет. Попросите администратора настроить TURN.
- Имена сегментов у зрителей разные (сессионные токены в ссылках). Участники объявляют сегменты по имени; если имена различаются, совпадений не будет. Используйте ссылку, одинаковую для всех зрителей.
- Два плеера не в одном рое: они должны использовать точно один и тот же адрес потока (идентификатор роя вычисляется из него). Другой
?token=илиhttpвместоhttpsдают разные рои.
Видео останавливается / подгружается
- Сначала проверьте источник: если поток останавливается уже у первого зрителя, слишком медленный источник или кодер. Снизьте битрейт или исправьте кодер.
- Делайте сегменты короткими (2–4 с), а окно плейлиста — не меньше 6 сегментов; при окне в 3 сегмента догнать отставание невозможно.
- Слишком медленные участники отключаются автоматически; плеер успевает загрузить с источника в срок.
Мой канал не показывается на главной
- Канал должен быть в эфире (проверяется раз в несколько минут; нажмите «Проверить поток сейчас»), не быть «не в списке», не быть 18+ (если администратор не разрешил), не быть заблокированным, а учётная запись — не отключённой. Некоторые сайты показывают канал только после подтверждения его адреса эл. почты.
Встроенный плеер показывает чёрный экран
- Используйте точный код iframe вместе с
allow="autoplay; …". Проверьте консоль браузера на ошибки смешанного содержимого или CORS. Попробуйте?autoplay=0.
Я забыл пароль
- https://p2p.gia.tv/reset, если на сайте настроена эл. почта; иначе обратитесь к администратору.
Я сменил адрес эл. почты, а в настройках всё ещё старый
- Так и задумано: если сайт отправляет письма, новый адрес вступает в силу только после того, как вы откроете отправленную на него ссылку для подтверждения (в течение 24 часов) и нажмёте Подтвердить. До этого в настройках адрес отображается как ожидающий, а у учётной записи остаётся старый. На старый адрес тоже приходит уведомление. Чтобы отменить изменение, сохраните форму с текущим адресом.
Частые вопросы
Моё видео записывается или ретранслируется? Нет. Сайт только знакомит плееры друг с другом. Видео браузеры зрителей берут с вашего источника и передают друг другу. На сервере ничего не хранится.
Можно ли использовать поток другого поставщика (например, мой канал Tulix/SSH101)? Да, если у вас есть право его распространять и источник отправляет заголовки CORS. Пример интеграции — на странице каталога SSH101.
Это бесплатно? Да. Сервис предоставляется «как есть» на условиях, описанных в Условиях использования. Злоупотребления (нарушение авторских прав, незаконные материалы) ведут к блокировке; см. Правила допустимого использования.
Сколько у меня может быть зрителей? Столько, сколько ваш источник смог бы обслужить без P2P при примерно 5–20 % нагрузки. На практике на каждый канал действует лимит роя, заданный администратором (по умолчанию 500).
Видят ли зрители друг друга? Только технически (IP-адреса внутри WebRTC, как в любом P2P-видеосервисе). Ни имён, ни чата, ни истории.
Какие браузеры? Chrome, Edge, Firefox, Opera, Brave (с разрешённым WebRTC), Safari на компьютере, Chrome/Firefox на Android. Safari на iOS воспроизводит без P2P.
Работает ли с DRM / зашифрованным HLS? Плейлисты с шифрованием AES-128 работают (сегменты передаются в зашифрованном виде; каждый зритель получает ключ с вашего сервера ключей). DRM FairPlay/Widevine не поддерживаются.
Можно ли изменить имя пользователя? Нет, это постоянный адрес вашей страницы. Для нового имени создайте новую учётную запись.
Можно ли удалить учётную запись? Да: Настройки → Удаление учётной записи, с текущим паролем. Учётная запись и страница канала удаляются сразу, текущие зрители отключаются, а на ваш адрес эл. почты приходит уведомление. Отменить это нельзя. (Учётные записи администраторов удаляет другой администратор.)
Почему панель управления просит подтвердить адрес эл. почты? Если сайт отправляет письма, новые учётные записи получают ссылку для подтверждения (действует 7 дней). Откройте её и нажмите Подтвердить; кнопка Отправить ссылку ещё раз в панели управления присылает новую (до 3 в час). Некоторые сайты показывают канал на главной только после подтверждения адреса.
Контакты
Вопросы и жалобы на нарушения: страница контактов · эл. почта: info@tulix.com · нарушения/DMCA: https://p2p.gia.tv/report.