Tutorial Xibo: guia completa d'instal·lació, seguretat i primers passos

  • Configura XMR/XTR, Apache, PHP i MariaDB per a un CMS Xibo robust.
  • Reforça l'accés amb 2FA, notificacions i paràmetres de correu.
  • Gestiona continguts amb Playlists i dissenya amb l'Editor de Layouts.
  • Ordena i filtra al CMS per escalar operacions sense caos.
Isaac

10 minuts

Tutorial Xibo cartelleria digital

Si estàs començant amb Xibo o vols portar la teva cartelleria digital un pas més enllà, aquí trobaràs un recorregut completíssim des de la instal·lació del CMS a Ubuntu fins als primers passos amb continguts, pantalles i seguretat. Tot el que necessites per posar Xibo en marxa amb bon criteri està condensat en aquest article, incloent-hi recomanacions per a usuaris nous, configuració d'Apache, PHP, MariaDB, XMR/XTR i pautes per operar el dia a dia del sistema.

A més de la instal·lació pas a pas, recollirem opcions de seguretat com l'autenticació en dos factors, trucs d'ordenació i filtratge al propi CMS i la manera de pujar i programar imatges i vídeos ja creats. Si prefereixes crear dissenys directament a Xibo, també veuràs com iniciar-te amb l'Editor de Dissenys i les plantilles per produir contingut atractiu sense complicar-te.

Notes prèvies i requisits

Abans de tocar res convé conèixer alguns aclariments. En certs escenaris s'han utilitzat versions de MariaDB i PHP que no són oficialment suportades per Xibo; procura validar el teu stack amb la matriu de compatibilitat recomanada pel projecte si busques estabilitat a llarg termini.

Un altre detall important és la carpeta de biblioteca de mitjans. En aquesta guia es fa servir /var/www/Library com a ubicació de la llibreria, atès que l'instal·lador escriu el log d'instal·lació a /var/www/library i exigeix ​​que el directori estigui buit per continuar correctament.

Per a gràfics dinàmics, una instància local de QuickChart és recomanable per rendiment i control, encara que no es cobreix aquí la instal·lació. És un complement interessant si pretens mostrar dades renderitzades al vol.

Tots els requisits del sistema es poden instal·lar amb apt a Ubuntu. Necessitareu servidor web, PHP amb extensions i components de suport. La següent comanda reuneix els paquets mínims que s'han utilitzat amb èxit en entorns reals:

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

Si munteu un entorn nou, assegureu-vos que el tallafocs, DNS i certificats estiguin previstos. Comptar amb HTTPS des del primer dia simplifica molt la posterior configuració de seguretat i notificacions per correu.

Instal·lació de Xibo a Ubuntu

Instal·lació del CMS Xibo a /srv/xibo-cms

Quan es desplega programari de servidor fora de repositoris, és una bona pràctica ubicar-lo sota /srv. En aquest cas instal·larem el CMS a /srv/xibo-cms per mantenir-lo ordenat i separat d'altres serveis:

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

Un cop extret, estableix com a propietari al compte del servidor web per evitar problemes de permisos. A Ubuntu amb Apache sol ser www-data:

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

Per simplificar la configuració del VirtualHost, s'elimina el directori per defecte d'Apache i es crea un enllaç simbòlic apuntant a la ruta de Xibo. Així /var/www queda vinculat al CMS:

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

Configura Apache2 per a Xibo

Habilita els mòduls necessaris i crea la configuració del lloc. Necessitareu rewrite, SSL, i session almenys. Activa també X-Sendfile per servir la llibreria de forma eficient:

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

Exemple de VirtualHost per a HTTP i HTTPS (ajusta el ServerName i les rutes a certificats): utilitza XSendFile i permet .htaccess on correspon:

<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>

Desactiva el lloc per defecte i activa el VirtualHost nou. Després, aplica els canvis. Amb això el CMS quedarà servible sota el nom configurat:

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

Preparar MariaDB

Accedeix al client del MariaDB i estableix una contrasenya segura per al compte root. Recorda substituir MI_NUEVA_CONTRASEÑA per la teva i guarda el secret adequadament:

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

La creació de la base de dades del CMS la farem des de l'assistent web. En aquesta pantalla marca l'opció de crear una base de dades nova perquè Xibo la inicialitzi amb el seu esquema i permisos.

Ajustar PHP per a càrregues de fitxers grans

Si treballaràs amb vídeo i imatges pesades, hauràs d'ampliar límits d'execució i pujada a php.ini. Edita el php.ini del SAPI d'Apache (ajusta la versió si no és 7.4):

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

Modifica les directives següents per evitar colls d'ampolla. Amb 2G sol ser suficient per a la majoria de vídeos, però pots créixer si la teva infraestructura ho suporta. No oblidis reiniciar Apache després del canvi:

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

Missatgeria en temps real XMR i tasques programades XTR

XMR és el component de missatgeria en temps real que permet al CMS enviar ordres als Players de forma immediata. Edita el fitxer de configuració per adaptar IP/ports. Canvia la IP pública a pubOn a la del teu servidor (podeu consultar-la amb «ip a» o el vostre proveïdor):

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

Contingut d'exemple (ajusta pubOn a la teva IP pública): mantén listenOn local i publica al port 9505:

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

Atorgueu la propietat del fitxer a www-data perquè el servei el pugui llegir sense problemes. Evitaràs errors de permisos en arrencar XMR:

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

Crea el servei systemd per a XMR i habilita'l. Així s'iniciarà automàticament amb el sistema. Comprova l'estat després d'arrencar per confirmar que no hi ha errors:

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, per part seva, és el conjunt de tasques recurrents que el CMS executa cada minut. Afegeix-lo al crontab de l'usuari del servidor web perquè corri sense credencials addicionals. Programa l'execució per minut amb aquesta línia:

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

Firewall, ports i arrencada

Obre els ports necessaris a UFW: SSH per a administració remota, HTTPS per al CMS i el port TCP 9505 per a la publicació de XMR. Habilita el tallafoc al final per aplicar les regles:

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

Reinicia Apache i accedeix a la URL configurada al VirtualHost. Si tot està correcte, veureu la pantalla de comprovacions prèvies de Xibo. L'única alerta habitual és la de pujades grans si no heu ajustat php.ini com es va indicar:

sudo systemctl restart apache2

Assistent web d'instal·lació

A la primera pantalla, al final, prem Next per continuar amb l'assistent. Omple les dades de connexió a MariaDB i marca «Create a new database» perquè Xibo creï la base i els privilegis necessaris automàticament.

A continuació, l'instal·lador us demanarà el nom d'usuari i la contrasenya de l'administrador del CMS. Anota aquestes credencials amb seguretat perquè les utilitzaràs per al primer accés.

El següent pas és indicar la ruta de la llibreria de continguts, que en aquesta guia és /var/www/Library. També podeu confirmar o ajustar la llicència del servidor per a l'alta de reproductors. Si no us interessa enviar telemetria, desmarqueu l'opció d'estadístiques.

Després de finalitzar, podreu iniciar sessió amb el compte d'administrador acabat de crear i accedir al panell principal del CMS. Si no veus dissenys o notes rareses, força la recàrrega del navegador (per exemple, Shift+F5) per netejar memòria cau.

Primer inici: seguretat d'accés, perfil i notificacions

La primera vegada que entres convé canviar la contrasenya. Aneu al perfil d'usuari, feu clic a Edita i definiu un secret nou. Aprofita per afegir un correu vàlid amb què rebre recordatoris i alertes.

Al Perfil trobaràs Preferències de la interfície i un enllaç per tornar a mostrar la pantalla de benvinguda quan vulguis. Personalitzar aquests detalls t'estalvia temps al dia a dia si gestiones moltes pantalles.

Reforça l'accés amb Autenticació a Dos Factores (2FA). Podeu triar rebre el codi per correu o introduir el codi generat per l'app Google Authenticator. En activar-lo, genera Codis de Recuperació, copia'ls i guarda'ls en un gestor de contrasenyes.

Si alguna vegada perds l'accés al correu electrònic oa l'app de codis, un administrador pot restablir els codis de recuperació des de la reixeta d'usuaris. Després del reset, torna a habilitar 2FA des del teu perfil seguint els passos.

El sistema de Notificacions mostra missatges d'usuaris i esdeveniments del sistema. Accedeix des de la campaneta al costat del perfil i, si vols crear-ne una de nova, entra al Centre de Notificacions i utilitza «Add Notification». Recordeu que les opcions depenen de les característiques que l'administrador habiliti per al vostre rol.

Si no veieu el calaix de notificacions, demana que t'activin les característiques corresponents a Features i que se'n configuri una adreça d'enviament de correus a Configuració > Xarxa. L'opció «interrompre» en una notificació fa que l'usuari sigui redirigit automàticament a veure-la; perquè els avisos per correu electrònic funcionin, activeu Enable Email Alerts a Configuració > Manteniment.

Pujar i mostrar contingut en pantalles

Si ja tens imatges i vídeos creats fora del CMS, puja'ls a la Biblioteca i programa'ls a les teves pantalles des de la secció de Planificació. És ràpid i permet començar a emetre en minuts.

Per a rotacions tipus carrusel, crea una Playlist que agrupi els teus actius i assigna-la als Displays que vulguis. Afegir o treure elements de la llista actualitzarà les pantalles sense refer dissenys sencers.

Si prefereixes compondre els teus missatges al mateix Xibo, obre el Editor de Dissenys (Layout Editor). Pots partir de plantilles predissenyades o d'un llenç en blanc, col·locant regions per a vídeo, imatge, text, feeds, etc., i afinant la durada de cada giny.

Recorda que els Displays han d'estar connectats i autoritzats al CMS per començar a mostrar contingut. Si encara no n'has creat cap, vés a la secció Pantalles, autoritza els que apareguin com a pendents i assigna els teus primers dissenys.

Ordenació i filtres al CMS

A gairebé totes les reixetes del CMS (Dissenys, Mitjans, Pantalles, Usuaris, etc.) tens eines de ordenació i filtratge per trobar el que busques. Ordena per columnes, aplica filtres per nom, etiqueta, data o estat i guarda vistes si ho necessites.

Usar correctament aquestes opcions us ajuda a gestionar catàlegs grans i desplegaments amb desenes de pantalles. Una bona taxonomia amb etiquetes i filtres coherents redueix errors i accelera el treball de lequip.

Actualitzacions del CMS

Quan toqueu actualitzar, el més senzill és aturar Apache i XMR, fer còpia de seguretat i desplegar la nova versió. Comença per aturar serveis i versionar el directori actual per tenir volta enrere ràpida:

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

realitza un dump de la base de dades (substitueix «usuari» pel teu usuari no-root) i guarda'l al teu home o en emmagatzematge segur:

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

Desplegueu la nova versió del CMS en un directori net, còpia settings.php, la Library completa i el config.json de XMR. Elimina l'instal·lador web per evitar advertiments i fixa permisos adequats:

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

Si actualitzeu entre branques més grans (per exemple de la 2.xa la 3.x), executeu la migració de base de dades des del directori del CMS. Aquest pas aplica els canvis d'esquema necessaris:

vendor/bin/phinx migrate -c phinx.php

Torna a engegar serveis i entra al CMS. Si no es carreguen correctament els dissenys, fes un refresc forçat del navegador (Shift+F5). Pots verificar la versió instal·lada des de l'enllaç «Sobre» a la part inferior esquerra:

sudo systemctl start apache2 xibo-xmr

Player de Windows i alta de Displays

Per provar la teva xarxa de pantalles en un PC amb Windows, descarrega i instal·la el Xibo Player per a Windows (gratuït). Accepteu la llicència, deixeu marcada l'opció d'executar en finalitzar i completeu l'assistent.

En obrir el Player, introduïu la URL del CMS i connecteu-lo. Passats uns segons, hauríeu d'indicar que la connexió s'ha realitzat. Després, entra al CMS i autoritza aquest nou reproductor des de la secció Pantalles.

Amb el Player autoritzat, ja pots assignar dissenys o llistes de reproducció a aquest Display. Aquest és el punt de partida de la teva xarxa: afegeix més Players a les teves ubicacions i orquestra la cartelleria des del CMS.

Formació, documentació i comunitat

Si busques materials d'aprenentatge, hi ha vídeos que complementen la documentació oficial i recursos útils a la comunitat. Els fòrums de codi obert de Xibo són una gran font de solucions pràctiques i bones idees.

En alguns entorns trobaràs plans de suport i comunitats privades dedicades a tecnologies obertes (per exemple, iniciatives com Enginys de Sistemes, amb subscripcions assequibles i podcasts diaris). Aquests recursos poden ajudar-te a resoldre dubtes ràpidament i mantenir-te al dia.

Amb una instal·lació cuidada, seguretat reforçada amb 2FA, missatgeria XMR operativa, XTR programat i bones pràctiques de pujada i programació de continguts, tindràs una plataforma de cartelleria digital estable i flexible. Aprofita l'ordenació i els filtres del CMS, autoritza les teves pantalles amb criteri, i combina Playlists i Dissenys per a iterar ràpidament sense perdre qualitat en el que mostres.