Il PBX Open Source Asterisk(R)

By Mark Spencer <[email protected]> and the Asterisk.org developer community.
Copyright (C) 2001-2025 Sangoma Technologies Corporation and other copyright holders.

SICUREZZA

È fondamentale leggere e comprendere appieno il contenuto del documento sulle informazioni di sicurezza prima di tentare di configurare ed eseguire un server Asterisk.

Vedi Considerazioni importanti sulla sicurezza per maggiori informazioni.

COS'È ASTERISK?

Asterisk è un PBX Open Source e un toolkit per la telefonia. È, in un certo senso, un middleware tra i canali Internet e di telefonia in basso e le applicazioni Internet e di telefonia in alto. Tuttavia, Asterisk supporta più interfacce telefoniche della sola telefonia Internet. Asterisk offre anche un vasto supporto per la tradizionale telefonia PSTN.

Per maggiori informazioni sul progetto stesso, visita la Home Page di Asterisk e la Documentazione ufficiale di Asterisk.

SISTEMI OPERATIVI SUPPORTATI

Linux

Il PBX Open Source Asterisk è sviluppato e testato principalmente sul sistema operativo GNU/Linux ed è supportato su tutte le principali distribuzioni GNU/Linux.

Altri

Asterisk è stato anche 'portato' e, secondo quanto riportato, funziona correttamente anche su altri sistemi operativi, come il Mac OS X di Apple e le varianti BSD.

PER INIZIARE

La maggior parte degli utenti oggi utilizza esclusivamente VoIP/SIP, ma se hai bisogno di interfacciarti con servizi o dispositivi TDM o analogici, assicurati di disporre di hardware supportato.

L'hardware telefonico supportato include:

• Tutte le schede di interfaccia analogiche e digitali di Sangoma
• Qualsiasi scheda audio full duplex supportata da PortAudio
• Il channel bank Xorcom Astribank

AGGIORNAMENTO DA UNA VERSIONE PRECEDENTE

Se stai effettuando l'aggiornamento da una versione precedente di Asterisk, assicurati di leggere i registri delle modifiche.

Registri delle modifiche

NUOVE INSTALLAZIONI

Assicurati che il tuo sistema contenga un compilatore compatibile e librerie di sviluppo. Asterisk richiede la GNU Compiler Collection (GCC) versione 4.1 o successiva, oppure un compilatore che supporti la specifica C99 e alcune delle estensioni linguistiche di gcc. Inoltre, il tuo sistema deve avere a disposizione gli header della libreria C e gli header e le librerie per ncurses.

Ci sono molti moduli che hanno dipendenze aggiuntive. Per vedere quali librerie vengono cercate, consulta ./configure --help oppure esegui make menuselect per visualizzare le dipendenze di moduli specifici.

Su molte distribuzioni, queste dipendenze vengono installate tramite pacchetti con nomi come 'glibc-devel', 'ncurses-devel', 'openssl-devel' e 'zlib-devel' o simili. Lo script contrib/scripts/install_prereq può essere utilizzato per installare le dipendenze per la maggior parte delle distribuzioni Linux basate su Debian e Redhat. Lo script gestisce anche SUSE, Arch, Gentoo, FreeBSD, NetBSD e OpenBSD, ma queste distribuzioni potrebbero non avere un supporto completo o potrebbero essere obsolete.

Quindi, procediamo:

1. Leggi la documentazione.
   Il sito web della Documentazione Asterisk contiene informazioni complete su compilazione, installazione, configurazione ed esecuzione di Asterisk.

2. Esegui ./configure
   Esegui lo script di configure per stimare i valori delle variabili dipendenti dal sistema utilizzate durante la compilazione. Se lo script indica che mancano alcuni componenti richiesti, puoi eseguire ./contrib/scripts/install_prereq install per installare i componenti necessari. Nota che questo installerà tutte le dipendenze per ogni funzionalità di Asterisk. Dopo aver eseguito lo script, dovrai eseguire nuovamente ./configure.

3. Esegui make menuselect
   Questo è necessario se vuoi selezionare i moduli che verranno compilati e per controllare le dipendenze dei vari moduli opzionali.

4. Esegui make
   Supponendo che la compilazione vada a buon fine:

5. Esegui make install
   Se è la prima volta che lavori con Asterisk, potresti voler installare il PBX di esempio, con estensioni dimostrative, ecc. In tal caso, esegui:

6. Esegui make samples
   In questo modo sovrascriverai eventuali file di configurazione esistenti che hai installato.

7. Infine, puoi avviare Asterisk in modalità foreground (non come daemon) con asterisk -vvvc
   Vedrai un sacco di messaggi verbose sfrecciare sullo schermo mentre Asterisk si inizializza (questa è la modalità "very very verbose"). Quando è pronto, se hai specificato la "c", otterrai una console a riga di comando, che appare così:
   *CLI>
   Puoi digitare core show help in qualsiasi momento per ottenere aiuto sul sistema. Per aiuto su un comando specifico, digita core show help <command>.

man asterisk al prompt dei comandi Unix/Linux ti fornirà informazioni dettagliate su come avviare e arrestare Asterisk, oltre a tutte le opzioni della riga di comando per avviare Asterisk.

INFORMAZIONI SUI FILE DI CONFIGURAZIONE

Tutti i file di configurazione di Asterisk condividono un formato comune. I commenti sono delimitati da ; (poiché #, ovviamente, essendo una cifra DTMF, può comparire in molti punti). Un file di configurazione è diviso in sezioni i cui nomi compaiono tra []. Ogni sezione contiene tipicamente istruzioni nella forma variable = value, anche se negli esempi più vecchi potresti vedere variable => value.

NOTA SPECIALE SULL'ORA

Coloro che utilizzano telefoni SIP dovrebbero essere consapevoli che Asterisk è sensibile a grandi salti di tempo. Modificare manualmente l'ora di sistema usando date(1) (o altri comandi simili) può causare il fallimento delle registrazioni SIP e di altri processi interni. Per questo motivo, dovresti sempre usare un pacchetto di sincronizzazione dell'ora per mantenere accurata l'ora di sistema. Tutti i sistemi operativi/distribuzioni rendono disponibile uno o più dei seguenti pacchetti:

• ntpd/ntpsec
• chronyd
• systemd-timesyncd

Assicurati di installare e configurare uno (e uno solo) di essi.

FILE DESCRIPTOR

A seconda delle dimensioni del tuo sistema e della tua configurazione, Asterisk può consumare un gran numero di file descriptor. In UNIX, i file descriptor sono usati per molto più che i semplici file su disco. I file descriptor sono usati anche per gestire la comunicazione di rete (ad es. chiamate SIP, IAX2 o H.323) e l'accesso all'hardware (ad es. hardware trunk analogico e digitale). Asterisk accede a molti file su disco per tutto, dalle informazioni di configurazione all'archiviazione della casella vocale.

La maggior parte dei sistemi limita il numero di file descriptor che Asterisk può tenere aperti contemporaneamente. Questo può limitare il numero di chiamate simultanee che il tuo sistema può gestire. Ad esempio, se il limite è impostato a 1024 (un valore predefinito comune), Asterisk può gestire circa 150 chiamate SIP simultanee. Per modificare il numero di file descriptor, segui le istruzioni per il tuo sistema qui di seguito:

SISTEMA LINUX BASATO SU PAM

Se il tuo sistema usa PAM (Pluggable Authentication Modules), modifica /etc/security/limits.conf. Aggiungi queste righe in fondo al file:

root            soft    nofile          4096
root            hard    nofile          8196
asterisk        soft    nofile          4096
asterisk        hard    nofile          8196

(regola i numeri a piacere). Potrebbe essere necessario riavviare il sistema affinché queste modifiche abbiano effetto.

SISTEMA UNIX GENERICO

Se non ci sono istruzioni specificamente adattate al tuo sistema qui sopra, puoi provare ad aggiungere il comando ulimit -n 8192 allo script che avvia Asterisk.

ULTERIORI INFORMAZIONI

Visita il sito web della Documentazione Asterisk per ulteriore documentazione sulle varie funzionalità e leggi tutti gli esempi di configurazione che includono documentazione sulle opzioni di configurazione.

Infine, potresti voler aderire ai Forum della Community di Asterisk

Benvenuto nella crescente community mondiale di utenti Asterisk!

        Mark Spencer, and the Asterisk.org development community

Asterisk è un marchio di Sangoma Technologies Corporation

[Sangoma] [Home Page] [Supporto] [Documentazione] [Forum della Community] [Note di rilascio] [Sicurezza] [Archivio della mailing list]