Murmur est le logiciel serveur officiel du protocole de communication vocale Mumble. Cette implémentation officielle est stable et efficace. Ce guide décrira étape par étape le processus d'installation et de configuration d'un serveur Murmur pour la communication avec les clients Mumble sur FreeBSD 11.2.
Conditions préalables
- Tout VPS Vultr
- Un client SSH:
ssh
dans un terminal pour les utilisateurs Linux, Mac et Unix (y compris BSD)
- Le client PuTTY SSH pour Windows
Connectez-vous à votre serveur Vultr FreeBSD et connectez-vous en tant que root ou en tant sudo
qu'utilisateur. Si vous utilisez un sudo
utilisateur, ajoutez des commandes avec sudo
:
home-desktop$ ssh [email protected]
Remarque: remplacez-le 198.51.100.21
par votre propre adresse IP.
Installation du package Murmur
Remarque: Cette section installera un serveur Murmur vanille sans support D-Bus
/ Bonjour
.
Pour ajouter Murmur et ses dépendances au système, exécutez la commande suivante:
pkg install murmur
Puisque vous avez installé le logiciel serveur à partir de la distribution binaire, vous pouvez ignorer la section suivante et passer à la configuration de Murmur .
Installation à partir de ports
Si vous avez suivi le reste du guide jusqu'à présent et que vous ne souhaitez pas activer D-Bus
ou Bonjour
prendre en charge, ou désactiver la prise en charge Ice / MySQL / SQLite, n'hésitez pas à suivre la section précédente à la place, puis passez à Configuration de Murmur .
Obtenir l'arborescence des ports
Exécutez cette commande pour rechercher et télécharger les mises à jour de votre arborescence de ports (vous en aurez besoin si vous n'avez pas encore configuré les ports):
portsnap fetch
Si la sortie se termine par ' No updates needed
', vous pouvez passer à l'étape suivante. Sinon, vous n'avez pas d'arborescence de ports à jour préparée et devrez extraire l'instantané nouvellement téléchargé:
portsnap extract
Construire et installer l'application serveur
La compilation du port Murmur est facile, mais prendra un certain temps. Les commandes suivantes vous placent dans le répertoire du port, le construisent, installent les fichiers générés et suppriment les fichiers inutiles après leur construction:
cd /usr/ports/audio/murmur
make install clean
Au cours des premières parties de l'installation, vous verrez une ou plusieurs boîtes de dialogue de texte vous demandant quelles fonctionnalités vous souhaitez activer ou désactiver. Pour naviguer dans les menus, utilisez les flèches UPet DOWNpour mettre en surbrillance une entrée, SPACEpour basculer l'état activé / désactivé de l'entrée ou ENTERpour utiliser l'action par défaut. Pour modifier l'action par défaut (généralement sur «Annuler»), utilisez les flèches LEFTet RIGHT.
La fenêtre de dialogue de configuration de murmure présentera les options pour désactiver Bonjour
, activer D-Bus
, activer Ice et désactiver la prise en charge de MySQL ou SQLite. Il vous permet également de désactiver la création de la documentation, mais c'est généralement une mauvaise idée.
Résumé des options de configuration de construction de Murmur
Le nom de l'option et les choix du package officiel pour ces options sont affichés ici, si vous n'êtes pas sûr de l'une d'entre elles.
-
Bonjour
est un protocole de découverte des services de réseau local. À moins que vous n'accédiez à votre serveur Murmur via un VPN ou que vous souhaitiez qu'un autre VPS sur le même réseau privé trouve automatiquement Murmur, cela ne vous dérange pas disable
.
-
D-Bus
est un moyen pour les applications, généralement sur la même machine, de communiquer entre elles. Dans Murmur, l'interface D-Bus est obsolète et doit être laissée disabled
, à moins que vous ne soyez certain d'avoir une application qui nécessite l'interface D-Bus de Murmur.
-
Documentation
devrait être laissé à enabled
moins que vous ne vouliez pas spécifiquement que les pages de manuel soient à votre disposition. Cette option ne changera rien du point de vue du client et ne concerne que l'administrateur système.
-
Ice
est un protocole RPC plus récent qui vous permet d'administrer à distance Murmur en utilisant des moyens alternatifs comme les interfaces Web. Si vous le faites enable
, vous pouvez ultérieurement choisir de configurer une solution RPC qui vous permettra de faire des choses comme l'enregistrement des utilisateurs en ligne et la modération des canaux à distance. La configuration RPC ne sera pas traitée dans ce guide et nécessite généralement un serveur Web avec prise en charge de PHP.
-
MySQL
est un système de gestion de base de données puissant et évolutif. Cela devrait être laissé disable
, sauf si vous avez une base de données distante que vous souhaitez que Murmur utilise à la place d'un fichier local, ou si vous prévoyez d'avoir plusieurs milliers d'utilisateurs. Ce guide ne couvrira pas la configuration de MySQL.
-
SQLite
est une alternative légère aux grandes solutions de gestion de bases de données comme MySQL. Il permet un accès rapide à une base de données stockée dans un fichier local pour des centaines de milliers d'enregistrements, et en tant que tel, convient parfaitement à un serveur Murmur. Cela devrait être laissé enabled
, et la section de configuration de ce guide supposera que c'est le cas.
Lorsque vous êtes satisfait de ces options, utilisez LEFTet RIGHTpuis appuyez sur ENTERpour sélectionner OK
en bas de la fenêtre. Si vous avez la possibilité de configurer les dépendances, les valeurs par défaut sont les options les plus sûres, vous pouvez donc simplement appuyer sur ENTERpour les ignorer avec leurs options par défaut sélectionnées. Après la configuration, la création de Murmur et de ses dépendances (en particulier Boost) peut parfois prendre beaucoup de temps.
Configuration de Murmur
Il y a certaines choses que vous voudrez peut-être modifier avant de démarrer votre serveur pour la première fois. Cette section utilisera l'éditeur facile de FreeBSD, comme l'éditeur de texte préféré, mais vous pouvez utiliser n'importe quoi d'autre à la place.
Ouvrez le fichier de configuration de murmure dans un éditeur de texte:
ee /usr/local/etc/murmur.ini
La plupart de la configuration est expliquée dans le fichier et revient par défaut aux valeurs normales, mais nous allons brièvement toucher quelques options importantes.
Remarque: toutes les options répertoriées ci-dessous ont des valeurs par défaut. Vous n'avez pas besoin de les modifier pour que le serveur s'exécute.
Texte de bienvenue (MOTD)
Une chose que vous voudrez peut-être changer est le texte de bienvenue, ou comme certains l'appellent, le "Message du jour". Pour ce faire, recherchez la ligne commençant par welcometext=
et remplacez le message existant par quelque chose de nouveau. Mumble peut afficher une sélection limitée de balises HTML, comme <br />
pour signifier une nouvelle ligne:
welcometext="<br /> Check out this cool Vultr VPS! <br />"
Numéro de port
Les clients qui se connectent doivent spécifier un numéro de port si le serveur n'écoute pas sur le port par défaut. Si vous souhaitez modifier ce port afin que vos utilisateurs le sachent pour se connecter, utilisez l' port=
option. Sinon, laissez-le par défaut 64738
pour que vos utilisateurs n'aient qu'à se souvenir de l'adresse:
port=443
Nombre maximal d'utilisateurs autorisés
Le maximum par défaut de 100 utilisateurs est assez raisonnable, mais si vous souhaitez limiter le serveur à vous et à quelques amis, vous pouvez réduire ce maximum - ou l'augmenter, bien sûr - avec l' users
option:
users=5
Longueur du message
Si vous devez envoyer des messages dans le chat textuel de plus de 5000 caractères, vous voudrez changer l' textmessagelimit
option. Vous pouvez également le régler sur 0 pour supprimer complètement la limite:
textmessagelimit=12345
N'oubliez pas de supprimer le #
caractère au début de la ligne pour le décommenter, sinon la ligne ne prendra pas effet.
Taille de l'image
Cette option est juste en dessous de l'option de longueur de message, si vous décommentez les lignes du fichier de configuration par défaut. Avec la limite de taille d'image par défaut de 128 kilo-octets, vous pourriez avoir du mal à envoyer des images. Je recommanderais d'augmenter cela, mais pas à une valeur si élevée que quelqu'un pourrait envoyer une image suffisamment grande pour ralentir la connexion de tous les utilisateurs disposant de connexions Internet à bande passante inférieure. Comme la dernière option, vous pouvez définir la valeur de celle-ci sur 0 pour autoriser les images de toute taille. Bien sûr, ce n'est qu'une bonne idée lorsque vous savez que la connexion de tout le monde peut la gérer:
# 768KiB:
imagemessagelength=786432
N'oubliez pas de supprimer également le #
caractère au début de cette ligne.
Cryptage SSL / TLS
Si vous disposez d'une clé TLS et d'un certificat appropriés, vous pouvez les spécifier ici. Si vous ne le faites pas, Murmur générera le sien et le présentera, ce qui peut provoquer des erreurs de certificat pour vos utilisateurs.
Par exemple, pour un Let's Encrypt configuré dans /usr/local/etc/letsencrypt
:
# make sure the cert & key are readable by the user/group 'murmur'
sslCert=/usr/local/etc/letsencrypt/live/chat.example.com/fullchain.pem
sslKey=/usr/local/etc/letsencrypt/live/chat.example.com/privkey.pem
Démarrer Murmur pour la première fois
Maintenant que votre serveur est installé et configuré, il ne reste plus grand chose à faire que de le tester. Étant donné que le service n'est pas encore «activé», la commande régulière «start» ne s'exécutera pas. Donc, pour démarrer le serveur une fois, exécutez ce qui suit:
service murmur onestart
Avec le serveur en cours d'exécution, vous pouvez essayer de vous y connecter. Dans Mumble, ajoutez-le en tant que serveur en utilisant son nom de domaine ou son adresse IP et connectez-vous. Si vous pouvez vous connecter et êtes visible dans le canal racine, tout fonctionne. Sinon, vérifiez l'adresse du serveur et le fichier de configuration pour les fautes de frappe ou les erreurs, et assurez-vous que l' murmur
utilisateur peut lire la clé SSL si vous définissez la vôtre, et réessayez:
service murmur onerestart
Une fois que vous avez terminé, arrêtez le serveur pour que nous puissions le tester dans la section suivante:
service murmur onestop
Démarrage de Murmur au démarrage
Si vous pouvez vous connecter à votre nouveau serveur, vous êtes prêt à activer le service afin que Murmur démarre automatiquement lorsque vous redémarrez (après une mise à niveau, par exemple).
Pour ce faire, modifiez /etc/rc.conf
:
ee /etc/rc.conf
Appuyez sur CTRL+ E, suivi de ENTERpour mettre une ligne vierge sur la deuxième ligne du fichier et tapez:
murmur_enable="YES"
Ensuite , appuyez sur ESC, ENTER, ENTERpour sauvegarder et quitter. Pour tester la configuration, essayez la commande de démarrage du service normal:
service murmur start
Si cela ne fonctionne pas, il y a une faute de frappe rc.conf
. revenir en arrière et revérifier.
Si cela fonctionne, alors il n'y a plus rien à faire. Pour le tester, redémarrez:
sync && reboot
Attendez quelques secondes que le serveur redémarre jusqu'à ce que vous puissiez vous connecter avec SSH, puis essayez de vous reconnecter avec Mumble. Félicitations, vous venez d'installer et de configurer Murmur à partir de zéro.