OpenSimulator · FR

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.

Cette documentation concerne une pile WebRTC précise. Respectez les versions compatibles et consultez les sources liées avant de modifier une installation de production.

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.

BloodMoon Voice — serveur vocalRelease v1.0.0 et installateur
Modules WebRTC OpenSimulatorRelease v0.9.3.1-webrtc.3, ZIP DLL/PDB
OpenSimulator AdHoc ConferencesDépôt PHP/MySQL et guide d’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
KEYS

Vé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.

Lire la suite et sources