Ställ in och konfigurera Murmur (Mumble Server) på FreeBSD 11

Murmur är den officiella servermjukvaran för Mumbles röstkommunikationsprotokoll. Denna officiella implementering är stabil och effektiv. Denna guide kommer att beskriva steg-för-steg processen för att installera och konfigurera en Murmur-server för kommunikation med Mumble-klienter på FreeBSD 11.2.

Förutsättningar

• Vilken Vultr VPS som helst
• En SSH-klient:
  • ssh i en terminal för Linux-, Mac- och Unix- (inklusive BSD)-användare
  • Den PuTTY SSH-klient för Windows

SSH till din Vultr FreeBSD-server och logga in som root eller som sudoanvändare. Om du använder en sudoanvändare, lägg kommandon i förväg med sudo:

home-desktop$ ssh [email protected]

Obs: Ersätt 198.51.100.21med din egen IP-adress.

Installerar Murmur-paketet

Obs: Det här avsnittet kommer att installera en vanilla Murmur-server utan D-Bus/ Bonjour-stöd.

För att lägga till Murmur och dess beroenden till systemet, kör följande kommando:

pkg install murmur

Eftersom du har installerat serverprogramvaran från den binära distributionen kan du hoppa över nästa avsnitt och fortsätta till Konfigurera Murmur .

Installerar från portar

Om du har följt resten av guiden fram till denna punkt, och du inte vill aktivera D-Buseller Bonjourstödja, eller inaktivera Ice/MySQL/SQLite-stöd, följ gärna föregående avsnitt istället och hoppa sedan till Konfigurera Murmur .

Hämta ports-trädet

Kör det här kommandot för att söka efter och ladda ner eventuella uppdateringar till ditt portträd (du behöver detta om du inte har konfigurerat portar ännu):

portsnap fetch

Om utgången slutar med ' No updates needed' kan du hoppa till nästa steg. Annars har du inte ett uppdaterat portträd förberett och kommer att behöva extrahera den nyligen nedladdade ögonblicksbilden:

portsnap extract

Bygga och installera serverapplikationen

Att kompilera Murmur-porten är enkelt, men kommer att ta lite tid. Följande kommandon kommer att placera dig i portens katalog, bygga den, installera de genererade filerna och ta bort onödiga filer efter att de har byggts:

cd /usr/ports/audio/murmur
make install clean

Under de tidiga delarna av installationen kommer du att se en eller flera textdialoger som frågar om funktioner du vill aktivera eller inaktivera. För att navigera i menyerna, använd UPoch DOWNför att markera en post SPACEför att växla postens aktiveras / avaktiveras status, eller ENTERför att använda standardåtgärden. Om du vill ändra standardåtgärden (vanligtvis 'Avbryt'), använd LEFToch RIGHTpilar.

Fönstret för konfigurering av brus visar alternativen för att inaktivera Bonjour, aktivera D-Bus, aktivera Ice och inaktivera MySQL- eller SQLite-stöd. Det låter dig också inaktivera att bygga dokumentationen, men detta är i allmänhet en dålig idé.

Sammanfattning av Murmur build-konfigurationsalternativ

Namnet på alternativet och det officiella paketets val för dessa alternativ visas här, om du är osäker på något av dem.

• Bonjourär ett protokoll för upptäckt av lokala nätverkstjänster. Såvida du inte kommer åt din Murmur-server via ett VPN, eller om du vill att en annan VPS på samma privata nätverk ska hitta Murmur automatiskt, är det okej att disable.

• D-Busär ett sätt för applikationer, vanligtvis på samma maskin, att kommunicera med varandra. I Murmur är D-Bus-gränssnittet föråldrat och bör lämnas disabled, såvida du inte är säker på att du har ett program som kräver Murmurs D-Bus-gränssnitt.

• Documentationbör lämnas enabledom du inte specifikt vill att manualsidorna ska vara tillgängliga för dig. Det här alternativet kommer inte att ändra något ur klientens synvinkel och är endast relevant för systemadministratören.

• Iceär ett nyare RPC-protokoll som låter dig administrera Murmur på distans med hjälp av alternativa metoder som webbgränssnitt. Om du gör enabledetta kan du senare välja att konfigurera en RPC-lösning som låter dig göra saker som onlineanvändarregistrering och fjärrkanalmoderering. RPC-konfiguration kommer inte att hanteras i den här guiden och kräver vanligtvis en webbserver med PHP-stöd.

• MySQLär ett kraftfullt, skalbart databashanteringssystem. Detta bör lämnas disableom du inte har en fjärrdatabas som du vill att Murmur ska använda istället för en lokal fil, eller om du planerar att ha många tusentals användare. Den här guiden kommer inte att täcka MySQL-konfiguration.

• SQLiteär ett lättviktigt alternativ till större databashanteringslösningar som MySQL. Det ger snabb åtkomst till en databas lagrad i en lokal fil för upp till hundratusentals poster, och är som sådan ganska lämplig för en Murmur-server. Detta bör lämnas enabled, och konfigurationsavsnittet i den här guiden antar att det är det.

När du är nöjd med dessa alternativ, använd LEFToch RIGHToch tryck sedan för ENTERatt välja OKlängst ned i fönstret. Om du presenteras med alternativet att konfigurera beroenden är standardinställningarna de säkraste alternativen, så du kan bara trycka på för ENTERatt avvisa dem med deras standardalternativ valda. Efter konfiguration kan det ibland ta väldigt lång tid att bygga Murmur och dess beroenden (särskilt Boost).

Konfigurera Murmur

Det finns några saker du kanske vill justera innan du startar din server för första gången. Det här avsnittet kommer att använda FreeBSDs Easy Editor, som den föredragna textredigeraren, men du kan använda vad som helst annat istället.

Öppna murmur-konfigurationsfilen i en textredigerare:

ee /usr/local/etc/murmur.ini

Det mesta av konfigurationen förklaras i filen, och standardvärdena är normala, men vi kommer kort att peka på några viktiga alternativ.

Obs: Alla alternativ som listas nedan har standardinställningar. Du behöver inte ändra dem för att servern ska köras.

Välkomsttext (MOTD)

En sak du kanske vill ändra på är välkomsttexten, eller som det kallas av vissa, "Dagens meddelande". För att göra det, hitta raden som börjar med welcometext=och ersätt det befintliga meddelandet med något nytt. Mumble kan visa ett begränsat urval av HTML-taggar, som <br />att beteckna en ny rad:

welcometext="<br /> Check out this cool Vultr VPS! <br />"

Portnummer

Klienter som ansluter måste ange ett portnummer om servern inte lyssnar på standardporten. Om du vill ändra den här porten så att dina användare måste känna till den för att kunna ansluta, använd port=alternativet. Annars lämnar du det som standard 64738så att dina användare bara behöver komma ihåg adressen:

port=443

Maximalt tillåtna användare

Standardmaxvärdet på 100 användare är ganska rimligt, men om du vill begränsa servern till bara dig och några vänner kan du sänka det här maxvärdet - eller höja det, naturligtvis - med usersalternativet:

users=5

Meddelandets längd

Om du behöver skicka meddelanden i textchatt längre än 5000 tecken, vill du ändra textmessagelimitalternativet. Du kan också ställa in den till 0 för att ta bort gränsen helt:

textmessagelimit=12345

Kom ihåg att ta bort #tecknet i början av raden för att avkommentera det, annars träder raden inte i kraft.

Bildstorlek

Det här alternativet ligger precis under alternativet för meddelandelängd, om du avkommentar rader från standardkonfigurationsfilen. Med den förinställda bildstorleksgränsen på 128 kilobyte kanske du har svårt att skicka bilder. Jag skulle rekommendera att höja detta, men inte till ett så högt värde att någon skulle kunna skicka en tillräckligt stor bild för att bromsa anslutningen för alla användare med internetanslutningar med lägre bandbredd. Precis som det sista alternativet kan du ställa in värdet på denna till 0 för att tillåta bilder av alla storlekar. Naturligtvis är detta bara en bra idé när du vet att allas anslutning kan hantera det:

# 768KiB:
imagemessagelength=786432

Glöm inte att ta bort #karaktären i början av den här raden också.

SSL/TLS-kryptering

Om du har en korrekt TLS-nyckel och certifikat kan du ange dem här. Om du inte gör det kommer Murmur att skapa sina egna och presentera dem, vilket kan orsaka certifikatfel för dina användare.

Till exempel, för en Let's Encrypt som är inställd i /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

Startar Murmur för första gången

Nu när din server är installerad och konfigurerad finns det inte mycket kvar att göra än att testa den. Eftersom tjänsten ännu inte är "aktiverad" kommer det vanliga "start"-kommandot inte att köras. Så för att starta servern en gång, kör följande:

service murmur onestart

Med servern igång kan du försöka ansluta till den. I Mumble, lägg till den som en server med dess domännamn eller IP-adress och anslut. Om du kan logga in, och är synlig i rotkanalen, fungerar allt. Om inte, kontrollera serveradressen och konfigurationsfilen för stavfel eller fel, och se till att murmuranvändaren kan läsa SSL-nyckeln om du ställer in din egen, och försök igen:

service murmur onerestart

När du är klar, stäng av servern för att vi kan testa att starta den i nästa avsnitt:

service murmur onestop

Börjar sorl vid start

Om du kan ansluta till din nya server är du redo att aktivera tjänsten så att Murmur startar automatiskt när du startar om (till exempel efter en uppgradering).

För att göra det, redigera /etc/rc.conf:

ee /etc/rc.conf

Tryck på CTRL+ Eföljt av för ENTERatt sätta en tom rad på den andra raden i filen och skriv:

murmur_enable="YES"

Tryck sedan på ESC, ENTER, för ENTERatt spara och avsluta. För att testa konfigurationen, prova det vanliga servicestartkommandot:

service murmur start

Om detta inte fungerar finns det ett stavfel i rc.conf. gå tillbaka och dubbelkolla det.

Om det fungerar så finns det inget kvar att göra. För att testa det, starta om:

sync && reboot

Vänta några sekunder tills servern startar igen tills du kan ansluta till SSH, försök sedan återansluta med Mumble. Grattis, du har precis installerat och konfigurerat Murmur från början.