Installation eines Yaesu-System-Fusion-Reflektors (YSF)

📡 Was ist ein YSF-Reflektor?

Ein YSF-Reflektor (Yaesu System Fusion) ist ein Server, der mehrere Amateurfunkstationen, die die digitale Betriebsart C4FM von Yaesu nutzen, über das Internet miteinander verbindet. Er dient als zentraler Treffpunkt, an dem alle verbundenen Nutzer gemeinsam kommunizieren können, und schafft so weltweite Gesprächs-"Räume".

Warum pYSFReflector?

Diese Anleitung verwendet pYSFReflector, entwickelt von IU5JAE. Es handelt sich um eine moderne Python-Version, welche die alte C++-Version von G4KLX ersetzt.

🇨🇭 Warum Infomaniak?

Infomaniak ist ein führender Schweizer Hoster und eignet sich besonders gut, um einen Amateurfunk-Reflektor zu betreiben:

📋 Voraussetzungen

Minimale VPS-Konfiguration

• 1 vCPU
• 1 GB RAM
• 10 GB SSD
• System: Debian 12 oder Ubuntu 24.04 LTS (empfohlen)

Vorzubereitende Angaben

🚀 Installation Schritt für Schritt

1. Vorbereitung des Servers

Verbinden Sie sich per SSH mit Ihrem VPS bei Infomaniak:

ssh utilisateur@votre-ip-vps

Aktualisieren Sie das System:

sudo apt update
sudo apt upgrade -y

Installieren Sie die Basiswerkzeuge:

sudo apt install -y git curl wget nano ufw

Legen Sie das Arbeitsverzeichnis an:

cd ~
mkdir ysf-install
cd ysf-install

2. Installation von Python und Abhängigkeiten

Installieren Sie Python 3:

sudo apt install -y python3 python3-pip python3-venv

Überprüfen Sie die Installation:

python3 --version

Installation der Python-Bibliotheken

Methode 1: Über die Systempakete (EMPFOHLEN)

sudo apt install -y python3-aprslib python3-tinydb

Für die Bibliothek "threaded", die nicht in den Paketquellen enthalten ist:

sudo pip3 install threaded --break-system-packages

Methode 2: Komplette Installation mit pip

Falls python3-tinydb nicht verfügbar ist:

sudo pip3 install aprslib --break-system-packages
sudo pip3 install tinydb --break-system-packages
sudo pip3 install threaded --break-system-packages

Methode 3: Dauerhafte Konfiguration von pip

sudo mkdir -p /root/.config/pip
sudo nano /root/.config/pip/pip.conf

Fügen Sie diese Zeilen in die Datei ein:

[global]
break-system-packages = true

Speichern Sie mit Ctrl+O, Enter und beenden Sie mit Ctrl+X.

Jetzt können Sie ohne das Flag installieren:

sudo pip3 install aprslib tinydb threaded

Prüfen Sie, ob die Bibliotheken installiert sind:

pip3 list | grep -E "aprslib|tinydb|threaded"

3. Installation von pYSFReflector

Laden Sie pYSFReflector von GitHub herunter:

cd ~/ysf-install
git clone https://github.com/iu5jae/pYSFReflector.git

Legen Sie die benötigten Verzeichnisse an:

sudo mkdir -p /opt/ysfreflector
sudo mkdir -p /var/log/ysfreflector
sudo mkdir -p /usr/local/etc

Kopieren Sie die Dateien:

cd pYSFReflector
sudo cp YSFReflector /opt/ysfreflector/
sudo cp YSFReflector.ini /opt/ysfreflector/
sudo chmod +x /opt/ysfreflector/YSFReflector

Erstellen Sie die Datei deny.db:

sudo touch /usr/local/etc/deny.db
sudo chmod 644 /usr/local/etc/deny.db

Setzen Sie die Berechtigungen für die Logs:

sudo chown -R $USER:$USER /var/log/ysfreflector

4. Konfiguration von YSFReflector

Bearbeiten Sie die Hauptkonfigurationsdatei:

sudo nano /opt/ysfreflector/YSFReflector.ini

Ändern Sie den Abschnitt [General]:

[General]
Id=00000
Name=HB9 SUISSE
Description=Reflecteur CH

Prüfen Sie den Abschnitt [Network]:

[Network]
Port=42000

Prüfen Sie den Abschnitt [Log]:

[Log]
FilePath=/var/log/ysfreflector
FileRoot=YSFReflector
FileLevel=1
DisplayLevel=1
FileRotate=1

Speichern Sie die Datei: Ctrl+O, Enter, Ctrl+X

5. Installation des Web-Dashboards

Für Ubuntu 24.04 / Debian 12:

sudo apt install -y apache2 php libapache2-mod-php php-mbstring php-xml php-curl

Für Ubuntu 22.04 / Debian 11:

sudo apt install -y apache2 php libapache2-mod-php php8.1-mbstring php8.1-xml php8.1-curl

Aktivieren und starten Sie Apache:

sudo systemctl enable apache2
sudo systemctl start apache2

Laden Sie das Dashboard herunter:

cd ~/ysf-install
git clone https://github.com/dg9vh/YSFReflector-Dashboard.git

Installieren Sie das Dashboard:

sudo rm -rf /var/www/html/*
sudo cp -R YSFReflector-Dashboard/* /var/www/html/
sudo rm -f /var/www/html/index.html

Erstellen Sie die Konfigurationsdatei:

sudo mkdir -p /var/www/html/config
sudo nano /var/www/html/config/config.php

Kopieren Sie diesen Inhalt (passen Sie die URL an Ihre Situation an):

<?php
// Pfade (OHNE abschliessenden Slash)
define("LOGPATH", "/var/log/ysfreflector");
define("LOGPREFIX", "YSFReflector");
define("INIPATH", "/opt/ysfreflector");
define("INIFILENAME", "YSFReflector.ini");
define("REFL_PATH", "/opt/ysfreflector");

// Kompatibilität mit älteren Versionen
define("YSFREFLECTORLOGPATH", "/var/log/ysfreflector");
define("YSFREFLECTORLOGPREFIX", "YSFReflector");
define("YSFREFLECTORINIPATH", "/opt/ysfreflector");
define("YSFREFLECTORINIFILENAME", "YSFReflector.ini");
define("YSFREFLECTORPATH", "/opt/ysfreflector");

// Anzeigeeinstellungen
define("REFRESHAFTER", "10");
define("LOGO", "");
define("URL", "http://votre-domaine.com");
define("LOCALE", "fr_CH.utf8");
define("TIMEZONE", "Europe/Zurich");

// Funktionen
define("SHOWSYSINFO", "1");
define("SHOWNETINFO", "1");
define("ENABLEXTDLOOKUP", "1");
define("QRZAPIKEY", "");
define("SHOWLH", "1");
define("LHLINES", "20");
define("DMRIDDATPATH", ".");
define("ENABLEYSFGATEWAY", "0");
?>

Speichern Sie und setzen Sie die Berechtigungen:

sudo chown -R www-data:www-data /var/www/html/
sudo chmod -R 755 /var/www/html/
sudo chmod 644 /var/www/html/config/config.php
sudo systemctl restart apache2

6. Konfiguration der Firewall (KRITISCH)

Teil 1: UFW-Firewall (auf dem Server)

sudo ufw allow 22/tcp
sudo ufw allow 42000/udp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
sudo ufw status verbose

Teil 2: Infomaniak-Firewall (Web-Panel)

1. Melden Sie sich bei manager.infomaniak.com an
2. Gehen Sie zu Cloud & Serveurs → Public Cloud
3. Wählen Sie Ihren VPS
4. Klicken Sie im Seitenmenü auf Firewall
5. Fügen Sie diese 4 Regeln hinzu:
   • Port 22/TCP - Protokoll TCP - Quelle: Überall - Aktion: Erlauben
   • Port 42000/UDP - Protokoll UDP - Quelle: Überall - Aktion: Erlauben
   • Port 80/TCP - Protokoll TCP - Quelle: Überall - Aktion: Erlauben
   • Port 443/TCP - Protokoll TCP - Quelle: Überall - Aktion: Erlauben
6. Speichern Sie die Änderungen

7. Konfiguration des Systemd-Dienstes

Erstellen Sie die Service-Datei:

sudo nano /etc/systemd/system/ysfreflector.service

Kopieren Sie diesen Inhalt:

[Unit]
Description=YSFReflector Service
After=network.target

[Service]
Type=simple
User=root
WorkingDirectory=/opt/ysfreflector
ExecStart=/usr/bin/python3 /opt/ysfreflector/YSFReflector /opt/ysfreflector/YSFReflector.ini
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

Speichern Sie, dann aktivieren und starten Sie den Dienst:

sudo systemctl daemon-reload
sudo systemctl enable ysfreflector.service
sudo systemctl start ysfreflector.service
sudo systemctl status ysfreflector.service

Nützliche Befehle

• sudo systemctl status ysfreflector.service: Status anzeigen
• sudo systemctl restart ysfreflector.service: Neu starten
• sudo journalctl -u ysfreflector.service -f: Logs in Echtzeit

Dashboard testen

Öffnen Sie Ihren Browser und rufen Sie auf: http://votre-ip-vps/

Sie sollten das Dashboard mit den Informationen Ihres Reflektors sehen!

📝 Anmeldung bei DVRef

Ablauf der Anmeldung

1. Gehen Sie auf https://dvref.com/ysf/new
2. Füllen Sie das Formular aus:
   • Name: Name Ihres Reflektors (z. B. "HB9 SUISSE")
   • Description: kurze Beschreibung
   • Country: Ländercode (CH, FR, BE usw.)
   • FQDN/IP: Ihre IP oder Ihr Domainname
   • Port: 42000
   • Email: Ihre E-Mail-Adresse
   • Callsign: Ihr Amateurfunk-Rufzeichen
3. Senden Sie das Formular ab
4. Sie erhalten eine Bestätigungs-E-Mail
5. Klicken Sie auf den Link in der E-Mail, um zu aktivieren
6. Notieren Sie Ihre fünfstellige ID (z. B. 12345)

Konfiguration aktualisieren

Bearbeiten Sie die Konfigurationsdatei:

sudo nano /opt/ysfreflector/YSFReflector.ini

Ändern Sie die Zeile Id:

[General]
Id=12345
Name=HB9 SUISSE
Description=Reflecteur CH

Ersetzen Sie 12345 durch Ihre tatsächliche ID. Speichern und neu starten:

sudo systemctl restart ysfreflector.service

🔒 HTTPS-Konfiguration mit Let's Encrypt

Installation von Certbot

sudo apt update
sudo apt install -y certbot python3-certbot-apache

SSL-Zertifikat beziehen

sudo certbot --apache -d ysf.votredomaine.com

Ersetzen Sie ysf.votredomaine.com durch Ihren echten Domainnamen. Beantworten Sie die Fragen:

1. Email: Geben Sie Ihre E-Mail-Adresse ein
2. Terms of Service: Tippen Sie Y
3. Share email: Y oder N (optional)
4. Redirect HTTP to HTTPS: Wählen Sie 2 für die automatische Weiterleitung

Überprüfung

sudo certbot certificates

Dashboard aktualisieren

sudo nano /var/www/html/config/config.php

Ändern Sie die Zeile URL:

define("URL", "https://ysf.votredomaine.com");

Speichern Sie und starten Sie Apache neu:

sudo systemctl restart apache2

Testen Sie: https://ysf.votredomaine.com - Sie sollten ein grünes Schloss in der Adresszeile sehen!

🎨 Dashboard anpassen

Logo hinzufügen

Laden Sie Ihr Logo hoch (PNG, empfohlen 200x200px):

scp logo.png utilisateur@votre-ip:/home/utilisateur/
ssh utilisateur@votre-ip
sudo mv ~/logo.png /var/www/html/logo.png
sudo chown www-data:www-data /var/www/html/logo.png

Aktivieren Sie es in der Konfiguration:

sudo nano /var/www/html/config/config.php

define("LOGO", "logo.png");

Name und Beschreibung ändern

sudo nano /opt/ysfreflector/YSFReflector.ini

[General]
Id=12345
Name=MEIN YSF REFLEKTOR
Description=Beschreibung

Starten Sie den Reflektor neu:

sudo systemctl restart ysfreflector.service

🔧 Wartung

Empfohlene monatliche Wartung

sudo apt update
sudo apt upgrade -y
sudo apt autoremove -y

Speicherplatz prüfen

df -h

Alte Logs löschen

sudo find /var/log/ysfreflector/ -name "*.log" -mtime +30 -delete

Konfiguration sichern

mkdir -p ~/backups
sudo cp /opt/ysfreflector/YSFReflector.ini ~/backups/YSFReflector.ini.$(date +%Y%m%d)
sudo cp /var/www/html/config/config.php ~/backups/config.php.$(date +%Y%m%d)

🔧 Fehlerbehebung

Problem 1: Dashboard zeigt leere Seite

sudo tail -50 /var/log/apache2/error.log
sudo systemctl status ysfreflector.service
ls -la /var/log/ysfreflector/

Problem 2: Dienst startet nicht

sudo journalctl -u ysfreflector.service -n 100

Bei der Fehlermeldung "deny.db not found":

sudo touch /usr/local/etc/deny.db
sudo chmod 644 /usr/local/etc/deny.db
sudo systemctl restart ysfreflector.service

Problem 3: Dashboard nicht erreichbar

Prüfen Sie beide Firewalls:

sudo ufw status | grep 80
sudo systemctl status apache2

Prüfen Sie auch im Infomaniak-Panel, ob die Ports 80 und 443 offen sind.

Problem 4: In Pi-Star nicht sichtbar

Checkliste:

• ✓ Bei DVRef.com angemeldet?
• ✓ Bestätigungs-E-Mail aktiviert?
• ✓ ID in YSFReflector.ini aktualisiert?
• ✓ Port 42000/UDP offen (UFW + Infomaniak)?
• ✓ Dienst ysfreflector läuft (running)?
• ✓ Mindestens 24-48 h gewartet?

🎯 Fazit

Nützliche Ressourcen

• DVRef.com - Offizielles YSF-Register
• pYSFReflector auf GitHub
• Dashboard auf GitHub
• Infomaniak VPS
• Let's Encrypt

🤝 Unsere Partner

Phonicom.ch: Amateurfunk-Spezialist in der Schweiz

Bei Phonicom finden Sie Yaesu-C4FM-Funkgeräte, WPSD-Hotspots und alles Zubehör für das Yaesu-System-Fusion-Netz. Persönliche Beratung und Lieferung in der ganzen Schweiz.

phonicom.ch besuchen →