379
edits
Changes
→Синтаксис команды acestreamengine --stream-source
Репозиторий следует выбирать в зависимости от операционной системы.
''Debian 6+:''
<tt><nowiki>deb http://repo.acestream.org/debian/ squeeze main</nowiki></tt>
либо
Примечание: пакеты в репозитории sid собраны с зависимостями, которые соответствуют официальным sid-репозиториям Debian.
Если вы не знаете, какой репозиторий выбрать, используйте squeeze.
''Debian 7:''
<tt><nowiki>deb http://repo.acestream.org/debian/ wheezy main</nowiki></tt>
''Ubuntu 11.10:''
''Ubuntu 12.10:''
<tt><nowiki>deb http://repo.acestream.org/ubuntu/ quantal main</nowiki></tt>
''Ubuntu 13.04:''
<tt><nowiki>deb http://repo.acestream.org/ubuntu/ raring main</nowiki></tt>
'''Шаг 2'''
Для Debian доступен только движок (acestream-engine).
<!--
=== Установка пакет ACE Stream на Ubuntu из deb-пакета ===
Можно установить ACE Stream на Ubuntu без использования репозитория. Для этого необходимо скачать установочный пакет по одной из ссылок ниже и установить пакет через менеджер пакетов (например, двойным кликом на скачанный файл пакета).
Данный установочный пакет является аналогом пакета <tt>acestream-full</tt> из репозитория и включает в себя движок, плеер и плагин для браузеров.
-->
=== Установка ACE Ace Stream на CentOS ===
Для установки на CentOS необходимо:
* наличие установленного python 2.6
На данный момент доступны такие пакеты:
*'''CentOS 5 64bit''': http://dl.acestream.org/centos/5/acestream-engine-2.01.8_76_4-centos5-x86_64.tar.gz*'''CentOS 6 64bit''': http://dl.acestream.org/centos/6/acestream-engine-2.01.8_76_4-centos6-x86_64.tar.gz Данный пакет тестировался на версиях 5.8 и 6.3 соответственно. === Android ===Пакет для установки Ace Stream for Android:http://dl.acestream.org/android/acestream-2.1.5.apk
==Запуск трансляции==
===Основные термины===
*'''Источник''' - программа, которая принимает на вход HTTP-поток трансляции и обеспечивает просмотр трансляции с помощью ПО ACE Ace Stream
*'''Узел поддержки''' - программа, позволяющая масштабировать трансляцию за счет использования дополнительного серверного оборудования и интернет-каналов
*'''Клиент''' - ПО ACE Ace Stream, которое используется для просмотра трансляции
*'''Timeshift''' - временной интервал, в рамках которого в клиенты могут осуществлять перемотку трансляции
===Переход с версий 2.0.х на версию 2.1 и выше===
С 10 сентября 2013 года доступна обновленная версия движка 2.1.6 под Ubuntu, Debian и CentOS.
Перед полномасштабным использованием новой версии мы рекомендуем по возможности протестировать ее на одной или нескольких трансляциях.
При возникновении каких-либо проблем просьба писать на форум http://forum.torrentstream.org либо на почту support@acestream.net.
Старые версии временно доступны по прямым ссылкам:
'''Ubuntu''':
* http://dl.acestream.org/ubuntu/acestream-engine_2.0.8-1oneiric6_amd64.deb
* http://dl.acestream.org/ubuntu/acestream-engine_2.0.8-1oneiric6_i386.deb
* http://dl.acestream.org/ubuntu/acestream-engine_2.0.8-1precise6_amd64.deb
* http://dl.acestream.org/ubuntu/acestream-engine_2.0.8-1precise6_i386.deb
* http://dl.acestream.org/ubuntu/acestream-engine_2.0.8-1quantal6_amd64.deb
* http://dl.acestream.org/ubuntu/acestream-engine_2.0.8-1quantal6_i386.deb
* http://dl.acestream.org/ubuntu/acestream-engine_2.0.8-1raring6_amd64.deb
* http://dl.acestream.org/ubuntu/acestream-engine_2.0.8-1raring6_i386.deb
'''Debian''':
* http://dl.acestream.org/debian/acestream-engine_2.0.8-1sid5_amd64.deb
* http://dl.acestream.org/debian/acestream-engine_2.0.8-1sid5_i386.deb
* http://dl.acestream.org/debian/acestream-engine_2.0.8-1squeeze5_amd64.deb
* http://dl.acestream.org/debian/acestream-engine_2.0.8-1squeeze5_i386.deb
'''CentOS 6''':
* http://dl.acestream.org/centos/6/acestream-engine-2.0.8_7-centos6-x86_64.tar.gz
<span style="color: #900;">ВНИМАНИЕ!</span> В ближайшее время поддержка старых версий будет прекращена.
<span style="color: #009;">ВАЖНО!</span> Все трансляции, созданные с помощью новой версии Ace Stream (2.1 и выше) не поддерживаются клиентским ПО старых версий (2.0.х и ниже). При попытке просмотреть новую трансляцию с помощью старого движка будет выдаваться ошибка "Cannot load transport file"
====Изменения в параметрах запуска====
В новой версии изменились некоторые параметры запуска источников и узлов поддержки из командной строки, поэтому запуск со старой командной строкой работать не будет.
Основные изменения:
* используется один исполняемый файл <tt>acestreamengine</tt>; различные режимы запуска (источник, узел поддержки) задаются опциями:
** вместо <tt>acestreamengine-stream</tt> следует запускать <tt>acestreamengine --stream-source</tt>
** вместо <tt>acestreamengine-node</tt> следует запускать <tt>acestreamengine --stream-node</tt>
** вместо <tt>acestreamengine-client-console</tt> следует запускать <tt>acestreamengine --client-console</tt>
** вместо <tt>acestreamengine-client-gtk</tt> следует запускать <tt>acestreamengine --client-gtk</tt>
* изменена система логирования. В старых версия движок всю отладочную информацию выводил в STDERR и для записи логов в файл требовалось перенаправлять вывод. В новой версии можно в опциях задать, куда писать логи - в STDOUT, в STDERR, в файл либо в syslog. Для файлов поддерживается ротация логов по размеру. Описание всех опций смотрите в разделе [[#Команда acestreamengine|Команда acestreamengine]]
===Команда acestreamengine===
Начиная с версии 2.1 Ace Stream Engine для Linux представляет собой один исполняемый файл <tt>acestreamengine</tt>, который работает в различных режимах в зависимости от заданных параметров.
Режим работы задается одним из следующих параметров:
* <tt>--client-console</tt> - запустить движок в режиме клиента из консоли (без графического интерфейса)
* <tt>--client-wx</tt> - запустить движок в режиме клиента с графическим интерфейсом WX
* <tt>--client-gtk</tt> - запустить движок в режиме клиента с графическим интерфейсом GTK
* <tt>--stream-source</tt> - запустить источник трансляции
* <tt>--stream-node</tt> - запустить узел поддержки
* <tt>--create-transport</tt> - создать транспортный файл из существующего контента (VOD)
* <tt>--create-transport-multi</tt> - создать мультипотоковый транспортный файл
* <tt>--version</tt> - показать версию движка
Каждый режим работы имеет свои обязательные и необязательные параметры, описанные в соответствующих разделах.
Также всех режимов работы есть общие параметры, которые управляют выводом отладочной информации.
* <tt>--log-stdout</tt> - выводить информацию в STDOUT
* <tt>--log-stderr</tt> - выводить информацию в STDERR
* <tt>--log-file PATH</tt> - выводить информацию в указанный файл
* <tt>--log-max-size SIZE</tt> - максимальный размер файла (в байтах)
* <tt>--log-backup-count COUNT</tt> - сколько резервных логов хранить (резервный лог файл создается при достижении лимита, указанного паметром --log-max-size)
* <tt>--log-file-buffer SIZE</tt> - включить буферизацию вывода в файл (с использованием буфера указанного размера в байтах)
* <tt>--log-syslog HOST</tt> - выводить информацию в syslog-сервер по указанному адресу
* <tt>--log-syslog-port PORT</tt> - порт syslog-сервера
* <tt>--log-syslog-facility FACILITY</tt> - используемый facility
* <tt>--log-syslog-buffer SIZE</tt> - включить буферизацию вывода в syslog (с использованием буфера указанного размера в байтах)
===Общая схема работы===
Источник принимает на вход HTTP-поток (в данный момент поддерживаются HTTP-потоки с инкапсуляцией MPEG-TS) с оригиналом трансляции и после запуска создает файл с расширением acelive. Данный файл является уникальным идентификатором трансляции и используется клиентами для подключения и просмотра.
===Синтаксис команды acestreamengine--stream-source===Команда <tt>acestreamengine--stream-source</tt> запускает источник трансляции.
''обязательные параметры''
*<tt>--name NAME(*)</tt> - название трансляции (это название используется при создании файла acelive и других служебных файлов)
*<tt>--source SOURCE</tt> - источник (ссылка на http-поток)
*<tt>--bitrate BITRATE(*)</tt> - средний битрейт потока в байтах в секунду
''необязательные параметры''
*<tt>--title TITLE(*)</tt> - "читабельное" название транляции трансляции (это название выводится у клиентов). Если не задано, берется из --name
*<tt>--destdir DESTDIR</tt> - устаревший параметр, лучше использовать --cache-dir и --publish-dir
*<tt>--cache-dir CACHE_DIR</tt> - папка для создания служебных файлов (кеш трансляции и другие)
*<tt>--publish-dir PUBLISH_DIR</tt> - папка, в которой будет создан acelive-файл
*<tt>--piecesize PIECESIZE(*)</tt> - размер куска в байтах (если не задан, выставляется автоматически в зависимости от битрейта)*<tt>--duration DURATION(*)</tt> - размер кеша трансляции в формат ЧЧ:ММ:СС (по умолчанию один час: 01:00:00)*<tt>--host HOST(*)</tt> - вручную задать адрес локального трекера*<tt>--port PORT(*)</tt> - порт, на котором работает движок. По умолчанию 7764.*<tt>--skip-internal-tracker(*)</tt> - отключить локальный трекер*<tt>--add-authorized-peers(*)</tt> - добавить список авторизованных пиров в acelive файл*<tt>--private-source(*)</tt> - сделать источник приватным*<tt>--support-node SUPPORT_NODE(*)</tt> - добавить узел поддержки (в формате ip:port). Этот параметр может встречаться несколько раз, если нужно добавить несколько узлов поддержки.*<tt>--tracker TRACKER(*)</tt> - добавить трекер (announce url). Этот параметр может встречаться несколько раз.*<tt>--trackers TRACKERSmaxclients MAXCLIENTS</tt> - максимальное количество пиров, на которые одновременно отдаются данные с источника. По умолчанию 7.*<tt>--log-debug DEBUG</tt> - старый формат добавления трекеров установить уровень отладки (по умолчанию 0 - минимальный)*<tt>--source-read-timeout SECONDS</tt> - таймаут на чтение данных из оригинального источника (список announce url в секундах). По умолчанию 30.*<tt>--source-reconnect-interval SECONDS</tt> - интервал в секундах, через запятую)который движок попробует повторно подсоединиться к оригинальному источнику при обрыве связи. По умолчанию 5.*<tt>--pid-file-dir PATH</tt> - папка, в которой будет создан pid-файл движка. По умолчанию /tmp.*<tt>--provider-key PROVIDER_KEY(*)</tt> - ключ провайдера (только используется для партнерской программы)*<tt>--sid (*)</tt> - идентификатор трансляции для статистики (используется для партнерской программы)*<tt>--permanent (*)</tt> - отметить трансляцию, которая идет 24/7 (круглосуточная трансляция)*<tt>--date-start YYYY-MM-DD HH:mm:ss (*)</tt> - указать дату и время начала трансляции (для коммерческих трансляцийс ограниченным временем вещания)*<tt>--maxclients MAXCLIENTSdate-end YYYY-MM-DD HH:mm:ss (*)</tt> - максимальное количество пиров, на которые одновременно отдаются данные указать дату и время окончания трансляции (для трансляций с источникаограниченным временем вещания)*<tt>--premium (*)</tt> - запросить статус "премиум" для трансляции*<tt>--showupload-pieceslimit</tt> - выводить ограничить скорость отдачи (в лог номера кусков байтах/с, по мере их созданияумолчанию 0 - не ограничивать)*<tt>--showmax-connections</tt> - максимальное общее кол-во соединений (по умолчанию 1000)*<tt>--max-peers</tt> - периодически выводить максимальное кол-во подключений к пирам (по умолчанию 50)*<tt>--service-remote-access</tt> - разрешить удаленный просмотр статистики*<tt>--service-access-token</tt> - ключ доступа для удаленной статистики*<tt>--stats-report-interval</tt> - интервал в лог список подключенных пировсекундах между обновлениями внутренней статистики (по умолчанию 60)*<tt>--debug DEBUGstats-report-peers</tt> - установить уровень отладкиобновлять данные по пирам во внутренней статистике
''дополнительно''
*<tt>-h, --help</tt> - показать описание команд
''примечание'' Изменение параметров, отмеченных звездочками, приводит к изменению Content ID трансляции ===Синтаксис команды acestreamengine--stream-node===Команда <tt>acestreamengine--stream-node</tt> запускает узел поддержки
''обязательные параметры''
*<tt>--allow-support-download</tt> - разрешить получение данных от других узлов поддержки
*<tt>--allow-peers-download</tt> - разрешить получение данных от обычных пиров
*<tt>--max-incoming-connects MAX_INCOMING_CONNECTSconnections MAX_CONNECTIONS</tt> - максимальное общее кол-во входящих соединений (от других пиров) (по умолчанию 1000)*<tt>--max-outgoing-connects MAX_OUTGOING_CONNECTSpeers MAX_PEERS</tt> - максимальное кол-во исходящих соединений (подключений к другим пирам) (по умолчанию 50)
*<tt>--max-upload-slots MAX_UPLOAD_SLOTS</tt> - максимальное количество пиров, на которые одновременно отдаются данные с узла поддержки (по умолчанию 7)
*<tt>--max-download-speed MAX_DOWNLOAD_SPEED</tt> - максимальная скорость загрузки (байт/с). По умолчанию 0 (без ограничений).
*<tt>--max-upload-speed MAX_UPLOAD_SPEED</tt> - максимальная скорость отдачи (байт/с). По умолчанию 0 (без ограничений).
*<tt>--showstats-report-piecesinterval STATS_REPORT_INTERVAL</tt> - выводить интервал в лог номера кусков секундах между обновлениями внутренней статистики (по мере их загрузкиумолчанию 60)*<tt>--showstats-report-peers</tt> - периодически выводить в лог список подключенных пировобновлять данные по пирам во внутренней статистике*<tt>--service-remote-access</tt> - разрешить удаленный просмотр статистики*<tt>--statsservice-reportaccess-interval STATS_REPORT_INTERVALtoken</tt> - задать интервал в секундах ключ доступа для вывода в лог информации о скорости загрузки/отдачи. По умолчанию 0 (не выводить).удаленной статистики*<tt>--log-debug DEBUG</tt> - установить уровень отладки
''дополнительно''
На сервере 192.168.1.1 запускаем источник:
<tt>acestreamengine--stream -source \
--name "test" \
--title "Тестовая трансляция" \
--cache-dir "/tmp/streams" \
--add-authorized-peers \
Опция <tt>--add-authorized-peers</tt> добавляет в acelive-файл список авторизованных узлов (в данном случае это источник: 192.168.1.1).
В данном примере предполагаем, что XBT Tracker установлен и запущен на сервере 192.168.1.1.
Запуск трансляции теперь будет выглядеть таким образом:
<tt>acestreamengine--stream -source \
--name "test" \
--title "Тестовая трансляция" \
--skip-internal-tracker \
--tracker "udp://192.168.1.1:2710/announce" \
Опция <tt>--skip-internal-tracker</tt> отключает встроенный трекер, опция <tt>--tracker</tt> подключает внешний трекер.
Для максимально эффективной работы схемы с узлами поддержки источнику необходимо сообщить адреса этих узлов с помощью опции <tt>--support-node</tt>:
<tt>acestreamengine--stream -source \
--name "test" \
--title "Тестовая трансляция" \
--support-node "192.168.1.2:8621" \
--support-node "192.168.1.3:8621" \
Запускаем узлы поддержки на серверах 192.168.1.2 и 192.168.1.3 (команды для запуска одинаковые):
<tt>acestreamengine--stream-node \
--url "<nowiki>http://192.168.1.1/streams/test.acelive</nowiki>" \
--state-dir "/tmp" \
--source-node "192.168.1.1:7764" \
--allow-source-download \
Опция <tt>--source-node</tt> задает адрес источника.
На сервере 192.168.1.2 это будет выглядеть так:
<tt>acestreamengine--stream-node \
--url "<nowiki>http://192.168.1.1/streams/test.acelive</nowiki>" \
--state-dir "/tmp" \
--support-node "192.168.1.3:8621" \
--allow-support-download \
На сервере 192.168.1.3:
<tt>acestreamengine--stream-node \
--url "<nowiki>http://192.168.1.1/streams/test.acelive</nowiki>" \
--state-dir "/tmp" \
--support-node "192.168.1.2:8621" \
--allow-support-download \
====Приватный источник с двумя узлами поддержки====
Для того, чтобы сделать источник приватным, следует указать опцию <tt>--private-source</tt>:
<tt>acestreamengine--stream -source \
--name "test" \
--title "Тестовая трансляция" \
--support-node "192.168.1.3:8621" \
--private-source \
Следует обратить внимание на то, что в данной конфигурации адрес трекера изменен на <tt>udp://192.168.1.2:2710/announce</tt>. Это сделано для поддержки старых версий клиентов, которые не обрабатывают список авторизованных пиров (подробнее здесь [[#Авторизованные узлы|Авторизованные узлы]]).
Узлы поддержки на серверах 192.168.1.2 и 192.168.1.3 запускаем как обычно:
<tt>acestreamengine--stream-node \
--url "<nowiki>http://192.168.1.1/streams/test.acelive</nowiki>" \
--state-dir "/tmp" \
--source-node "192.168.1.1:7764" \
--allow-source-download \
