Nastavte a nakonfigurujte Murmur (Mumble Server) na FreeBSD 11

Murmur je oficiálny serverový softvér pre protokol hlasovej komunikácie Mumble. Táto oficiálna implementácia je stabilná a efektívna. Táto príručka popisuje krok za krokom proces inštalácie a konfigurácie servera Murmur na komunikáciu s klientmi Mumble na FreeBSD 11.2.

Predpoklady

• Akýkoľvek Vultr VPS
• Klient SSH:
  • ssh v termináli pre používateľov systémov Linux, Mac a Unix (vrátane BSD).
  • PuTTY SSH klient pre Windows

SSH na váš server Vultr FreeBSD a prihláste sa ako root alebo ako sudopoužívateľ. Ak používate sudopoužívateľa, pred príkazy pridajte sudo:

home-desktop$ ssh [email protected]

Poznámka: Nahraďte 198.51.100.21svojou vlastnou IP adresou.

Inštalácia balíka Murmur

Poznámka: Táto sekcia nainštaluje vanilla Murmur server bez podpory D-Bus/ Bonjour.

Ak chcete pridať Murmur a jeho závislosti do systému, spustite nasledujúci príkaz:

pkg install murmur

Keďže ste nainštalovali serverový softvér z binárnej distribúcie, môžete preskočiť nasledujúcu časť a prejsť na Konfiguráciu Murmur .

Inštalácia z portov

Ak ste sledovali zvyšok príručky až do tohto bodu, a nechcete povoliť D-Busalebo Bonjourpodporu, alebo zakázať Ice support / MySQL / SQLite, neváhajte a namiesto toho sledovať v predchádzajúcej časti a potom prejdite na Konfigurácia Murmur .

Získanie stromu portov

Spustite tento príkaz, aby ste skontrolovali a stiahli všetky aktualizácie do stromu portov (budete to potrebovať, ak ešte nemáte nastavené porty):

portsnap fetch

Ak výstup končí znakom „ No updates needed“, môžete prejsť na ďalší krok. V opačnom prípade nemáte pripravený aktuálny strom portov a budete musieť extrahovať novo stiahnutú snímku:

portsnap extract

Vytvorenie a inštalácia serverovej aplikácie

Kompilácia Murmur portu je jednoduchá, ale bude nejaký čas trvať. Nasledujúce príkazy vás umiestnia do adresára portu, zostavia ho, nainštalujú vygenerované súbory a odstránia nepotrebné súbory po ich vytvorení:

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

Počas prvých častí inštalácie uvidíte jedno alebo viacero textových dialógových okien s otázkami na funkcie, ktoré by ste chceli povoliť alebo zakázať. Pre navigáciu v menu použite UPa DOWNšípok vyberte požadovanú položku, SPACEmôžete prepínať stav aktivácia / deaktivácia tejto položky, alebo ENTERpoužiť predvolenú akciu. Ak chcete zmeniť predvolenú akciu (zvyčajne na „Zrušiť“), použite šípky LEFTa RIGHT.

Dialógové okno konfigurácie šumu zobrazí možnosti na vypnutie Bonjour, povolenie D-Bus, povolenie Ice a zakázanie podpory MySQL alebo SQLite. Umožňuje vám tiež zakázať vytváranie dokumentácie, ale vo všeobecnosti je to zlý nápad.

Súhrn možností konfigurácie zostavy Murmur

Ak si nie ste istí niektorou z nich, zobrazí sa tu názov možnosti a možnosti oficiálneho balíka pre tieto možnosti.

• Bonjourje protokol na zisťovanie lokálnych sieťových služieb. Pokiaľ nebudete pristupovať k svojmu serveru Murmur cez VPN alebo ak nechcete, aby iný VPS v tej istej súkromnej sieti našiel Murmur automaticky, je to v poriadku disable.

• D-Busje spôsob, akým môžu aplikácie, zvyčajne na tom istom počítači, medzi sebou komunikovať. V Murmur je rozhranie D-Bus zastarané a malo by byť ponechané disabled, pokiaľ si nie ste istí, že máte aplikáciu, ktorá vyžaduje rozhranie Murmur D-Bus.

• Documentationby ste mali ponechať, enabledpokiaľ špecificky nechcete, aby vám boli k dispozícii manuálové stránky. Táto možnosť z pohľadu klienta nič nezmení a je relevantná iba pre správcu systému.

• Iceje novší protokol RPC, ktorý vám umožňuje vzdialene spravovať Murmur pomocou alternatívnych prostriedkov, ako sú webové rozhrania. Ak to urobíte enable, môžete sa neskôr rozhodnúť nakonfigurovať riešenie RPC, ktoré vám umožní robiť veci, ako je registrácia používateľov online a moderovanie vzdialeného kanála. Konfigurácia RPC sa v tejto príručke nebude zaoberať a zvyčajne vyžaduje webový server s podporou PHP.

• MySQLje výkonný, škálovateľný systém správy databáz. Toto by malo byť ponechané disable, pokiaľ nemáte vzdialenú databázu, ktorú by ste chceli, aby Murmur používal namiesto lokálneho súboru, alebo ak neplánujete mať mnoho tisíc používateľov. Táto príručka sa nebude týkať konfigurácie MySQL.

• SQLiteje odľahčenou alternatívou k väčším riešeniam správy databáz, ako je MySQL. Umožňuje rýchly prístup k databáze uloženej v lokálnom súbore až pre stovky tisíc záznamov a ako taký je celkom vhodný pre server Murmur. Toto by malo byť ponechané enableda časť o konfigurácii tejto príručky bude predpokladať, že áno.

Keď ste s týmito možnosťami spokojní, použite LEFTa RIGHTa potom stlačením ENTERvyberte OKv spodnej časti okna. Ak sa vám zobrazí možnosť konfigurovať závislosti, predvolené hodnoty sú najbezpečnejšie možnosti, takže ich môžete jednoducho stlačiť ENTERa zatvoriť s vybratými predvolenými možnosťami. Po konfigurácii môže vytvorenie Murmuru a jeho závislostí (najmä Boost) niekedy trvať veľmi dlho.

Konfigurácia Murmur

Pred prvým spustením servera možno budete chcieť vyladiť niektoré veci. Táto sekcia bude používať Easy Editor FreeBSD ako preferovaný textový editor, ale namiesto toho môžete použiť čokoľvek iné.

Otvorte konfiguračný súbor murmur v textovom editore:

ee /usr/local/etc/murmur.ini

Väčšina konfigurácií je vysvetlená v súbore a predvolene sú nastavené na normálne hodnoty, ale krátko sa dotkneme niekoľkých dôležitých možností.

Poznámka: Všetky možnosti uvedené nižšie majú predvolené hodnoty. Aby server fungoval, nemusíte ich meniť.

Uvítací text (MOTD)

Jedna vec, ktorú možno budete chcieť zmeniť, je uvítací text, alebo ako ho niektorí nazývajú, „Posolstvo dňa“. Ak to chcete urobiť, nájdite riadok začínajúci na welcometext=a nahraďte existujúcu správu niečím novým. Mumble môže zobraziť obmedzený výber značiek HTML, napríklad <br />na označenie nového riadku:

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

Číslo portu

Klienti, ktorí sa pripájajú, musia zadať číslo portu, ak server nepočúva na predvolenom porte. Ak chcete zmeniť tento port, aby ho vaši používatelia museli poznať na pripojenie, použite túto port=možnosť. V opačnom prípade ponechajte predvolenú hodnotu, 64738takže vaši používatelia si budú musieť pamätať iba adresu:

port=443

Maximálny povolený počet používateľov

Predvolené maximum 100 používateľov je celkom rozumné, ale ak chcete server obmedziť len na vás a niekoľko priateľov, môžete toto maximum znížiť – alebo ho samozrejme zvýšiť – pomocou usersmožnosti:

users=5

Dĺžka správy

Ak potrebujete posielať správy v textovom rozhovore dlhšie ako 5 000 znakov, budete chcieť túto textmessagelimitmožnosť zmeniť . Môžete ho tiež nastaviť na 0, aby ste limit úplne odstránili:

textmessagelimit=12345

Nezabudnite odstrániť #znak na začiatku riadku, aby ste ho odkomentovali, inak riadok nebude účinný.

Veľkosť obrazu

Táto možnosť je hneď pod možnosťou dĺžky správy, ak rušíte komentáre z predvoleného konfiguračného súboru. Pri predvolenom limite veľkosti obrázka 128 kilobajtov môžete mať problémy s odosielaním obrázkov. Odporúčam to zvýšiť, ale nie na takú vysokú hodnotu, aby niekto mohol poslať dostatočne veľký obrázok na spomalenie pripojenia všetkých používateľov s internetovým pripojením s nižšou šírkou pásma. Rovnako ako pri poslednej možnosti môžete nastaviť hodnotu tejto na 0, aby ste povolili obrázky ľubovoľnej veľkosti. Samozrejme, je to dobrý nápad len vtedy, keď viete, že pripojenie každého z vás to zvládne:

# 768KiB:
imagemessagelength=786432

Nezabudnite tiež odstrániť #znak na začiatku tohto riadku.

Šifrovanie SSL/TLS

Ak máte správny kľúč a certifikát TLS, môžete ich zadať tu. Ak tak neurobíte, Murmur vygeneruje svoje vlastné a predloží ich, čo môže spôsobiť chyby certifikátov pre vašich používateľov.

Napríklad pre Let's Encrypt, ktorý je nastavený v /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

Spustenie Murmur prvýkrát

Teraz, keď je váš server nainštalovaný a nakonfigurovaný, nezostáva veľa práce, len ho otestovať. Keďže služba ešte nie je „povolená“, bežný príkaz „štart“ sa nespustí. Ak teda chcete spustiť server raz, spustite nasledujúce:

service murmur onestart

Keď je server spustený, môžete sa k nemu pokúsiť pripojiť. V Mumble ho pridajte ako server pomocou názvu domény alebo IP adresy a pripojte sa. Ak sa môžete prihlásiť a ste viditeľní v koreňovom kanáli, všetko funguje. Ak nie, skontrolujte adresu servera a konfiguračný súbor pre preklepy alebo chyby a uistite sa, že murmurpoužívateľ dokáže prečítať kľúč SSL, ak ste nastavili svoj vlastný, a skúste to znova:

service murmur onerestart

Po dokončení vypnite server, aby sme ho mohli otestovať v ďalšej časti:

service murmur onestop

Spustenie Murmur pri štarte

Ak sa môžete pripojiť k svojmu novému serveru, ste pripravení povoliť službu, takže Murmur sa automaticky spustí po reštarte (napríklad po inovácii).

Ak to chcete urobiť, upravte /etc/rc.conf:

ee /etc/rc.conf

Stlačte CTRL+ Ea potom ENTERvložte prázdny riadok do druhého riadku súboru a zadajte:

murmur_enable="YES"

Potom stlačte ESC, ENTER, ENTERpre uloženie a ukončenie. Ak chcete otestovať konfiguráciu, vyskúšajte bežný príkaz na spustenie služby:

service murmur start

Ak to nefunguje, je tam preklep rc.conf. vráťte sa a znova to skontrolujte.

Ak to funguje, potom už nie je čo robiť. Ak to chcete otestovať, reštartujte:

sync && reboot

Počkajte niekoľko sekúnd, kým sa server znova spustí, kým sa nebudete môcť pripojiť pomocou SSH, a potom sa skúste znova pripojiť pomocou Mumble. Gratulujeme, práve ste nainštalovali a nakonfigurovali Murmur od začiatku.