Установка и развертывание Archivarius¶

Быстрый старт: контейнер «всё в одно컶

Образ flussonic/archivarius:aio содержит сразу и Archivarius, и Flussonic Media Server: конфигурация связки уже зашита внутрь, отдельно устанавливать и настраивать Flussonic не нужно.

Требования¶

• Docker (проверить: docker --version);
• рабочая лицензия Flussonic (ключ вида l4|...);
• свободные порты 3000 и 8080.

Запуск¶

Создайте рабочий каталог и положите в него файл license.txt с ключом лицензии одной строкой. Замените l4|ваш_ключ_лицензии на настоящий ключ:

mkdir -p ~/archivarius && cd ~/archivarius
echo 'l4|ваш_ключ_лицензии' > license.txt

Запустите контейнер:

docker run -d --name archivarius \
  --restart unless-stopped \
  -p 3000:3000 \
  -p 8080:8080 \
  -v "$(pwd)/license.txt:/etc/flussonic/license.txt:ro" \
  flussonic/archivarius:aio

Параметры:

• -p 3000:3000 — веб-интерфейс Archivarius;
• -p 8080:8080 — порт Flussonic; он нужен браузеру: плеер и скачивание файлов обращаются к Flussonic напрямую;
• -v ".../license.txt" — файл лицензии;
• --restart unless-stopped — контейнер автоматически поднимется после сбоя или перезагрузки хоста.

Откройте в браузере¶

Дождитесь готовности контейнера — в колонке STATUS должно появиться (healthy):

docker ps --filter name=archivarius

Откройте http://localhost:3000 и дальше следуйте руководству пользователя.

Разделы ниже описывают альтернативный способ: запуск Flussonic и Archivarius раздельными контейнерами через Docker Compose — для случаев, когда Flussonic нужен как самостоятельный сервис.

Системные требования¶

Для запуска стенда необходимы:

• Docker;
• Docker Compose;
• сетевой доступ к Docker Hub для загрузки образов flussonic/flussonic и flussonic/archivarius;
• рабочая лицензия Flussonic.

Проверьте, что команды доступны:

docker --version
docker compose version

Подготовка структуры каталогов¶

Рекомендуемая структура:

run/
├── flussonic/
│   ├── source/
│   └── transcoded/
└── archivarius/

Создать каталоги можно так:

mkdir -p run/flussonic/source run/flussonic/transcoded run/archivarius

Конфигурация Flussonic¶

Файл run/flussonic/flussonic.conf:

http 8080;
edit_auth flussonic letmein!;

file_processor {
  path /var/lib/flussonic/transcoded;
}

vod vod_src {
  storage /var/lib/flussonic/source;
  download true;
}

vod vod_tc {
  storage /var/lib/flussonic/transcoded;
  download true;
}

Лицензия Flussonic¶

Создайте файл run/flussonic/license.txt и поместите в него ключ лицензии одной строкой.

Пример:

l4|...ваш_ключ_лицензии...

Конфигурация Archivarius¶

Файл run/archivarius/config.docker.json:

{
  "server": {
    "port": 3000
  },
  "flussonic": {
    "apiBaseUrl": "http://flussonic:8080/streamer/api/v3",
    "playbackBaseUrl": "http://localhost:8080",
    "apiUser": "flussonic",
    "apiPassword": "letmein!",
    "storageIndex": 0,
    "sourceVodPrefix": "vod_src",
    "transcodedVodPrefix": "vod_tc"
  }
}

Docker Compose¶

Файл run/docker-compose.yml:

services:
  flussonic:
    image: flussonic/flussonic:latest
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - ./flussonic/flussonic.conf:/etc/flussonic/flussonic.conf:ro
      - ./flussonic/license.txt:/etc/flussonic/license.txt:ro
      - ./flussonic/source:/var/lib/flussonic/source
      - ./flussonic/transcoded:/var/lib/flussonic/transcoded

  archivarius:
    image: flussonic/archivarius:latest
    restart: unless-stopped
    depends_on:
      - flussonic
    ports:
      - "3000:3000"
    volumes:
      - ./archivarius/config.docker.json:/app/config.json:ro

Итоговая структура:

run/
├── docker-compose.yml
├── flussonic/
│   ├── flussonic.conf
│   ├── license.txt
│   ├── source/
│   └── transcoded/
└── archivarius/
    └── config.docker.json

Запуск и остановка¶

Запуск:

docker compose -f run/docker-compose.yml up -d

Остановка:

docker compose -f run/docker-compose.yml down

Проверка доступности¶

После запуска:

• интерфейс Archivarius: http://localhost:3000;
• Flussonic API/веб: http://localhost:8080.

Для тестового запуска обычно используют исходные файлы в формате MP4, размещенные в каталоге run/flussonic/source.

Типовые проблемы установки и запуска¶

Проблема: контейнеры не поднимаются¶

Что проверить:

• корректность run/docker-compose.yml;
• существование и права доступа к примонтированным файлам (flussonic.conf, license.txt, config.docker.json);
• что порты 3000 и 8080 не заняты другими сервисами.

Проблема: Archivarius доступен, но каталог пустой¶

Что проверить:

• что исходные MP4-файлы находятся в run/flussonic/source;
• что в config.docker.json указан корректный sourceVodPrefix (vod_src);
• что в flussonic.conf настроен VOD-блок с тем же префиксом.

Проблема: ошибки API при работе интерфейса¶

Что проверить:

• параметр apiBaseUrl в config.docker.json;
• корректность apiUser и apiPassword;
• доступность Flussonic по сети из контейнера Archivarius.

Проблема: файл загружен, но не открывается в плеере¶

Что проверить:

• что Flussonic может прочитать media-метаданные файла;
• что файл соответствует рекомендуемому формату MP4 (H.264/HEVC + AAC);
• сообщения об ошибках в логах Flussonic (bad_media_info, error opening file и т.п.).