Учебное пособие по Xibo: полное руководство по установке, безопасности и началу работы

  • Настройте XMR/XTR, Apache, PHP и MariaDB для надежной Xibo CMS.
  • Улучшите доступ с помощью 2FA, уведомлений и настроек электронной почты.
  • Управляйте контентом с помощью плейлистов и создавайте дизайн с помощью редактора макетов.
  • Сортируйте и фильтруйте данные в CMS, чтобы масштабировать операции без хаоса.
Isaac

10 минут

Учебное пособие по цифровым вывескам Xibo

Если вы только начинаете работать с Xibo или хотите вывести свою цифровую вывеску на новый уровень, здесь вы найдете подробное руководство: от установки CMS в Ubuntu до начала работы с контентом, экранами и безопасностью. Все, что вам нужно для настройки и запуска Xibo В этой статье собрана вся необходимая информация, включая рекомендации для новых пользователей, настройку Apache, PHP, MariaDB, XMR/XTR и рекомендации по повседневной работе с системой.

Помимо пошаговой установки, мы рассмотрим такие параметры безопасности, как двухфакторная аутентификация, приемы сортировки и фильтрации внутри самой CMS, а также то, как загружать и планировать заранее созданные изображения и видео. Если вы предпочитаете создавать дизайны непосредственно в XiboВы также узнаете, как приступить к работе с редактором макетов и шаблонами, чтобы без лишних хлопот создавать интересный контент.

Предварительные замечания и требования

Прежде чем что-либо трогать, желательно уяснить несколько вещей. В некоторых случаях версии MariaDB и PHP, которые официально не поддерживаются Xibo; попробуйте проверить свой стек с помощью матрицы совместимости, рекомендованной проектом, если вы ищете долгосрочную стабильность.

Ещё одна важная деталь — папка медиабиблиотеки. В этом руководстве она используется. /var/www/Library как местоположение библиотеки, поскольку установщик записывает журнал установки в /var/www/library и требует, чтобы каталог был пуст для корректного продолжения работы.

Для динамической графики, Рекомендуется использовать локальный экземпляр QuickChart. Для повышения производительности и контроля, хотя его установка здесь не рассматривается. Это интересный плагин, если вы планируете отображать визуализированные данные «на лету».

Все системные требования можно установить с помощью apt в Ubuntu. Вам понадобится веб-сервер, PHP с расширениями и вспомогательные компоненты. Следующая команда собирает минимальные пакеты которые были успешно использованы в реальных условиях:

sudo apt install mariadb-server mariadb-client apache2 php php-cli php-gd php-json php-dom php-mysql php-zip php-soap php-curl php-xml php-mbstring php-zmq libapache2-mod-xsendfile

Если вы настраиваете новую среду, убедитесь, что в ней установлены брандмауэр, DNS и сертификаты. HTTPS с первого дня Это значительно упрощает последующую настройку безопасности и уведомлений по электронной почте.

Установка Xibo в Ubuntu

Установка Xibo CMS в /srv/xibo-cms

При развертывании серверного ПО из внешних репозиториев рекомендуется размещать его в каталоге /srv. В данном случае мы установим CMS в /srv/xibo-cms для поддержания порядка и отдельно от других услуг:

sudo mkdir /srv/xibo-cms
cd /srv/xibo-cms
sudo wget https://github.com/xibosignage/xibo-cms/releases/download/3.0.2/xibo-cms-3.0.2.tar.gz
sudo tar -xvzf xibo-cms-3.0.2.tar.gz --strip-components=1

После извлечения установите учетную запись веб-сервера в качестве владельца, чтобы избежать проблем с правами доступа. В Ubuntu с Apache это обычно www-data:

sudo chown -R www-data:www-data /srv/xibo-cms

Для упрощения настройки VirtualHost удаляется каталог Apache по умолчанию и создается символическая ссылка, указывающая на путь Xibo. Таким образом /var/www связан с CMS:

sudo rm -r /var/www
sudo ln -s /srv/xibo-cms /var/www

Настройте Apache2 для Xibo

Включите необходимые модули и создайте конфигурацию сайта. Вам потребуется как минимум переписать код, настроить SSL и управление сеансами. Также включите X-Sendfile для эффективного обслуживания библиотеки.:

sudo a2enmod rewrite
sudo a2enmod ssl
sudo a2enmod session
sudo nano /etc/apache2/sites-available/xibo-cms.conf

Пример VirtualHost для HTTP и HTTPS (измените ServerName и пути к сертификатам): использовать XSendFile и разрешить .htaccess где применимо:

<VirtualHost *:80>
    DocumentRoot "/var/www/web"
    ServerName xibo.domain.com
    XSendFile on
    XSendFilePath /var/www/Library
    <Directory "/var/www/web">
        AllowOverride All
        Options Indexes FollowSymLinks MultiViews
        Order allow,deny
        Allow from all
        Require all granted
    </Directory>
</VirtualHost>

<VirtualHost *:443>
    DocumentRoot "/var/www/web"
    ServerName xibo.domain.com
    XSendFile on
    XSendFilePath /var/www/Library
    SSLEngine on
    SSLCertificateFile "/etc/ssl/certs/ssl-cert-snakeoil.pem"
    SSLCertificateKeyFile "/etc/ssl/private/ssl-cert-snakeoil.key"
    <Directory "/var/www/web">
        AllowOverride All
        Options Indexes FollowSymLinks MultiViews
        Order allow,deny
        Allow from all
        Require all granted
    </Directory>
</VirtualHost>

Деактивируйте сайт по умолчанию и активируйте новый VirtualHost. Затем примените изменения. Это сделает CMS пригодной к использованию под настроенным именем:

sudo a2dissite 000-default.conf
sudo a2ensite xibo-cms.conf
sudo systemctl restart apache2

Подготовить MariaDB

Откройте клиент MariaDB и установите безопасный пароль для учетной записи root. Не забудьте заменить MY_NEW_PASSWORD на свой. и храните тайну как следует:

sudo mysql
ALTER USER 'root'@'localhost' IDENTIFIED BY 'MI_NUEVA_CONTRASEÑA';
FLUSH PRIVILEGES;
exit;

Мы создадим базу данных CMS с помощью веб-мастера. На этом экране выберите опцию создать новую базу данных для инициализации Xibo со своей схемой и разрешениями.

Настройте PHP для загрузки больших файлов

Если вы собираетесь работать с видео и большими изображениями, вам потребуется увеличить лимиты выполнения и загрузки в php.ini. Отредактируйте файл Apache SAPI php.ini. (исправьте версию, если это не 7.4):

sudo nano /etc/php/7.4/apache2/php.ini

Измените следующие директивы, чтобы избежать узких мест. 2G обычно достаточно для большинства видео, но вы можете масштабировать сеть, если ваша инфраструктура это поддерживает. Не забудьте перезапустить Apache после внесения изменений.:

max_execution_time = 300
memory_limit = 256M
post_max_size = 2G
upload_max_filesize = 2G
session.cookie_secure = Off
session.cookie_httponly = On
session.cookie_samesite = Lax

Обмен сообщениями в реальном времени XMR и запланированные задачи XTR

XMR — это компонент обмена сообщениями в режиме реального времени, позволяющий CMS мгновенно отправлять команды игрокам. Отредактируйте файл конфигурации, чтобы настроить IP-адреса и порты. Измените публичный IP в pubOn на IP-адрес вашего сервера. (Вы можете проверить это с помощью «ip a» или у своего провайдера):

sudo nano /srv/xibo-cms/vendor/xibosignage/xibo-xmr/bin/config.json

Пример контента (настройте pubOn на свой публичный IP-адрес): Сохраните listenOn локальным и опубликуйте на порту 9505.:

{
  "listenOn": "tcp://127.0.0.1:50001",
  "pubOn": ["tcp://192.168.1.1:9505"],
  "debug": false
}

Предоставьте право собственности на файл сервису www-data, чтобы он мог читать его без проблем. Вы избежите ошибок разрешений при запуске XMR:

sudo chown www-data:www-data /srv/xibo-cms/vendor/xibosignage/xibo-xmr/bin/config.json

Создайте службу systemd для XMR и включите её. Это приведёт к её автоматическому запуску вместе с системой. Проверьте статус после запуска для подтверждения отсутствия ошибок:

sudo nano /etc/systemd/system/xibo-xmr.service
[Unit]
Description=Xibo XMR
After=network.target

[Service]
User=www-data
Group=www-data
ExecStart=/usr/bin/php /srv/xibo-cms/vendor/bin/xmr.phar
Restart=always
KillMode=process
RestartSec=1

[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable xibo-xmr.service
sudo systemctl start xibo-xmr.service
sudo systemctl status xibo-xmr.service

XTR, с другой стороны, — это набор повторяющихся задач, которые CMS выполняет каждую минуту. Добавьте его в crontab пользователя веб-сервера, чтобы он запускался без дополнительных учётных данных. Запланируйте выполнение поминутно с этой строкой:

sudo crontab -u www-data -e
* * * * * /usr/bin/php /var/www/bin/xtr.php

Брандмауэр, порты и загрузка

Откройте необходимые порты в UFW: SSH для удаленного администрирования, HTTPS для CMS и TCP-порт 9505 для публикации XMR. Включите брандмауэр в конце. для применения правил:

sudo ufw allow ssh
sudo ufw allow https
sudo ufw allow 9505/tcp
sudo ufw enable

Перезапустите Apache и перейдите по URL-адресу, настроенному в VirtualHost. Если всё правильно, вы увидите экран предварительной проверки Xibo. Единственное регулярное оповещение – о значительном увеличении Если вы не настроили php.ini согласно инструкции:

sudo systemctl restart apache2

Мастер веб-установки

На первом экране, внизу, нажмите «Далее», чтобы продолжить работу с мастером. Заполните данные подключения к MariaDB и выберите «Создать новую базу данных», чтобы Xibo создал базу данных. и необходимые привилегии автоматически.

Далее установщик запросит у вас имя пользователя и пароль администратора CMS. Запишите эти учетные данные надежно. поскольку вы будете использовать их для первого входа в систему.

Следующий шаг — указать маршрут библиотеки контентаВ этом руководстве это /var/www/Library. Вы также можете подтвердить или изменить лицензию сервера для регистрации игроков. Если вы не хотите отправлять телеметрию, снимите флажок со статистики.

После завершения вы сможете войти в систему, используя только что созданную учетную запись администратора, и получить доступ к главной панели CMS. Если вы не видите никаких рисунков или не замечаете ничего необычного, заставляет браузер перезагрузиться (например, Shift+F5) для очистки кэша.

Первый запуск: доступ к безопасности, профилю и уведомлениям

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

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

Укрепляет доступ с помощью Двухфакторная аутентификация (2FA)Вы можете получить код по электронной почте или ввести код, сгенерированный приложением Google Authenticator. При активации приложение генерирует коды восстановления. Скопируйте их и сохраните в менеджере паролей.

Если вы когда-нибудь потеряете доступ к электронной почте или приложению с кодами, администратор может Сброс кодов восстановления из пользовательской сеткиПосле сброса настроек снова включите 2FA в своем профиле, выполнив следующие шаги.

система Уведомления отображают сообщения пользователя и системные события.Чтобы открыть его, нажмите на значок колокольчика рядом с вашим профилем. Если вы хотите создать новое уведомление, перейдите в Центр уведомлений и нажмите «Добавить уведомление». Имейте в виду, что доступные параметры зависят от функций, включённых администратором для вашей роли.

Если вы не видите панель уведомлений, попросите активировать соответствующие функции в разделе «Функции» и настроить панель уведомлений. почтовый адрес В разделе «Настройки» > «Сеть». Параметр «Прервать» в уведомлении автоматически перенаправляет пользователя на его просмотр. Чтобы уведомления по электронной почте работали, включите опцию «Включить оповещения по электронной почте» в разделе «Настройки» > «Обслуживание».

Загружайте и отображайте контент на экранах

Если у вас уже есть Изображения и видео, созданные вне CMSЗагрузите их в библиотеку и запланируйте их показ на своих экранах в разделе «Планирование». Это быстро и позволит начать трансляцию за считанные минуты.

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

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

Помните, что Дисплеи должны быть подключены и авторизованы. в CMS, чтобы начать отображать контент. Если вы ещё не создали ни одного, перейдите в раздел «Экраны», авторизуйте те, которые отображаются как ожидающие, и назначьте свои первые дизайны.

Сортировка и фильтры в CMS

Почти в каждой сетке CMS (Дизайны, Медиа, Экраны, Пользователи и т.д.) у вас есть инструменты для Сортировка и фильтрация для поиска нужного вам материалаСортируйте по столбцам, применяйте фильтры по имени, метке, дате или статусу, а также сохраняйте представления при необходимости.

Правильное использование этих параметров поможет вам управлять большими каталогами и дисплеями с десятками экранов. Хорошая таксономия с метками а последовательные фильтры сокращают количество ошибок и ускоряют командную работу.

Обновления CMS

Когда придет время обновления, проще всего остановить Apache и XMR, создать резервную копию и развернуть новую версию. Начните с остановки служб и управления версией текущего каталога. для быстрого возврата:

sudo systemctl stop apache2 xibo-xmr
sudo mv /srv/xibo-cms /srv/xibo-cms.backup

Делать дамп базы данных (замените «username» на свое имя пользователя без полномочий root) и сохраните его в своем домашнем каталоге или безопасном хранилище:

sudo mysqldump -u root -p xibo > /home/usuario/xibo-cms.sql

Разверните новую версию CMS в чистом каталоге, скопируйте settings.php, полную библиотеку и config.json из XMR. Удалить веб-установщик чтобы избежать предупреждений и установить соответствующие разрешения:

sudo mkdir /srv/xibo-cms
cd /srv/xibo-cms
sudo wget https://github.com/xibosignage/xibo-cms/releases/download/3.0.8/xibo-cms-3.0.8.tar.gz
sudo tar -xvzf xibo-cms-3.0.8.tar.gz --strip-components=1
sudo cp /srv/xibo-cms.backup/web/settings.php web/
sudo cp -r /srv/xibo-cms.backup/Library .
sudo cp /srv/xibo-cms.backup/vendor/xibosignage/xibo-xmr/bin/config.json vendor/xibosignage/xibo-xmr/bin/
sudo chown -R www-data:www-data /srv/xibo-cms
sudo rm web/install/index.php

Если вы выполняете обновление между основными ветками (например, с 2.x на 3.x), запустите миграцию базы данных из каталога CMS. Этот шаг применяет изменения схемы необходимо:

vendor/bin/phinx migrate -c phinx.php

Перезапустите службы и войдите в CMS. Если дизайны загружаются некорректно, принудительно обновите страницу браузера (Shift+F5). Вы можете проверить установленную версию по ссылке «О нас» в левом нижнем углу:

sudo systemctl start apache2 xibo-xmr

Проигрыватель и дисплеи Windows

Чтобы протестировать свою дисплейную сеть на ПК с ОС Windows, загрузите и установите Xibo Player для Windows (бесплатно). Примите условия лицензии, оставьте флажок «Запустить по завершении» и завершите работу мастера.

Открыв плеер, введите URL-адрес CMS и подключитесь. Через несколько секунд должно появиться сообщение об успешном подключении. Затем войдите в CMS и авторизуйте нового игрока. из раздела Экраны.

С помощью авторизованного проигрывателя вы теперь можете назначать макеты или плейлисты этому дисплею. Это отправная точка вашей сети.Добавьте больше игроков в свои локации и организуйте вывески из CMS.

Обучение, документация и сообщество

Если вы ищете учебные материалы, в сообществе есть видеоролики, дополняющие официальную документацию и полезные ресурсы. Форумы Xibo с открытым исходным кодом Они являются отличным источником практических решений и хороших идей.

В некоторых средах вы найдете планы поддержки и частные сообщества посвящённые открытым технологиям (например, такие инициативы, как «Systems Ingenious» с доступными подписками и ежедневными подкастами). Эти ресурсы помогут вам быстро развеять сомнения и оставаться в курсе последних событий.

Благодаря тщательной установке, усиленной безопасности с 2FA, оперативному обмену сообщениями XMR, запланированному XTR и лучшим практикам загрузки и планирования контента, У вас будет стабильная и гибкая платформа для цифровых вывесок.Воспользуйтесь функциями сортировки и фильтрации CMS, стратегически авторизуйте свои экраны и комбинируйте плейлисты и макеты для быстрой итерации, не жертвуя качеством отображаемого контента.