Installer son serveur vocal WebRTC
Procédure pour une nouvelle installation autonome, avec TLS, ports, service et deux clés. Ne pas appliquer aveuglément sur une production existante.
Dépôts et téléchargements officiels
Trois composants distincts : serveur vocal, modules simulateur, et conférences ad hoc optionnelles. Choisis les versions compatibles avec ton installation.
Préparer l’hôte et le DNS
Le guide du dépôt cible Ubuntu 24.04 x86-64 avec systemd. Préparez une IP publique réellement accessible par les viewers et un nom DNS dirigé vers le serveur. Le certificat TLS doit correspondre au nom DNS. Prévoyez la gestion de NAT si le serveur est derrière un routeur.
Comprendre les ports avant de les ouvrir
TCP 9443 sert à la signalisation HTTPS des simulateurs ; UDP 40000–40999 transporte les médias des viewers. TCP 80 peut être nécessaire à l’émission ou au renouvellement Let's Encrypt selon la méthode retenue. N’ouvrez TCP 9443 au public qu’après avoir confirmé la protection par clé RPC.
Exemple pour votre propre installation : adaptez tous les domaines, chemins et noms.
sudo ufw status sudo ufw allow 40000:40999/udp
Télécharger l’installateur de la bonne release
Pour une nouvelle installation, utilisez l’archive installateur v1.0.0, lisez setup.sh avant exécution, puis suivez les invites IP et DNS. L’installateur gère le binaire, le service et la préparation TLS, mais pas les clés, modules régionaux ou l’API de conférences.
Exemple pour votre propre installation : adaptez tous les domaines, chemins et noms.
mkdir -p "$HOME/bloodmoon-voice-install" && cd "$HOME/bloodmoon-voice-install" curl -fL https://github.com/Vlad-BloodMoon/BloodMoon-Voice/releases/download/v1.0.0/BloodMoon-Voice-installer-v1.0.0.tar.gz -o installer.tar.gz mkdir source && tar -xzf installer.tar.gz -C source cd source less setup.sh sudo bash setup.sh
Créer deux clés sans détruire celles qui existent
Une installation indépendante neuve utilise cred_key pour les tickets de voix et rpc_key pour authentifier les requêtes des simulateurs. L’exemple ci-dessous conserve les clés existantes ; ne régénérez pas de clés sur une installation déjà en service.
Exemple pour votre propre installation : adaptez tous les domaines, chemins et noms.
sudo bash <<'KEYS'
set -euo pipefail
install -d -o root -g wolfvoice -m 750 /etc/wolfvoice
for key in cred_key rpc_key; do
path="/etc/wolfvoice/$key"
if [ -e "$path" ]; then
test -s "$path" || exit 1
else
umask 077
openssl rand -hex 32 > "$path"
fi
chown root:wolfvoice "$path"
chmod 640 "$path"
done
KEYSVérifier que le service fonctionne
Redémarrez le service puis inspectez son état et les logs. Avant l’ouverture de 9443, vérifiez avec la procédure du dépôt qu’une requête non authentifiée est refusée ; voir le guide source pour le test JSON-RPC et TLS complet.
Exemple pour votre propre installation : adaptez tous les domaines, chemins et noms.
sudo systemctl restart wolfvoice.service sudo systemctl status wolfvoice.service --no-pager -l sudo journalctl -u wolfvoice.service -n 40 --no-pager
Ouvrir les flux de signalisation seulement après validation
Lorsque le test de refus sans clé est concluant, autorisez TCP 9443 pour les simulateurs prévus et conservez la protection par clé. Les plages UDP doivent rester accessibles aux viewers ; adaptez le pare-feu de l’hébergeur et les redirections NAT. N’activez pas UFW à distance sans garantir SSH.
Exemple pour votre propre installation : adaptez tous les domaines, chemins et noms.
sudo ufw allow 9443/tcp sudo ufw status
Ne pas réinstaller une production existante
Le guide indique de ne pas relancer setup.sh pour une simple mise à jour. Sauvegardez binaire, unité systemd, paramètres, clés et certificats, puis procédez par remplacement contrôlé et redémarrage planifié si nécessaire.