GNU SIP Witch tilbyr et middel for enkeltpersoner, private organisasjoner, og til og med nasjonale myndigheter å enkelt konfigurere og distribuere sikkert nett skalerbare peer-to-peer medie VoIP løsninger ved hjelp av gratis software.¬ † Denne artikkelen tilbyr en enkel "howto" for å hjelpe folk komme i gang med GNU SIP Witch med Ubuntu.
Sette opp APT
Det er allerede forhånds bygget pakker klar for installasjon av ulike versjoner av Ubuntu (Hardy gjennom Jaunty) på Ubuntu Launchpad som kan installeres direkte fra en PPA (Personal Package Archive) at jeg vedlikeholde. Dette PPA vil fortsette å bli oppdatert med nye oppstrøms utgivelser og kan bli funnet på https://launchpad.net/~gnutelephony/+archive/ppa. Instruksjoner for å sette opp PPA tilgang kan bli funnet på https://help.launchpad.net/Packaging/PPA. Mitt håp er å ha disse pakkene arkivert i Ubuntu og oppdaterte normalt starter med Karmic.
Server Installer
Forutsatt en apt kilde er satt opp, bør du bruke:
apt-get install sipwitch sipwitch-plugin-forwardEller tilsvarende fra synaptic. ..
Dette vil også automatisk installere libucommon2, libosip2-2, og libexosip2-4 eller lignende.
Serverkonfigurasjon
Først, det er /etc /default /sipwitch:
Dette bør i utgangspunktet ha PLUGINS = "ingen" for nå. Vi vil senere legge PLUGINS = "forward" her når vi oppsettet for bruk som en sikker kall domenekontroller for Asterisk eller FreeSwitch.
Så du bør legge en sipwitch "gruppe" i /etc /group:
sudo usermod -Ag sipwitch your-bruker-idDette tilsvarer GROUP = "sipwitch" linje funnet i /etc /default /sipwitch. Kanskje deb postinst bør legge til gruppen for oss i fremtiden.
SIP Witch Regi
Den primære konfigurasjonsfilen er /etc/sipwitch.conf. Denne inneholder informasjon om SIP stabelen, den grunnleggende oppringing plan, og ruting.
Det viktigste valget er at av utvidelsen oppringingsregelen at den gitte sipwitch eksempel vil håndtere. Dette er angitt i < registret > oppføring i /etc/sipwitch.conf. Hvis du vil ha et system som håndterer 3 sifrede forlengelse tall, sier extensions 100-699 er mulig, vil du angi en < prefiks > oppføring av 100, og en < range > oppføring av 600.
Også viktig er < kartlagt > inngang. Dette er det maksimale antallet brukeragenter som vil registrere med serveren. Hvis du planlegger å ha en oppringingsregel for 100-699, og planlegger å ha hver internnummer brukt av en bruker agent, pluss kanskje flere brukeragenter for spesielle funksjoner, kan det være lurt å angi en < kartlagt > oppføring av 700. Hvis du bare har noen få nettlesarar, så kan du bruke et mye mindre antall.
< riket > oppføringen angir registrerings fordøye id. Hvis du vil bruke i kryss-ringer til usikre domener under Asterisk eller FreeSwitch, bør du bruke den samme verdien som riket som er satt i sip.conf av Asterisk server, eller Asterisk standard, noe som jeg tror er < riket > Asterisk < /riket >. Ellers satt det som du vil. Men det er også knyttet til den valgfrie brukeren < fordøye > oppføringer, så det bør ikke endres når innstilt.
SIP Witch Stack
< stable > oppføringer i /etc/sipwitch.conf kontrollere grunnleggende oppførsel av SIP stabelen. Dette inkluderer grensesnitt for å binde på og port som skal brukes for SIP-protokollen. De fleste ting kan være alene for en enkel standard installasjon.
En oppføring som er viktig er < stable > 's < kartlagt > inngang. Dette er det maksimale antall samtidige (samtidige) telefonsamtaler sipwitch vil behandle. Eventuelle andre samtaler som tilbys vil motta en SIP midlertidig opptatt. Hvis du forventer at hver bruker agent til potensielt være aktive på en gang, så kan du ta verdien av 1/2 < registret > 's < kartlagt > verdi, siden hver samtale krever to brukeragenter.
Du vil også være lurt å sette < domene > oppføring i < stack >. Dette er det samme som "domenet" oppføring i glimt user agent setting. Det kan typisk være den faktiske domenet til serveren, eller bare vertsnavn som serveren er installert på. De relaterte < localnames > oppføring kan brukes til å representere flere vertsnavn serveren kan være tilgjengelig som.
SIP Witch Routing
SIP Witch kan settes opp til å operere over flere noder. Dette gjør det mulig å ha svært store Plasser, hvor hver server kjører en del av en oppringingsregel. Måten dette gjøres på er med < routing > oppføringer i sipwitch.conf. Dette er ikke sannsynlig scenario for innledende testing, så jeg er egentlig ment her at evnen eksisterer.
Når ruting er brukt, SIP-telefonsamtale til et mål forlengelse registrert på en ekstern sipwitch eksempel er "omdirigert" til målet server. Hvis vi har en 3-sifret oppringing plan, og en annen server håndterer forespørsler om forlengelse tall 200-299, kanskje vi har en ruting oppføring som:
< routing > < omdirigere mønster = "2xx" server = "dracula.local" /> < /routing >Du kan bruke en enkelt config fil for ruting regler, og inkludere din egen bryter i rute regler, siden stabelen prefiks og spenner at den lokale serveren håndterer styrer freser.
Provisioning Brukere
Provisioning for enkelte utvidelser er funnet i /etc/sipwitch.d. En enkelt bestemmelse posten kan inneholde flere utvidelser. For eksempel kan en enkel klargjøring rekord for /etc/sipwitch.d/yoursite.xml se ut:
< bestemmelsen > < bruker id = "yourid" > < hemmelig > yourpassword < /hemmelig > < forlengelse > 101 < /forlengelse > < display > Ditt fulle navn < /display > < /bruker > < bruker id = "anotherid" > < hemmelig > anotherpassword < /hemmelig > < forlengelse > 102 < /forlengelse > < display > Et annet fullt navn < /display > < /bruker > < /bestemmelse >I denne "Id" er den logiske bruker-id (kan være fra e-post eller login id), det er en hemmelighet, som er et passord som også brukes i user agent, en forlengelse # i området til ringer plan dette innlegget er assosiert med, og et visningsnavn som vises når brukeren agenten kaller en annen. Det er også andre funksjoner som samtale < frem > oppføringer å sette viderekobling, som vil bli beskrevet senere ...
Hvis du ikke ønsker å eksponere brukerpassord i klargjøringsfilen, kan du bruke en < fordøye > xxx < /digest > oppføring i stedet for passord. Sammendraget kan beregnes med "sipdigest" verktøyet. For eksempel:
sipdigest -realm Asterisk yourid yourpasswordvil beregne et sammendrag verdien du kan bruke. Du vil fortsatt skrive inn passordet i godkjennings del av glitre. Men minst serveren config filen vil ikke ha passord, bare fordøyer, akkurat som /etc /shadow-filen har for brukerpålogging.
Running SIP Witch Tjenesten
SIP Witch fungerer som en daemon service. Det normalt vil starte automatisk når du starter og kan administreres fra standard skrivebordet "tjenester" applet. Når du oppdaterer sipwitch pakken gjennom apt, blir tjenesten automatisk stoppet og startet på nytt for deg, men dette vil avslutte alle aktive telefonsamtaler. Du kan også endre sipwitch konfigurasjonsfiler til enhver tid og legg dem inn i øyeblikket kjører server uten nedetid.
Kontrollere Server
Den primære grensesnitt for å styre serveren er med "sipwitch" shell kommandoen. Dette vil snakke med kjørende forekomst av nissen. Hvis du er i "sipwitch" gruppe i /etc /group, vil du ikke trenger å være root for å gjøre dette.
Listen over tilgjengelige kommandoer kan bli funnet med "mann sipwitch". Ja det er en mann siden grafikk1. Av særlig bruk er:
sipwitch kaller - lister aktive samtaler pågår (ingen utgang hvis ingen) sipwitch register - lister registrert extensions sipwitch status - single line bord sipwitch legget - kjører samtale statistikk (alltid nyttig selv om tomgang ...) sipwitch reload - laster konfigurasjonen etter config filer endret
Server Loggfiler
Det er tre primære loggfiler:
/var/log/sipwitch.log - grunnleggende feil og aktivisering logging /var/log/sipwitch.stats - ring statistikk hver time /var/log/sipwitch.calls - registrering av hver samtale
Disse blir automatisk rotert basert på /var/logrotate.d/sipwitch
Det er også en /etc/cron.hourly/sipwitch som genererer time statistikk.
Bruke SIP klienter
Alle standard er kompatibel SIP user agent kan brukes med sipwitch. Minstekravet er å konfigurere sipwitch server som både registrar og utgående proxy. Siden SIP Witch gjør ingen media behandling, kan noen lyd eller videokoding metoden støttes av brukermidler også brukes. Dette dokumentet vil fokusere på de kundene som oftest funnet distribuert i Ubuntu, og fokuserer først på de kundene som tilbyr sikker ringer evner.
Bruke glitre
Installere denne klienten på Debian eller Ubuntu krever bare bruker apt-get install glimt.
Kunden bør ha en brukerprofil som følgende:
"brukernavn" er den xxx id brukt i < bruker id = "xxx" > inngang.
"domenet" er yyy domene i hoved config < stable > < domene > yyy oppføring.
SIP Authentication bør ha:
realm = riket som satt i < registret > < riket >.
autentisering name = < bruker id = "xx" > oppføring, samme som "User Name" -feltet.
password = verdien av < hemmelig > zzz i < bruker > entry
Under sikkerhet kategorien, sette "Aktiver ZRTP /SRTP kryptering»
fremtidige retninger
Det finnes en rekke prioriteringer i GNU SIP Witch utvikling. Disse inkluderer utvikling av RTP media proxyer for automatisk NAT penetrasjon, plugins for lasting sipwitch tilleggsbord fra eksterne databasekilder, og en front-end ledelse lag for slike ekstern databaser. Enhver samfunnet hjelp med SIP Witch utvikling er alltid velkommen.
Hentet fra «http://www.gnutelephony.org/index.php/Howto_Deploy_SIP_Witch_On_Ubuntu"