Nastavení a konfigurace Murmur (Mumble Server) na FreeBSD 11

Murmur je oficiální serverový software pro protokol hlasové komunikace Mumble. Tato oficiální implementace je stabilní a efektivní. Tato příručka popisuje krok za krokem proces instalace a konfigurace serveru Murmur pro komunikaci s klienty Mumble na FreeBSD 11.2.

Předpoklady

• Jakýkoli Vultr VPS
• Klient SSH:
  • ssh v terminálu pro uživatele Linux, Mac a Unix (včetně BSD).
  • Klient PuTTY SSH pro Windows

SSH na váš server Vultr FreeBSD a přihlaste se jako root nebo jako sudouživatel. Pokud používáte sudouživatele, přidejte před příkazy sudo:

home-desktop$ ssh [email protected]

Poznámka: Nahraďte 198.51.100.21svou vlastní IP adresou.

Instalace balíčku Murmur

Poznámka: Tato část nainstaluje server vanilla Murmur bez podpory D-Bus/ Bonjour.

Chcete-li přidat Murmur a jeho závislosti do systému, spusťte následující příkaz:

pkg install murmur

Protože jste nainstalovali serverový software z binární distribuce, můžete přeskočit další část a přejít na Konfigurace Murmur .

Instalace z portů

Pokud jste se až do tohoto bodu řídili zbytkem příručky a nechcete povolit D-Busnebo Bonjourpodporovat nebo deaktivovat podporu Ice/MySQL/SQLite, můžete místo toho postupovat podle předchozí části a poté přeskočit na Konfigurace Murmur .

Získání stromu portů

Spuštěním tohoto příkazu zkontrolujete a stáhnete aktualizace do stromu portů (budete je potřebovat, pokud ještě nemáte nastavení portů):

portsnap fetch

Pokud výstup končí „ No updates needed“, můžete přeskočit k dalšímu kroku. V opačném případě nemáte připravený aktuální strom portů a budete muset extrahovat nově stažený snímek:

portsnap extract

Vytvoření a instalace serverové aplikace

Kompilace portu Murmur je snadná, ale nějakou dobu zabere. Následující příkazy vás přesunou do adresáře portu, vytvoří jej, nainstalují vygenerované soubory a odstraní nepotřebné soubory po jejich vytvoření:

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

Během prvních částí instalace uvidíte jeden nebo více textových dialogů s dotazem na funkce, které chcete povolit nebo zakázat. Chcete-li se pohybovat v nabídkách, použijte šipky UPa DOWNke zvýraznění položky, SPACEk přepínání stavu položky povoleno/deaktivováno nebo ENTERk použití výchozí akce. Chcete-li změnit výchozí akci (obvykle na „Zrušit“), použijte šipky LEFTa RIGHT.

Dialogové okno konfigurace šumu zobrazí možnosti pro zakázání Bonjour, povolení D-Bus, povolení Ice a zakázání podpory MySQL nebo SQLite. Umožňuje také zakázat vytváření dokumentace, ale to je obecně špatný nápad.

Souhrn možností konfigurace sestavení Murmur

Pokud si s některou z nich nejste jisti, je zde uveden název možnosti a možnosti oficiálního balíčku pro tyto možnosti.

• Bonjourje protokol pro zjišťování místních síťových služeb. Pokud nebudete ke svému serveru Murmur přistupovat přes VPN nebo nechcete, aby jiný VPS ve stejné soukromé síti našel Murmur automaticky, je to v pořádku disable.

• D-Busje způsob, jakým spolu aplikace, obvykle na stejném počítači, komunikují. V Murmuru je rozhraní D-Bus zastaralé a mělo by být ponecháno disabled, pokud si nejste jisti, že máte aplikaci, která vyžaduje rozhraní D-Bus Murmur.

• Documentationby měl být ponechán, enabledpokud si výslovně nepřejete, aby vám byly manuálové stránky k dispozici. Tato volba nemění nic z pohledu klienta a je relevantní pouze pro správce systému.

• Iceje novější protokol RPC, který vám umožňuje vzdáleně spravovat Murmur pomocí alternativních prostředků, jako jsou webová rozhraní. Pokud to uděláte enable, můžete se později rozhodnout nakonfigurovat řešení RPC, které vám umožní dělat věci, jako je online registrace uživatele a vzdálené moderování kanálu. Konfigurace RPC nebude v této příručce řešena a obvykle vyžaduje webový server s podporou PHP.

• MySQLje výkonný, škálovatelný systém správy databází. Toto by mělo být ponecháno disable, pokud nemáte vzdálenou databázi, kterou chcete, aby Murmur používal místo lokálního souboru, nebo pokud neplánujete mít mnoho tisíc uživatelů. Tato příručka se nebude zabývat konfigurací MySQL.

• SQLiteje odlehčenou alternativou k řešením pro správu větších databází, jako je MySQL. Umožňuje rychlý přístup k databázi uložené v lokálním souboru až pro stovky tisíc záznamů a jako takový je docela vhodný pro server Murmur. Toto by mělo být ponecháno enableda část konfigurace této příručky bude předpokládat, že ano.

Když jste s těmito možnostmi spokojeni, použijte LEFTa RIGHTa poté stisknutím tlačítka v dolní části okna ENTERvyberte OK. Pokud se vám zobrazí možnost konfigurovat závislosti, výchozí hodnoty jsou nejbezpečnější možnosti, takže je můžete ENTERs vybranými výchozími možnostmi jednoduše zrušit stisknutím . Po konfiguraci může sestavení Murmuru a jeho závislostí (zejména Boost) někdy trvat velmi dlouho.

Konfigurace Murmur

Před prvním spuštěním serveru můžete chtít vyladit některé věci. Tato sekce bude používat jako preferovaný textový editor FreeBSD's Easy Editor, ale místo něj můžete použít cokoliv jiného.

Otevřete konfigurační soubor murmur v textovém editoru:

ee /usr/local/etc/murmur.ini

Většina konfigurace je vysvětlena v souboru a výchozí hodnoty jsou normální, ale krátce se dotkneme několika důležitých možností.

Poznámka: Všechny níže uvedené možnosti mají výchozí hodnoty. Pro běh serveru je nemusíte měnit.

Uvítací text (MOTD)

Jedna věc, kterou možná budete chtít změnit, je uvítací text, nebo jak to někteří nazývají, „Poselství dne“. Chcete-li to provést, najděte řádek začínající welcometext=a nahraďte stávající zprávu něčím novým. Mumble může zobrazit omezený výběr značek HTML, jako <br />je označení nového řádku:

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

Číslo portu

Připojující se klienti musí zadat číslo portu, pokud server nenaslouchá na výchozím portu. Pokud chcete změnit tento port, aby jej uživatelé museli znát, aby se mohli připojit, použijte tuto port=možnost. V opačném případě ponechte výchozí hodnotu, 64738takže vaši uživatelé si budou muset pamatovat pouze adresu:

port=443

Maximální povolený počet uživatelů

Výchozí maximum 100 uživatelů je docela rozumné, ale pokud byste chtěli server omezit pouze na vás a několik přátel, můžete toto maximum snížit – nebo ho samozřejmě zvýšit – pomocí usersmožnosti:

users=5

Délka zprávy

Pokud potřebujete posílat zprávy v textovém chatu delší než 5000 znaků, budete chtít tuto textmessagelimitmožnost změnit . Můžete také nastavit na 0, abyste limit úplně odstranili:

textmessagelimit=12345

Nezapomeňte odstranit #znak na začátku řádku, abyste jej odkomentovali, jinak řádek nebude platit.

Velikost obrázku

Tato možnost je přímo pod možností délky zprávy, pokud odstraňujete komentáře z výchozího konfiguračního souboru. Při výchozím limitu velikosti obrázku 128 kilobajtů můžete mít potíže s odesíláním obrázků. Doporučil bych to zvýšit, ale ne na tak vysokou hodnotu, aby někdo mohl poslat dostatečně velký obrázek, aby zpomalil připojení všech uživatelů s připojením k internetu s nižší šířkou pásma. Stejně jako u poslední možnosti můžete nastavit hodnotu této na 0, abyste povolili obrázky libovolné velikosti. Samozřejmě je to dobrý nápad jen tehdy, když víte, že připojení každého to zvládne:

# 768KiB:
imagemessagelength=786432

Nezapomeňte také odstranit #postavu na začátku tohoto řádku.

SSL/TLS šifrování

Pokud máte správný klíč a certifikát TLS, můžete je zadat zde. Pokud tak neučiníte, Murmur vygeneruje své vlastní a předloží je, což může způsobit chyby certifikátu pro vaše uživatele.

Například pro Let's Encrypt, který 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

Poprvé spouštím Murmur

Nyní, když je váš server nainstalován a nakonfigurován, nezbývá nic jiného, ​​než jej otestovat. Protože služba ještě není „povolená“, běžný příkaz „start“ se nespustí. Chcete-li tedy server spustit jednou, spusťte následující:

service murmur onestart

Se spuštěným serverem se k němu můžete pokusit připojit. V Mumble jej přidejte jako server pomocí názvu domény nebo IP adresy a připojte se. Pokud se můžete přihlásit a jste viditelní v kořenovém kanálu, vše funguje. Pokud ne, zkontrolujte adresu serveru a konfigurační soubor, zda neobsahují překlepy nebo chyby, a ujistěte se, že murmuruživatel může číst klíč SSL, pokud jste nastavili svůj vlastní, a zkuste to znovu:

service murmur onerestart

Až budete hotovi, vypněte server, abychom mohli vyzkoušet jeho spuštění v další části:

service murmur onestop

Spuštění Murmur při startu

Pokud se můžete připojit ke svému novému serveru, jste připraveni povolit službu, aby se Murmur automaticky spustil po restartu (například po upgradu).

Chcete-li tak učinit, upravte /etc/rc.conf:

ee /etc/rc.conf

Stiskněte CTRL+ Ea poté ENTERvložte prázdný řádek na druhý řádek souboru a napište:

murmur_enable="YES"

Poté stiskněte ESC, ENTER, ENTERpro uložení a ukončení. Chcete-li otestovat konfiguraci, vyzkoušejte příkaz spuštění běžné služby:

service murmur start

Pokud to nefunguje, je v ní překlep rc.conf. vraťte se a znovu to zkontrolujte.

Pokud to funguje, pak už není co dělat. Chcete-li to otestovat, restartujte:

sync && reboot

Počkejte několik sekund, než se server znovu spustí, dokud se nebudete moci připojit pomocí SSH, a poté se zkuste znovu připojit pomocí Mumble. Gratulujeme, právě jste nainstalovali a nakonfigurovali Murmur od začátku.