Murmur è il software server ufficiale per il protocollo di comunicazione vocale Mumble. Questa implementazione ufficiale è stabile ed efficiente. Questa guida descriverà passo-passo il processo di installazione e configurazione di un server Murmur per la comunicazione con i client Mumble su FreeBSD 11.2.
Prerequisiti
- Qualsiasi VPS Vultr
- Un client SSH:
ssh
in un terminale per utenti Linux, Mac e Unix (incluso BSD)
- Il client PuTTY SSH per Windows
SSH sul server Vultr FreeBSD e accedi come root o come sudo
utente. Se si utilizza un sudo
utente, anteporre i comandi con sudo
:
home-desktop$ ssh [email protected]
Nota: sostituire 198.51.100.21
con il proprio indirizzo IP.
Installazione del pacchetto Murmur
Nota: In questa sezione verrà installato un server di vaniglia Murmur senza D-Bus
/ Bonjour
supporto.
Per aggiungere Murmur e le sue dipendenze al sistema, eseguire il comando seguente:
pkg install murmur
Dato che hai installato il software server dalla distribuzione binaria, puoi saltare la sezione successiva e procedere alla configurazione di Murmur .
Installazione da porte
Se hai seguito il resto della guida fino a questo punto e non vuoi abilitare D-Bus
o Bonjour
supportare o disabilitare il supporto Ice / MySQL / SQLite, segui invece la sezione precedente e poi passa a Configurare Murmur .
Ottenere l'albero dei porti
Esegui questo comando per verificare e scaricare eventuali aggiornamenti nella tua struttura delle porte (ne avrai bisogno se non hai ancora configurato le porte):
portsnap fetch
Se l'output termina con ' No updates needed
', è possibile saltare al passaggio successivo. Altrimenti, non hai preparato un albero delle porte aggiornato e dovrai estrarre l'istantanea appena scaricata:
portsnap extract
Creazione e installazione dell'applicazione server
Compilare il porto di Murmur è facile, ma richiederà del tempo. I seguenti comandi ti porteranno nella directory della porta, la costruiranno, installeranno i file generati e rimuoveranno i file non necessari dopo che sono stati creati:
cd /usr/ports/audio/murmur
make install clean
Durante le prime fasi dell'installazione, vedrai una o più finestre di dialogo di testo che chiedono informazioni sulle funzionalità che desideri abilitare o disabilitare. Per navigare nei menu, utilizzare le frecce UPe DOWNper evidenziare una voce, SPACEper attivare / disattivare lo stato della voce o ENTERper utilizzare l'azione predefinita. Per modificare l'azione predefinita (in genere su "Annulla"), utilizzare le frecce LEFTe RIGHT.
La finestra di dialogo di configurazione del soffio presenterà le opzioni per disabilitare Bonjour
, abilitare D-Bus
, abilitare Ice e disabilitare il supporto MySQL o SQLite. Ti consente anche di disabilitare la creazione della documentazione, ma questa è generalmente una cattiva idea.
Riepilogo delle opzioni di configurazione della build di Murmur
Il nome dell'opzione e le scelte del pacchetto ufficiale per quelle opzioni sono mostrate qui, se non sei sicuro di nessuna di esse.
-
Bonjour
è un protocollo per la scoperta di servizi di rete locale. A meno che tu non acceda al tuo server Murmur tramite una VPN o desideri che un altro VPS sulla stessa rete privata trovi automaticamente Murmur, va bene così disable
.
-
D-Bus
è un modo per le applicazioni, in genere sullo stesso computer, di comunicare tra loro. In Murmur, l'interfaccia D-Bus è obsoleta e dovrebbe essere lasciata disabled
, a meno che tu non sia sicuro di avere un'applicazione che richiede l'interfaccia D-Bus di Murmur.
-
Documentation
dovrebbe essere lasciato a enabled
meno che non si desideri specificamente che le pagine di manuale siano disponibili per te. Questa opzione non cambierà nulla dal punto di vista del cliente ed è rilevante solo per l'amministratore di sistema.
-
Ice
è un protocollo RPC più recente che consente di amministrare in remoto Murmur utilizzando mezzi alternativi come le interfacce Web. In enable
questo caso, puoi in seguito scegliere di configurare una soluzione RPC che ti permetterà di fare cose come la registrazione online degli utenti e la moderazione dei canali remoti. La configurazione RPC non verrà gestita in questa guida e di solito richiede un server Web con supporto PHP.
-
MySQL
è un sistema di gestione di database potente e scalabile. Questo dovrebbe essere lasciato disable
, a meno che se non si dispone di un database remoto che Murmur desidera utilizzare al posto di un file locale o se si prevede di avere molte migliaia di utenti. Questa guida non tratterà la configurazione di MySQL.
-
SQLite
è un'alternativa leggera a soluzioni di gestione di database più grandi come MySQL. Consente un rapido accesso a un database archiviato in un file locale per un massimo di centinaia di migliaia di record e, come tale, è abbastanza adatto per un server Murmur. Questo dovrebbe essere lasciato enabled
e la sezione di configurazione di questa guida supporrà che lo sia.
Quando si è soddisfatti di queste opzioni, l'uso LEFTe RIGHTquindi premere ENTERper selezionare OK
nella parte inferiore della finestra. Se ti viene presentata l'opzione per configurare le dipendenze, le impostazioni predefinite sono le opzioni più sicure, quindi puoi semplicemente premere ENTERper eliminarle con le opzioni predefinite selezionate. Dopo la configurazione, la costruzione di Murmur e le sue dipendenze (specialmente Boost) a volte possono richiedere molto tempo.
Configurazione di Murmur
Ci sono alcune cose che potresti voler modificare prima di avviare il tuo server per la prima volta. Questa sezione utilizzerà Easy Editor di FreeBSD, come l'editor di testo preferito, ma puoi usare qualsiasi altra cosa.
Apri il file di configurazione del soffio in un editor di testo:
ee /usr/local/etc/murmur.ini
La maggior parte della configurazione è spiegata nel file e viene impostata sui valori normali, ma toccheremo brevemente alcune importanti opzioni.
Nota: tutte le opzioni elencate di seguito hanno impostazioni predefinite. Non è necessario modificarli per l'esecuzione del server.
Testo di benvenuto (MOTD)
Una cosa che potresti voler cambiare è il testo di benvenuto, o come viene chiamato da alcuni, il "Messaggio del giorno". Per fare ciò, trova la riga che inizia con welcometext=
e sostituisci il messaggio esistente con qualcosa di nuovo. Mumble può visualizzare una selezione limitata di tag HTML, come <br />
per indicare una nuova riga:
welcometext="<br /> Check out this cool Vultr VPS! <br />"
Numero di porta
I client che si connettono devono specificare un numero di porta se il server non è in ascolto sulla porta predefinita. Se desideri cambiare questa porta in modo che i tuoi utenti debbano conoscerla per connettersi, usa l' port=
opzione. Altrimenti, lascialo sul valore predefinito in 64738
modo che i tuoi utenti debbano solo ricordare l'indirizzo:
port=443
Utenti massimi consentiti
Il massimo predefinito di 100 utenti è abbastanza ragionevole, ma se desideri limitare il server solo a te e ad alcuni amici, puoi abbassare questo massimo - o aumentarlo, ovviamente - con l' users
opzione:
users=5
Lunghezza del messaggio
Se devi inviare messaggi in chat di testo più lunghi di 5000 caratteri, ti consigliamo di modificare l' textmessagelimit
opzione. Puoi anche impostarlo su 0 per rimuovere completamente il limite:
textmessagelimit=12345
Ricorda di rimuovere il #
personaggio all'inizio della riga per decommentarlo, altrimenti la linea non avrà effetto.
Dimensione dell'immagine
Questa opzione si trova proprio sotto l'opzione della lunghezza del messaggio, se stai commentando le righe dal file di configurazione predefinito. Con il limite predefinito della dimensione dell'immagine di 128 kilobyte, potresti avere difficoltà a inviare immagini. Consiglierei di alzare questo valore, ma non a un valore così alto che qualcuno potrebbe inviare un'immagine abbastanza grande da rallentare la connessione di tutti gli utenti con connessioni Internet a larghezza di banda inferiore. Come l'ultima opzione, puoi impostare il valore di questo su 0 per consentire immagini di qualsiasi dimensione. Naturalmente, questa è solo una buona idea quando sai che la connessione di tutti può gestirla:
# 768KiB:
imagemessagelength=786432
Non dimenticare di rimuovere anche il #
personaggio all'inizio di questa riga.
Crittografia SSL / TLS
Se si dispone di una chiave TLS e di un certificato adeguati, è possibile specificarli qui. In caso contrario, Murmur genererà i propri e li presenterà, il che potrebbe causare errori di certificazione per i tuoi utenti.
Ad esempio, per Let's Encrypt impostato in /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
Avvio di Murmur per la prima volta
Ora che il tuo server è installato e configurato, non resta altro da fare che testarlo. Poiché il servizio non è ancora 'abilitato', il normale comando 'start' non verrà eseguito. Quindi, per avviare il server una volta, eseguire quanto segue:
service murmur onestart
Con il server in esecuzione, puoi provare a connetterti ad esso. In Mumble, aggiungilo come server usando il suo nome di dominio o indirizzo IP e connettiti. Se riesci ad accedere e sei visibile nel canale principale, tutto funziona. In caso contrario, controlla l'indirizzo del server e il file di configurazione per errori di battitura o errori e assicurati che l' murmur
utente possa leggere la chiave SSL se hai impostato la tua e riprovare:
service murmur onerestart
Al termine, arrestare il server per consentirci di testarlo avviandolo nella sezione successiva:
service murmur onestop
Avvio di Murmur all'avvio
Se riesci a connetterti al tuo nuovo server, sei pronto per abilitare il servizio in modo che Murmur si avvierà automaticamente al riavvio (dopo un aggiornamento, ad esempio).
Per fare ciò, modifica /etc/rc.conf
:
ee /etc/rc.conf
Premere CTRL+ E, seguito da ENTERper inserire una riga vuota sulla seconda riga del file e digitare:
murmur_enable="YES"
Poi stampa ESC, ENTER, ENTERper salvare e uscire. Per verificare la configurazione, provare il comando di avvio del servizio normale:
service murmur start
Se questo non funziona, c'è un errore di battitura rc.conf
. torna indietro e ricontrolla.
Se funziona, non c'è più niente da fare. Per provarlo, riavvia:
sync && reboot
Attendere qualche secondo per riavviare il server fino a quando non è possibile connettersi con SSH, quindi provare a riconnettersi con Mumble. Congratulazioni, hai appena installato e configurato Murmur da zero.