Forutsetninger
Installerer Murmur-pakken
Installerer fra porter
Konfigurere Murmur
Starter Murmur for første gang
Starter murring på støvelen
Murmur er den offisielle serverprogramvaren for Mumble-talekommunikasjonsprotokollen. Denne offisielle implementeringen er stabil og effektiv. Denne guiden vil beskrive trinn-for-trinn prosessen med å installere og konfigurere en Murmur-server for kommunikasjon med Mumble-klienter på FreeBSD 11.2.
Forutsetninger
- Enhver Vultr VPS
- En SSH-klient:
ssh i en terminal for Linux-, Mac- og Unix-brukere (inkludert BSD).
- Den PuTTY SSH-klient for Windows
SSH til din Vultr FreeBSD-server og logg inn som root, eller som sudobruker. Hvis du bruker en sudobruker, legg kommandoer foran med sudo:
home-desktop$ ssh root@198.51.100.21
Merk: Erstatt 198.51.100.21med din egen IP-adresse.
Installerer Murmur-pakken
Merk: Denne delen vil installere en vanilla Murmur-server uten D-Bus/ Bonjourstøtte.
For å legge til Murmur og dets avhengigheter til systemet, kjør følgende kommando:
pkg install murmur
Siden du har installert serverprogramvaren fra den binære distribusjonen, kan du hoppe over neste seksjon og fortsette til Konfigurere Murmur .
Installerer fra porter
Hvis du har fulgt resten av veiledningen til dette punktet, og du ikke vil aktivere D-Buseller Bonjourstøtte, eller deaktivere Ice/MySQL/SQLite-støtte, kan du gjerne følge forrige seksjon i stedet og deretter hoppe til Konfigurere Murmur .
Får havnetreet
Kjør denne kommandoen for å se etter og laste ned eventuelle oppdateringer til porttreet (du trenger dette hvis du ikke har portoppsett ennå):
portsnap fetch
Hvis utgangen slutter med ' No updates needed', kan du hoppe til neste trinn. Ellers har du ikke forberedt et oppdatert porttre, og du må trekke ut det nylig nedlastede øyeblikksbildet:
portsnap extract
Bygge og installere serverapplikasjonen
Det er enkelt å kompilere Murmur-porten, men det vil ta litt tid. Følgende kommandoer vil plassere deg i portkatalogen, bygge den, installere de genererte filene og fjerne unødvendige filer etter at de er bygget:
cd /usr/ports/audio/murmur
make install clean
Under de tidlige delene av installasjonen vil du se en eller flere tekstdialogbokser som spør om funksjoner du vil aktivere eller deaktivere. For å navigere i menyene, bruk UPog DOWNpilene for å markere en oppføring, SPACEfor å veksle oppføringen er aktivert / deaktivert status, eller ENTERå bruke standardhandlingen. For å endre standardhandlingen (vanligvis 'Avbryt'), bruk LEFTog RIGHTpiler.
Murmur-konfigurasjonsdialogvinduet vil presentere alternativene for å deaktivere Bonjour, aktivere D-Bus, aktivere Ice og deaktivere MySQL- eller SQLite-støtte. Det lar deg også deaktivere bygging av dokumentasjonen, men dette er generelt en dårlig idé.
Sammendrag av Murmur build-konfigurasjonsalternativer
Navnet på alternativet og den offisielle pakkens valg for disse alternativene vises her, hvis du er usikker på noen av dem.
Bonjourer en protokoll for oppdagelse av lokale nettverkstjenester. Med mindre du får tilgang til Murmur-serveren din via en VPN, eller du vil at en annen VPS på det samme private nettverket skal finne Murmur automatisk, er dette greit å disable.
D-Buser en måte for programmer, vanligvis på samme maskin, å kommunisere med hverandre. I Murmur er D-Bus-grensesnittet utdatert og bør stå disabled, med mindre du er sikker på at du har et program som krever Murmurs D-Bus-grensesnitt.
Documentationbør stå enabledmed mindre du spesifikt ikke vil at manualsidene skal være tilgjengelige for deg. Dette alternativet vil ikke endre noe fra klientens synspunkt, og er kun relevant for systemadministratoren.
Iceer en nyere RPC-protokoll som lar deg fjernadministrere Murmur ved å bruke alternative metoder som webgrensesnitt. Hvis du enabledette, kan du senere velge å konfigurere en RPC-løsning som lar deg gjøre ting som online brukerregistrering og ekstern kanalmoderering. RPC-konfigurasjon vil ikke bli håndtert i denne veiledningen, og krever vanligvis en webserver med PHP-støtte.
MySQLer et kraftig, skalerbart databasestyringssystem. Dette bør stå igjen disable, med mindre hvis du har en ekstern database du vil at Murmur skal bruke i stedet for en lokal fil, eller hvis du planlegger å ha mange tusen brukere. Denne veiledningen vil ikke dekke MySQL-konfigurasjon.
SQLiteer et lett alternativ til større databaseadministrasjonsløsninger som MySQL. Den gir rask tilgang til en database lagret i en lokal fil for opptil hundretusenvis av poster, og er som sådan ganske egnet for en Murmur-server. Dette bør stå igjen enabled, og konfigurasjonsdelen av denne veiledningen vil anta at det er det.
Når du er fornøyd med disse alternativene, bruk LEFTog RIGHTog trykk deretter for ENTERå velge OKnederst i vinduet. Hvis du får muligheten til å konfigurere avhengigheter, er standardinnstillingene de sikreste alternativene, så du kan bare trykke for ENTERå avvise dem med standardalternativene valgt. Etter konfigurasjon kan det noen ganger ta veldig lang tid å bygge Murmur og dens avhengigheter (spesielt Boost).
Konfigurere Murmur
Det er noen ting du kanskje vil justere før du starter serveren din for første gang. Denne delen vil bruke FreeBSDs Easy Editor, som den foretrukne teksteditoren, men du kan bruke alt annet i stedet.
Åpne murmur-konfigurasjonsfilen i et tekstredigeringsprogram:
ee /usr/local/etc/murmur.ini
Det meste av konfigurasjonen er forklart i filen, og standardverdiene er normale, men vi vil kort berøre noen viktige alternativer.
Merk: Alle alternativene nedenfor har standardinnstillinger. Du trenger ikke endre dem for at serveren skal kjøre.
Velkomsttekst (MOTD)
En ting du kanskje vil endre er velkomstteksten, eller som den heter av noen, «Dagens budskap». For å gjøre det, finn linjen som begynner med welcometext=og erstatte den eksisterende meldingen med noe nytt. Mumble kan vise et begrenset utvalg av HTML-tagger, som <br />å betegne en ny linje:
welcometext="<br /> Check out this cool Vultr VPS! <br />"
Portnummer
Klienter som kobler til må spesifisere et portnummer hvis serveren ikke lytter på standardporten. Hvis du vil endre denne porten slik at brukerne dine må vite den for å koble til, bruk port=alternativet. Ellers la den stå som standard 64738slik at brukerne bare trenger å huske adressen:
port=443
Maksimalt tillatte brukere
Standardmaksimum på 100 brukere er ganske rimelig, men hvis du vil begrense serveren til bare deg og noen få venner, kan du senke dette maksimumet - eller øke det, selvfølgelig - med usersalternativet:
users=5
Meldingslengde
Hvis du trenger å sende meldinger i tekstchat som er lengre enn 5000 tegn, bør du endre textmessagelimitalternativet. Du kan også sette den til 0 for å fjerne grensen helt:
textmessagelimit=12345
Husk å fjerne #tegnet på begynnelsen av linjen for å fjerne kommentaren, ellers trer ikke linjen i kraft.
Bildestørrelse
Dette alternativet er rett under alternativet for meldingslengde, hvis du fjerner kommentarer fra linjer fra standard konfigurasjonsfil. Med standard bildestørrelsesgrense på 128 kilobyte, kan det hende du sliter med å sende bilder. Jeg vil anbefale å skru opp dette, men ikke til en så høy verdi at noen kan sende et stort nok bilde til å redusere tilkoblingen til alle brukere med internettforbindelser med lavere båndbredde. Som det siste alternativet kan du sette verdien på denne til 0 for å tillate bilder i alle størrelser. Selvfølgelig er dette bare en god idé når du vet at alles tilkobling kan håndtere det:
# 768KiB:
imagemessagelength=786432
Ikke glem å fjerne #tegnet i begynnelsen av denne linjen også.
SSL/TLS-kryptering
Hvis du har en riktig TLS-nøkkel og sertifikat, kan du spesifisere dem her. Hvis du ikke gjør det, vil Murmur generere sine egne og presentere dem, noe som kan forårsake sertifikatfeil for brukerne dine.
For eksempel, for en Let's Encrypt som er satt opp 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 Murmur for første gang
Nå som serveren din er installert og konfigurert, er det ikke mye igjen å gjøre enn å teste den. Siden tjenesten ennå ikke er "aktivert", vil ikke den vanlige "start"-kommandoen kjøres. Så for å starte serveren én gang, kjør følgende:
service murmur onestart
Når serveren kjører, kan du prøve å koble til den. I Mumble legger du den til som en server ved å bruke domenenavnet eller IP-adressen og kobler til. Hvis du kan logge inn, og er synlig i Root-kanalen, fungerer alt. Hvis ikke, kontroller serveradressen og konfigurasjonsfilen for skrivefeil eller feil, og sørg for at murmurbrukeren kan lese SSL-nøkkelen hvis du angir din egen, og prøv igjen:
service murmur onerestart
Når du er ferdig, slå av serveren for å prøve å starte den i neste seksjon:
service murmur onestop
Starter murring på støvelen
Hvis du kan koble til den nye serveren din, er du klar til å aktivere tjenesten slik at Murmur starter automatisk når du starter på nytt (for eksempel etter en oppgradering).
For å gjøre det, rediger /etc/rc.conf:
ee /etc/rc.conf
Trykk CTRL+ E, etterfulgt av for ENTERå sette en tom linje på den andre linjen i filen, og skriv:
murmur_enable="YES"
Trykk deretter ESC, ENTER, for ENTERå lagre og avslutte. For å teste konfigurasjonen, prøv den vanlige servicestartkommandoen:
service murmur start
Hvis dette ikke fungerer, er det skrivefeil i rc.conf. gå tilbake og dobbeltsjekke det.
Hvis det fungerer, er det ingenting igjen å gjøre. For å teste det, start på nytt:
sync && reboot
Vent noen sekunder til serveren starter opp igjen til du kan koble til SSH, og prøv deretter å koble til Mumble igjen. Gratulerer, du har nettopp installert og konfigurert Murmur fra bunnen av.