Requisits previs
Instal·lació del paquet Murmur
Instal·lació des de ports
Configuració de Murmur
Iniciant Murmur per primera vegada
Iniciant Murmur a l'arrencada
Murmur és el programari de servidor oficial per al protocol de comunicació de veu Mumble. Aquesta implementació oficial és estable i eficient. Aquesta guia descriu pas a pas el procés d'instal·lació i configuració d'un servidor Murmur per a la comunicació amb clients de Mumble a FreeBSD 11.2.
Requisits previs
- Qualsevol VPS Vultr
- Un client SSH:
ssh en un terminal per a usuaris de Linux, Mac i Unix (incloent-hi BSD).
- El client PuTTY SSH per a Windows
SSH al vostre servidor Vultr FreeBSD i inicieu sessió com a root o com a sudousuari. Si utilitzeu un sudousuari, anteposeu les ordres amb sudo:
home-desktop$ ssh root@198.51.100.21
Nota: substituïu-lo 198.51.100.21per la vostra pròpia adreça IP.
Instal·lació del paquet Murmur
Nota: aquesta secció instal·larà un servidor Murmur de vainilla sense D-Bus/ sense Bonjoursuport.
Per afegir Murmur i les seves dependències al sistema, executeu l'ordre següent:
pkg install murmur
Com que heu instal·lat el programari del servidor des de la distribució binària, podeu saltar la secció següent i passar a Configurar Murmur .
Instal·lació des de ports
Si heu seguit la resta de la guia fins a aquest punt, i no voleu habilitar D-Buso Bonjourdonar suport, o desactivar el suport d'Ice/MySQL/SQLite, no dubteu a seguir la secció anterior i, a continuació, aneu a Configuració de murmur .
Obtenció de l'arbre de ports
Executeu aquesta ordre per comprovar i descarregar-vos actualitzacions al vostre arbre de ports (ho necessitareu si encara no teniu els ports configurats):
portsnap fetch
Si la sortida acaba amb " No updates needed", podeu passar al pas següent. En cas contrari, no teniu preparat un arbre de ports actualitzat i haureu d'extreure la instantània recentment baixada:
portsnap extract
Construcció i instal·lació de l'aplicació servidor
Compilar el port Murmur és fàcil, però trigarà una mica de temps. Les ordres següents us posaran al directori del port, el construiran, instal·laran els fitxers generats i eliminaran els fitxers innecessaris després de crear-los:
cd /usr/ports/audio/murmur
make install clean
Durant les primeres parts de la instal·lació, veureu un o més diàlegs de text que us demanen sobre les funcions que voleu activar o desactivar. Per navegar pels menús, utilitzeu les fletxes UPi DOWNper ressaltar una entrada, SPACEper canviar l'estat d'activació/desactivació de l'entrada o ENTERper utilitzar l'acció predeterminada. Per canviar l'acció predeterminada (normalment a "Cancel·la"), utilitzeu les fletxes LEFTi RIGHT.
La finestra de diàleg de configuració de murmur presentarà les opcions per desactivar Bonjour, habilitar D-Bus, habilitar Ice i desactivar el suport de MySQL o SQLite. També us permet desactivar la creació de la documentació, però en general això és una mala idea.
Resum de les opcions de configuració de la construcció de Murmur
El nom de l'opció i les opcions del paquet oficial per a aquestes opcions es mostren aquí, si no esteu segurs d'alguna d'elles.
Bonjourés un protocol per a la descoberta de serveis de xarxa local. A menys que accediu al vostre servidor de Murmur mitjançant una VPN o vulgueu que un altre VPS a la mateixa xarxa privada trobi Murmur automàticament, això està bé disable.
D-Busés una manera perquè les aplicacions, normalment a la mateixa màquina, es comuniquin entre elles. A Murmur, la interfície D-Bus està obsoleta i s'ha de deixar disabled, tret que estigueu segur que teniu una aplicació que requereix la interfície D-Bus de Murmur.
Documentations'ha de deixar enabledtret que no vulgueu específicament que les pàgines del manual estiguin disponibles per a vosaltres. Aquesta opció no canviarà res des del punt de vista del client, i només és rellevant per a l'administrador del sistema.
Iceés un protocol RPC més recent que us permet administrar Murmur de forma remota mitjançant mitjans alternatius com ara interfícies web. Si feu enableaixò, més endavant podeu optar per configurar una solució RPC que us permetrà fer coses com ara el registre d'usuaris en línia i la moderació remota del canal. La configuració RPC no es tractarà en aquesta guia, i normalment requereix un servidor web amb suport PHP.
MySQLés un sistema de gestió de bases de dades potent i escalable. Això s'ha de deixar disable, tret que si teniu una base de dades remota us agradaria que Murmur utilitzi en lloc d'un fitxer local, o si teniu previst tenir molts milers d'usuaris. Aquesta guia no tractarà la configuració de MySQL.
SQLiteés una alternativa lleugera a solucions de gestió de bases de dades més grans com MySQL. Permet un accés ràpid a una base de dades emmagatzemada en un fitxer local per a centenars de milers de registres i, com a tal, és molt adequat per a un servidor Murmur. Això s'hauria de deixar enabledi la secció de configuració d'aquesta guia assumirà que sí.
Quan estigueu satisfet amb aquestes opcions, feu servir LEFTi RIGHTi després premeu ENTERper seleccionar OKa la part inferior de la finestra. Si se us presenta l'opció de configurar dependències, les opcions predeterminades són les més segures, de manera que només podeu prémer ENTERper descartar-les amb les opcions predeterminades seleccionades. Després de la configuració, la construcció de Murmur i les seves dependències (especialment Boost) de vegades pot trigar molt de temps.
Configuració de Murmur
Hi ha algunes coses que potser voldreu ajustar abans d'iniciar el servidor per primera vegada. Aquesta secció utilitzarà l'Editor fàcil de FreeBSD, com a editor de text preferit, però podeu utilitzar qualsevol altra cosa.
Obriu el fitxer de configuració del murmur en un editor de text:
ee /usr/local/etc/murmur.ini
La major part de la configuració s'explica al fitxer i els valors predeterminats són normals, però tocarem breument algunes opcions importants.
Nota: Totes les opcions que s'enumeren a continuació tenen valors predeterminats. No cal que els canvieu perquè el servidor s'executi.
Text de benvinguda (MOTD)
Una cosa que potser voldreu canviar és el text de benvinguda, o com alguns l'anomenen, el "Missatge del dia". Per fer-ho, cerqueu la línia que comenci per welcometext=i substituïu el missatge existent per quelcom de nou. Mumble pot mostrar una selecció limitada d'etiquetes HTML, com <br />per indicar una línia nova:
welcometext="<br /> Check out this cool Vultr VPS! <br />"
Número de port
Els clients que es connecten han d'especificar un número de port si el servidor no escolta al port predeterminat. Si voleu canviar aquest port perquè els vostres usuaris el coneguin per connectar-vos, feu servir l' port=opció. En cas contrari, deixeu-ho per defecte 64738perquè els vostres usuaris només hagin de recordar l'adreça:
port=443
Màxim d'usuaris permesos
El màxim predeterminat de 100 usuaris és bastant raonable, però si voleu limitar el servidor només a vosaltres i a uns quants amics, podeu reduir aquest màxim, o augmentar-lo, és clar, amb l' usersopció:
users=5
Longitud del missatge
Si necessiteu enviar missatges al xat de text de més de 5.000 caràcters, voldreu canviar l' textmessagelimitopció. També podeu posar-lo a 0 per eliminar completament el límit:
textmessagelimit=12345
Recordeu eliminar el #caràcter a l'inici de la línia per deixar de comentar-lo, o la línia no tindrà efecte.
Mida de la imatge
Aquesta opció es troba just a sota de l'opció de longitud del missatge, si esteu eliminant els comentaris del fitxer de configuració predeterminat. Amb el límit predeterminat de mida de la imatge de 128 kilobytes, és possible que us costa enviar imatges. Recomano augmentar-ho, però no a un valor tan alt que algú pugui enviar una imatge prou gran com per alentir la connexió de qualsevol usuari amb connexions a Internet d'ample de banda inferior. Com l'última opció, podeu establir el valor d'aquesta a 0 per permetre imatges de qualsevol mida. Per descomptat, això només és una bona idea quan saps que la connexió de tothom pot gestionar-ho:
# 768KiB:
imagemessagelength=786432
No oblideu eliminar també el #caràcter al començament d'aquesta línia.
Encriptació SSL/TLS
Si teniu una clau i un certificat TLS adequats, podeu especificar-los aquí. Si no ho feu, Murmur generarà els seus propis i els presentarà, cosa que pot provocar errors de certificat als vostres usuaris.
Per exemple, per a un Let's Encrypt configurat a /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
Començar Murmur per primera vegada
Ara que el vostre servidor està instal·lat i configurat, no queda molt per fer sinó provar-lo. Com que el servei encara no està "habilitat", l'ordre normal "inici" no s'executarà. Per tant, per iniciar el servidor una vegada, executeu el següent:
service murmur onestart
Amb el servidor en execució, podeu provar de connectar-s'hi. A Mumble, afegiu-lo com a servidor utilitzant el seu nom de domini o adreça IP i connecteu-vos. Si pots iniciar sessió i estàs visible al canal arrel, tot funciona. En cas contrari, comproveu l'adreça del servidor i el fitxer de configuració per si hi ha errors ortogràfics o errors, i assegureu-vos que l' murmurusuari pugui llegir la clau SSL si en configureu la vostra i torneu-ho a provar:
service murmur onerestart
Un cop hàgiu acabat, tanqueu el servidor perquè puguem provar l'inici a la secció següent:
service murmur onestop
Iniciant Murmur a l'arrencada
Si us podeu connectar al vostre nou servidor, ja esteu preparat per habilitar el servei, de manera que Murmur s'iniciarà automàticament quan reinicieu (després d'una actualització, per exemple).
Per fer-ho, editeu /etc/rc.conf:
ee /etc/rc.conf
Premeu CTRL+ E, seguit de ENTERper posar una línia en blanc a la segona línia del fitxer i escriviu:
murmur_enable="YES"
A continuació ESC, premeu , ENTER, ENTERper desar i sortir. Per provar la configuració, proveu l'ordre d'inici del servei habitual:
service murmur start
Si això no funciona, hi ha una errada d'ortografia a rc.conf. Torneu enrere i comproveu-ho.
Si funciona, no hi ha res a fer. Per provar-ho, reinicieu:
sync && reboot
Espereu uns segons perquè el servidor torni a començar fins que us pugueu connectar amb SSH i, a continuació, proveu de tornar a connectar-vos amb Mumble. Enhorabona, acabeu d'instal·lar i configurar Murmur des de zero.