Panoramica generale

Castly Control è una piattaforma self-hosted per gestire live streaming a bassa latenza tramite WordPress, OvenMediaEngine, player embed, licenze commerciali e campagne VAST Ads.

Architettura

Castly è composto da più livelli che lavorano insieme. Separare bene i ruoli aiuta a capire dove intervenire in caso di problemi.

Installazione e aggiornamento

La struttura corretta del bundle Castly è sempre castly-installer/. Non usare bundle flat.

Installazione remota consigliata

curl -fsSL https://castly.it/castly-installer/install.sh | sudo bash

Lo script remoto scarica l'ultima release indicata in latest.json, installa prerequisiti come unzip, estrae il bundle in /root e avvia /root/castly-installer/install.sh.

Aggiornamento remoto consigliato

curl -fsSL https://castly.it/castly-installer/update.sh | sudo bash

L'update remoto scarica il bundle, lo estrae nello stesso percorso e lancia /root/castly-installer/update.sh, preservando la configurazione locale.

Comandi manuali update

cd /root
unzip -o NOME-BUNDLE.zip
cd /root/castly-installer
chmod +x install.sh update.sh
sudo bash ./update.sh

Comandi manuali installazione da zero

cd /root
unzip -o NOME-BUNDLE.zip
cd /root/castly-installer
chmod +x install.sh update.sh
sudo bash ./install.sh

Setup Wizard

Il Wizard è la guida iniziale e permanente del pannello. Alla prima installazione senza licenza guida l'utente verso l'attivazione; dopo resta accessibile dal menu Wizard.

Nel Wizard la licenza mostra il piano reale letto dalla stessa opzione usata nella sezione License, quindi il dato è coerente con il license server.

Licenza

La licenza si inserisce in Settings > License oppure nel primo step del Wizard quando si parte da una nuova installazione.

Campi principali

• License Key.
• License Server URL: normalmente https://license.castly.it.
• Status.
• Plan.
• Expires At.
• Last Validation.
• Instance ID.
• Last response code.

Regole enforcement

Dashboard

La Dashboard è il punto di ingresso operativo. Serve per controllare rapidamente stato licenza, canali, stream, runtime e salute generale della piattaforma.

• Verifica a colpo d'occhio se il sistema è pronto.
• Aiuta a capire se OME, agent o licenza richiedono attenzione.
• Rimane accessibile anche in caso di problemi licenza, per permettere recupero e diagnostica.

Channels

I canali sono il cuore operativo di Castly. Ogni canale rappresenta un flusso live con una propria stream key, player ed eventuali impostazioni VAST.

Come creare un canale

1. Apri Channels.
2. Crea un nuovo canale.
3. Imposta nome canale e stream key.
4. Configura eventuale messaggio offline personalizzato.
5. Salva.
6. Esegui Sync to OME se devi aggiornare la configurazione streaming.

A cosa serve Sync to OME?

Sync to OME invia o riallinea la configurazione del canale verso OvenMediaEngine. Serve quando Castly deve fare in modo che OME conosca il canale/app/stream e i relativi endpoint.

Messaggio offline per canale

Ogni canale può avere un messaggio offline personalizzato. Se il campo è vuoto, viene usato il messaggio standard interno.

OBS / Encoder

OBS o un encoder compatibile invia il flusso verso Castly tramite RTMP. Il player poi rende disponibile la diretta con WebRTC o LL-HLS.

Impostazioni principali

Players

La sezione Players consente di vedere anteprime, embed e codici da inserire in siti esterni o pagine WordPress.

• Preview del player del canale.
• Codice embed iframe.
• Shortcode WordPress quando disponibile.
• Stato live/offline.
• Messaggio offline personalizzato per canale.

Con la V.1.6.2.8 i permalink vengono aggiornati automaticamente dopo install/update, quindi gli endpoint player dovrebbero funzionare senza dover salvare manualmente i permalink WordPress.

VAST Ads

Il modulo VAST permette di creare campagne pubblicitarie video e associarle ai singoli player/canali.

Cosa puoi configurare

Campagne VAST

• Creazione campagna.
• Upload video spot con loading/progress.
• Generazione XML VAST.
• Validazione interna con motivazione degli errori.
• Lista campagne in accordion: titolo visibile, scheda apribile.
• Delete migliorato e deduplica dopo restore backup.

Quando usare la validazione

Usala dopo aver creato o modificato una campagna. Se la validazione non passa, Castly mostra la motivazione, per esempio URL video mancante, XML incompleto, media file non raggiungibile o dati non coerenti.

Runtime

Runtime serve a capire cosa sta succedendo sul server: stato dei servizi, agent, OME, metriche e risposte operative.

• Controllo Castly Agent.
• Controllo OME/API.
• Stato stream e segnali runtime.
• Supporto diagnostico quando la diretta non parte.

Settings

Settings raccoglie le aree amministrative principali. Alcune sezioni sono visibili solo agli Administrator.

Utenti e ruoli

Castly supporta una modalità utile per rivenditori e installazioni white-label: l'amministratore può creare utenti Editor e consegnare al cliente un pannello limitato.

Manutenzione

Permalink

Prima della V.1.6.2.8 poteva essere necessario salvare manualmente i permalink WordPress dopo nuova installazione. Ora il flush viene eseguito automaticamente.

sudo -u www-data wp rewrite flush --hard --allow-root

Cron licenza

cat /etc/cron.d/castly-license-validation
systemctl status cron --no-pager

Forzare check licenza

cd /var/www/TUO-DOMINIO/public
sudo -u www-data wp cron event run castly_license_daily_validation --allow-root

Certificati SSL

sudo certbot renew --dry-run
sudo certbot renew --force-renewal
sudo nginx -t && sudo systemctl reload nginx

Su server Castly con OME, dopo rinnovo SSL è consigliato rilanciare l'update Castly o riavviare OME per riallineare i certificati.

Troubleshooting