Installazione di un riflettore XLX multimodo
YSF, DMR, D-Star, C4FM su Ubuntu 22.04 / 24.04 o Debian 12
Guida completa e aggiornata - ottobre 2025
Indice
- 1. Introduzione
- 2. Prerequisiti
- 3. Preparazione del sistema
- 4. Installazione delle dipendenze
- 5. Download e configurazione di XLX
- 6. Compilazione del riflettore
- 7. Configurazione del servizio di sistema
- 8. Installazione della dashboard web
- 9. Configurazione del server web Apache
- 10. Configurazione del firewall
- 11. Avvio e verifica
- 12. Configurazione SSL
- 13. Registrazione negli elenchi pubblici
- 14. Risoluzione dei problemi
- 15. Manutenzione
- 16. Connessione al riflettore
- 17. Conclusione
1. Introduzione
Che cos'è XLX?
XLX è un riflettore multiprotocollo e multimodo per i modi digitali radioamatoriali. Permette di creare un server che supporta contemporaneamente:
- D-Star (con i protocolli DPlus/REF, DCS, DExtra/XRF)
- DMR (Digital Mobile Radio)
- YSF/C4FM (Yaesu System Fusion)
Vantaggi di XLX
- Multimodo nativo: gli utenti DMR e YSF possono comunicare senza hardware di transcodifica
- Fino a 26 moduli (stanze dalla A alla Z)
- Dashboard in tempo reale
- Interconnessione possibile tra riflettori
- Open source e compatibile con Pi-Star
Per permettere la comunicazione tra D-Star e gli altri modi, avrà bisogno di chip AMBE hardware (circa 90€ l'uno, minimo 2). DMR ↔ YSF funziona in modo nativo dal 2020.
2. Prerequisiti
Server
- Server VPS o dedicato con Ubuntu 22.04/24.04 o Debian 12
- CPU: minimo 1-2 vCPU
- RAM: minimo 1-2 GB
- Spazio su disco: minimo 20 GB
- Provider consigliati: Linode, DigitalOcean, OVH (5€/mese)
Rete
- Indirizzo IP pubblico fisso (IPv4 obbligatorio)
- Nome di dominio completo (FQDN): ad esempio
xlx.votre-domaine.fr - Porte di rete accessibili
Numero XLX
Scelga un numero a 3 cifre (000-999) non ancora utilizzato. Verifichi su: https://xlx.n5amd.com/index.php?show=reflectors
Usi SOLO cifre, niente lettere. Il Suo riflettore si chiamerà XLX###.
3. Preparazione del sistema
Connessione al server
ssh root@votre-serveur.com
Aggiornamento del sistema
sudo apt update -y
sudo apt upgrade -y
sudo apt dist-upgrade -y
Creazione di un utente amministratore
apt install sudo -y
adduser votre-callsign
usermod -aG sudo votre-callsign
su - votre-callsign
cd ~
D'ora in poi, usi questo utente per tutti i comandi.
4. Installazione delle dipendenze
sudo apt install -y \
git git-core apache2 php libapache2-mod-php \
php-cli php-xml php-mbstring php-curl php-mysql \
build-essential g++ make ufw certbot python3-certbot-apache
Verifica delle versioni
php -v # PHP 8.x
apache2 -v # Apache 2.4.x
gcc -v # GCC 11.x o superiore
5. Download e configurazione di XLX
Download dei sorgenti
cd ~
git clone https://github.com/LX3JL/xlxd.git
cd xlxd/src
nano main.h
Parametri da modificare in main.h
1. Attivazione dell'auto-link YSF
Cambi:
#define YSF_AUTOLINK_ENABLE 0
In:
#define YSF_AUTOLINK_ENABLE 1
2. Indirizzo IP del server
Trovi il Suo IP:
curl ifconfig.me
Poi modifichi:
#define IP_ADDRESS "123.45.67.89" // Il Suo IP pubblico
3. Numero di moduli (facoltativo)
#define NB_OF_MODULES 26 // Per attivare A-Z
Salvi: Ctrl + X, poi Y, poi Invio
6. Compilazione del riflettore
make clean
make
sudo make install
sudo chmod +x /xlxd/xlxd
Download del database DMR ID
sudo wget -O /xlxd/dmrid.dat http://xlxapi.rlx.lu/api/exportdmr.php
7. Configurazione del servizio di sistema
sudo cp ~/xlxd/scripts/xlxd /etc/init.d/xlxd
sudo nano /etc/init.d/xlxd
Modifichi la riga ARGUMENTS:
ARGUMENTS="XLX### votre.ip.publique 127.0.0.1"
Esempio:
ARGUMENTS="XLX123 203.0.113.45 127.0.0.1"
Attivazione:
sudo update-rc.d xlxd defaults
8. Installazione della dashboard web
sudo cp -r ~/xlxd/dashboard /var/www/xlxd
sudo nano /var/www/xlxd/pgs/config.inc.php
Parametri essenziali
1. Informazioni di contatto
$PageOptions['ContactEmail'] = 'votre-email@domaine.com';
$PageOptions['MetaDescription'] = 'XLX### - Riflettore multimodo';
$PageOptions['MetaAuthor'] = 'VOTRE-CALLSIGN';
2. Configurazione Calling Home (IMPORTANTE)
$CallingHome['Active'] = true;
$CallingHome['MyDashBoardURL'] = 'xlx.votre-domaine.fr';
$CallingHome['Country'] = 'FR';
$CallingHome['Comment'] = 'Riflettore multimodo francese';
$CallingHome['HashFile'] = '/xlxd/callinghome.php';
$CallingHome['Active'] DEVE essere impostato su true per comparire negli elenchi pubblici.Assegnazione dei permessi
sudo chown -R www-data:www-data /var/www/xlxd/
sudo chown -R www-data:www-data /xlxd/
9. Configurazione del server web Apache
sudo nano /etc/apache2/sites-available/xlx.votre-domaine.fr.conf
Contenuto:
<VirtualHost *:80>
ServerName xlx.votre-domaine.fr
ServerAdmin votre-email@domaine.com
DocumentRoot /var/www/xlxd
<Directory /var/www/xlxd>
Options -Indexes +FollowSymLinks
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
Attivazione:
sudo a2ensite xlx.votre-domaine.fr.conf
sudo systemctl reload apache2
10. Configurazione del firewall
Porte TCP
sudo ufw allow 80/tcp # HTTP
sudo ufw allow 443/tcp # HTTPS
sudo ufw allow 22/tcp # SSH
sudo ufw allow 10001/tcp # XLX Core
sudo ufw allow 10002/tcp # Interconnessione
sudo ufw allow 42000/tcp # YSF
sudo ufw allow 30001/tcp # DExtra
sudo ufw allow 20001/tcp # DPlus
sudo ufw allow 30051/tcp # DCS
Porte UDP
sudo ufw allow 8880/udp # DMR+
sudo ufw allow 10001/udp # XLX
sudo ufw allow 42000/udp # YSF
sudo ufw allow 30001/udp # DExtra
sudo ufw allow 20001/udp # DPlus
sudo ufw allow 30051/udp # DCS
Attivazione:
sudo ufw enable
sudo ufw status verbose
Per i VPS cloud, apra queste porte anche nel firewall del provider.
11. Avvio e verifica
sudo service xlxd start
sudo systemctl status xlxd
sudo chown -R www-data:www-data /var/log/xlxd.xml
sudo systemctl restart apache2
Test della dashboard
http://xlx.votre-domaine.fr
Dovrebbe vedere il Suo riflettore XLX### con la versione v2.5.3.
12. Configurazione SSL (consigliata)
sudo apt install certbot python3-certbot-apache -y
sudo certbot --apache -d xlx.votre-domaine.fr
sudo certbot renew --dry-run
Ora acceda a https://xlx.votre-domaine.fr
13. Registrazione negli elenchi pubblici
Con $CallingHome['Active'] = true, il Suo riflettore si registra automaticamente.
Tempi: da 2 a 48 ore per comparire negli elenchi pubblici.
Verifichi su: https://xlx.n5amd.com/index.php?show=reflectors
14. Risoluzione dei problemi
Il servizio non si avvia
sudo journalctl -u xlxd -n 50
cat /etc/init.d/xlxd
ls -la /xlxd/xlxd
sudo chmod +x /xlxd/xlxd
La dashboard è vuota
sudo systemctl status apache2
sudo chown -R www-data:www-data /var/www/xlxd/
sudo tail -f /var/log/apache2/xlx-error.log
Non compare negli elenchi
- Verificare
$CallingHome['Active'] = true - Verificare l'FQDN
- Attendere 24-48 ore
- Verificare i log
15. Manutenzione
Aggiornamento di XLX
sudo systemctl stop xlxd
cd ~/xlxd && git pull
cd src && make clean && make
sudo make install
sudo systemctl start xlxd
Aggiornamento del database DMR
sudo wget -O /xlxd/dmrid.dat http://xlxapi.rlx.lu/api/exportdmr.php
sudo systemctl restart xlxd
16. Connessione al riflettore
Da Pi-Star (D-Star)
- Configuration → Expert → MMDVMHost
- Sezione D-Star Network:
- Protocollo: XLX
- Hostname:
xlx.votre-domaine.fr - Porta:
30001 - Modulo:
B
Codici DTMF
*###A→ Modulo A*###B→ Modulo B*U→ Disconnessione
17. Conclusione
Congratulazioni! Il Suo riflettore XLX multimodo è operativo.
Prossimi passi
- Provi con il Suo hotspot
- Configuri moduli dedicati
- Aggiunga la transcodifica AMBE se necessario
- Promuova il Suo riflettore
Buone pratiche
- Documenti la Sua configurazione
- Aggiorni regolarmente
- Tenga d'occhio i log
- Mantenga la sicurezza (SSL, aggiornamenti)
- Condivida le Sue conoscenze
73 e buon traffico sul Suo nuovo riflettore XLX!
