Opsæt og konfigurer Murmur (Mumble Server) på FreeBSD 11

Murmur er den officielle serversoftware til Mumble stemmekommunikationsprotokollen. Denne officielle implementering er stabil og effektiv. Denne guide vil beskrive trin-for-trin processen med at installere og konfigurere en Murmur-server til kommunikation med Mumble-klienter på FreeBSD 11.2.

Forudsætninger

• Enhver Vultr VPS
• En SSH-klient:
  • ssh i en terminal til Linux-, Mac- og Unix-brugere (inklusive BSD).
  • Den PuTTY SSH klient til Windows

SSH til din Vultr FreeBSD-server og log ind som root eller som sudobruger. Hvis du bruger en sudobruger, skal du sætte kommandoer foran med sudo:

home-desktop$ ssh [email protected]

Bemærk: Erstat 198.51.100.21med din egen IP-adresse.

Installation af Murmur-pakken

Bemærk: Denne sektion vil installere en vanilla Murmur-server uden D-Bus/ Bonjourunderstøttelse.

For at tilføje Murmur og dets afhængigheder til systemet skal du køre følgende kommando:

pkg install murmur

Da du har installeret serversoftwaren fra den binære distribution, kan du springe næste afsnit over og fortsætte til Konfiguration af murmur .

Installation fra porte

Hvis du har fulgt resten af ​​guiden indtil dette punkt, og du ikke vil aktivere D-Buseller Bonjourunderstøtte eller deaktivere Ice/MySQL/SQLite-understøttelse, er du velkommen til at følge det forrige afsnit i stedet for og derefter springe til Konfiguration af murmur .

Henter havnetræet

Kør denne kommando for at søge efter og downloade eventuelle opdateringer til dit ports-træ (du skal bruge dette, hvis du ikke har ports-opsætning endnu):

portsnap fetch

Hvis output slutter med ' No updates needed', kan du springe til næste trin. Ellers har du ikke forberedt et opdateret porttræ, og du bliver nødt til at udtrække det nyligt downloadede snapshot:

portsnap extract

Opbygning og installation af serverapplikationen

Det er nemt at kompilere Murmur-porten, men det vil tage noget tid. Følgende kommandoer vil placere dig i portens bibliotek, bygge den, installere de genererede filer og fjerne unødvendige filer, efter at de er bygget:

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

Under de tidlige dele af installationen vil du se en eller flere tekstdialogbokse, der spørger om funktioner, du gerne vil aktivere eller deaktivere. For at navigere i menuerne, skal du bruge UPog DOWNpilene til at fremhæve en post, SPACEfor at skifte oplysningens aktiveret / deaktiveret status, eller ENTERat bruge standard handling. Brug pilene LEFTog for at ændre standardhandlingen (normalt til 'Annuller') RIGHT.

Dialogvinduet til murmur-konfiguration viser mulighederne for at deaktivere Bonjour, aktivere D-Bus, aktivere Ice og deaktivere MySQL- eller SQLite-understøttelse. Det giver dig også mulighed for at deaktivere opbygning af dokumentationen, men det er generelt en dårlig idé.

Oversigt over Murmur build-konfigurationsmuligheder

Navnet på muligheden og den officielle pakkes valg for disse muligheder vises her, hvis du er usikker på nogen af ​​dem.

• Bonjourer en protokol til opdagelse af lokale netværkstjenester. Medmindre du får adgang til din Murmur-server via en VPN, eller du vil have en anden VPS på det samme private netværk til at finde Murmur automatisk, er dette okay at disable.

• D-Buser en måde, hvorpå applikationer, typisk på samme maskine, kan kommunikere med hinanden. I Murmur er D-Bus-grænsefladen forældet og bør forlades disabled, medmindre du er sikker på, at du har et program, der kræver Murmurs D-Bus-grænseflade.

• Documentationskal efterlades, enabledmedmindre du specifikt ikke ønsker, at manualsiderne skal være tilgængelige for dig. Denne mulighed vil ikke ændre noget fra klientens synspunkt, og er kun relevant for systemadministratoren.

• Iceer en nyere RPC-protokol, som giver dig mulighed for at fjernadministrere Murmur ved hjælp af alternative metoder som webgrænseflader. Hvis du enabledette, kan du senere vælge at konfigurere en RPC-løsning, som giver dig mulighed for at gøre ting som online brugerregistrering og fjernkanalmoderering. RPC-konfiguration vil ikke blive håndteret i denne vejledning og kræver normalt en webserver med PHP-understøttelse.

• MySQLer et kraftfuldt, skalerbart databasestyringssystem. Dette skal stå disable, medmindre du har en ekstern database, du gerne vil have Murmur til at bruge i stedet for en lokal fil, eller hvis du planlægger at have mange tusinde brugere. Denne vejledning dækker ikke MySQL-konfiguration.

• SQLiteer et letvægtsalternativ til større databasehåndteringsløsninger som MySQL. Det giver hurtig adgang til en database gemt i en lokal fil for op til hundredtusindvis af poster, og er som sådan ganske velegnet til en Murmur-server. Dette skal efterlades enabled, og konfigurationsafsnittet i denne vejledning vil antage, at det er det.

Når du er tilfreds med disse muligheder, skal du bruge LEFTog RIGHTog derefter trykke på for ENTERat vælge OKnederst i vinduet. Hvis du bliver præsenteret for muligheden for at konfigurere afhængigheder, er standardindstillingerne de sikreste muligheder, så du kan bare trykke på for ENTERat afvise dem med deres standardindstillinger valgt. Efter konfiguration kan opbygningen af ​​Murmur og dets afhængigheder (især Boost) nogle gange tage meget lang tid.

Konfiguration af Murmur

Der er nogle ting, du måske ønsker at justere, før du starter din server for første gang. Denne sektion vil bruge FreeBSD's Easy Editor, som den foretrukne teksteditor, men du kan bruge alt andet i stedet.

Åbn murmur-konfigurationsfilen i en teksteditor:

ee /usr/local/etc/murmur.ini

Det meste af konfigurationen er forklaret i filen, og standardværdierne er normale, men vi vil kort berøre et par vigtige muligheder.

Bemærk: Alle mulighederne nedenfor har standardindstillinger. Du behøver ikke at ændre dem for at serveren kan køre.

Velkomsttekst (MOTD)

En ting, du måske vil ændre, er velkomstteksten, eller som det af nogle kaldes "Dagens budskab". For at gøre det skal du finde linjen, der begynder med, welcometext=og erstatte den eksisterende besked med noget nyt. Mumble kan vise et begrænset udvalg af HTML-tags, som f.eks. <br />en ny linje:

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

Portnummer

Klienter, der forbinder, skal angive et portnummer, hvis serveren ikke lytter på standardporten. Hvis du gerne vil ændre denne port, så dine brugere skal kende den for at oprette forbindelse, skal du bruge port=indstillingen. Ellers skal du lade det være som standard, 64738så dine brugere kun skal huske adressen:

port=443

Maksimalt tilladte brugere

Standard maksimum på 100 brugere er ret rimeligt, men hvis du gerne vil begrænse serveren til kun dig og et par venner, kan du sænke dette maksimum - eller selvfølgelig hæve det - med usersmuligheden:

users=5

Beskedens længde

Hvis du har brug for at sende beskeder i tekstchat på mere end 5000 tegn, skal du ændre textmessagelimitindstillingen. Du kan også indstille den til 0 for at fjerne grænsen helt:

textmessagelimit=12345

Husk at fjerne #tegnet i starten af ​​linjen for at fjerne kommentaren, ellers træder linjen ikke i kraft.

Billedestørrelse

Denne mulighed er lige under indstillingen for beskedlængde, hvis du fjerner kommentarer fra linjer fra standardkonfigurationsfilen. Med standardgrænsen for billedstørrelse på 128 kilobyte, kan du komme til at kæmpe med at sende billeder. Jeg vil anbefale at skrue op for dette, men ikke til så høj en værdi, at nogen kunne sende et stort nok billede til at sænke forbindelsen for enhver bruger med lavere båndbredde internetforbindelser. Som den sidste mulighed kan du indstille værdien af ​​denne til 0 for at tillade billeder af enhver størrelse. Dette er selvfølgelig kun en god idé, når du ved, at alles forbindelse kan klare det:

# 768KiB:
imagemessagelength=786432

Glem ikke at fjerne #karakteren i starten af ​​denne linje også.

SSL/TLS-kryptering

Hvis du har en ordentlig TLS-nøgle og certifikat, kan du angive dem her. Hvis du ikke gør det, vil Murmur generere sine egne og præsentere dem, hvilket kan forårsage certifikatfejl for dine brugere.

For eksempel for en Let's Encrypt, der er sat op 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

Starter Mumlen for første gang

Nu hvor din server er installeret og konfigureret, er der ikke meget tilbage at gøre end at teste den. Da tjenesten endnu ikke er 'aktiveret', vil den almindelige 'start'-kommando ikke køre. Så for at starte serveren én gang, kør følgende:

service murmur onestart

Med serveren kørende, kan du prøve at oprette forbindelse til den. I Mumble skal du tilføje den som en server ved hjælp af dens domænenavn eller IP-adresse og oprette forbindelse. Hvis du kan logge ind, og er synlig i Root-kanalen, virker alt. Hvis ikke, skal du kontrollere serveradressen og konfigurationsfilen for slåfejl eller fejl, og sørg for, at murmurbrugeren kan læse SSL-nøglen, hvis du indstiller din egen, og prøv igen:

service murmur onerestart

Når du er færdig, skal du lukke serveren ned, så vi kan teste at starte den i næste afsnit:

service murmur onestop

Startende mumlen på støvlen

Hvis du kan oprette forbindelse til din nye server, så er du klar til at aktivere tjenesten, så Murmur starter automatisk, når du genstarter (f.eks. efter en opgradering).

For at gøre det, rediger /etc/rc.conf:

ee /etc/rc.conf

Tryk på CTRL+ E, efterfulgt af for ENTERat sætte en tom linje på den anden linje i filen, og skriv:

murmur_enable="YES"

Tryk derefter på ESC, ENTER, for ENTERat gemme og afslutte. For at teste konfigurationen, prøv den almindelige servicestartkommando:

service murmur start

Hvis dette ikke virker, er der tastefejl i rc.conf. gå tilbage og dobbelttjekke det.

Hvis det virker, så er der intet tilbage at gøre. For at teste det, genstart:

sync && reboot

Vent et par sekunder på, at serveren starter op igen, indtil du kan oprette forbindelse til SSH, og prøv derefter at genoprette forbindelsen til Mumble. Tillykke, du har lige installeret og konfigureret Murmur fra bunden.