La PBX de código abierto Asterisk(R)

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

SEGURIDAD

Es imprescindible que lea y comprenda completamente el contenido del documento de información de seguridad antes de intentar configurar y ejecutar un servidor Asterisk.

Consulte Consideraciones importantes de seguridad para obtener más información.

¿QUÉ ES ASTERISK?

Asterisk es una PBX de código abierto y un kit de herramientas de telefonía. Es, en cierto sentido, middleware entre los canales de Internet y telefonía en la parte inferior, y las aplicaciones de Internet y telefonía en la parte superior. Sin embargo, Asterisk soporta más interfaces de telefonía que solo la telefonía por Internet. Asterisk también tiene una gran cantidad de soporte para la telefonía PSTN tradicional.

Para obtener más información sobre el propio proyecto, visite la Página principal de Asterisk y la Documentación oficial de Asterisk.

SISTEMAS OPERATIVOS SOPORTADOS

Linux

La PBX de código abierto Asterisk se desarrolla y prueba principalmente en el sistema operativo GNU/Linux, y es compatible con todas las distribuciones principales de GNU/Linux.

Otros

Asterisk también ha sido 'portado' y, según se informa, funciona correctamente en otros sistemas operativos, como Mac OS X de Apple y las variantes de BSD.

PRIMEROS PASOS

La mayoría de los usuarios utilizan exclusivamente VoIP/SIP hoy en día, pero si necesita interactuar con servicios o dispositivos TDM o analógicos, asegúrese de tener hardware compatible.

El hardware de telefonía compatible incluye:

• Todas las tarjetas de interfaz analógicas y digitales de Sangoma
• Cualquier tarjeta de sonido full duplex compatible con PortAudio
• El banco de canales Xorcom Astribank

ACTUALIZACIÓN DESDE UNA VERSIÓN ANTERIOR

Si va a actualizar desde una versión anterior de Asterisk, asegúrese de leer los registros de cambios (Change Logs).

Registros de cambios

NUEVAS INSTALACIONES

Asegúrese de que su sistema contenga un compilador compatible y bibliotecas de desarrollo. Asterisk requiere la Colección de Compiladores GNU (GCC) versión 4.1 o superior, o un compilador que soporte la especificación C99 y algunas de las extensiones de lenguaje de gcc. Además, su sistema necesita tener los encabezados de la biblioteca de C disponibles, así como los encabezados y las bibliotecas de ncurses.

Hay muchos módulos que tienen dependencias adicionales. Para ver qué bibliotecas se están buscando, consulte ./configure --help, o ejecute make menuselect para ver las dependencias de módulos específicos.

En muchas distribuciones, estas dependencias se instalan mediante paquetes con nombres como 'glibc-devel', 'ncurses-devel', 'openssl-devel' y 'zlib-devel' o similares. El script contrib/scripts/install_prereq se puede utilizar para instalar las dependencias en la mayoría de las distribuciones Linux basadas en Debian y Redhat. El script también es compatible con SUSE, Arch, Gentoo, FreeBSD, NetBSD y OpenBSD, pero esas distribuciones podrían no tener soporte completo o podrían estar desactualizadas.

Así que, procedamos:

1. Lea la documentación.
   El sitio web de la Documentación de Asterisk contiene información completa sobre cómo compilar, instalar, configurar y ejecutar Asterisk.

2. Ejecute ./configure
   Ejecute el script de configuración para adivinar los valores de las variables dependientes del sistema utilizadas durante la compilación. Si el script indica que faltan algunos componentes requeridos, puede ejecutar ./contrib/scripts/install_prereq install para instalar los componentes necesarios. Tenga en cuenta que esto instalará todas las dependencias para cada funcionalidad de Asterisk. Después de ejecutar el script, necesitará volver a ejecutar ./configure.

3. Ejecute make menuselect
   Esto es necesario si desea seleccionar los módulos que se compilarán y comprobar las dependencias de varios módulos opcionales.

4. Ejecute make
   Suponiendo que la compilación se complete correctamente:

5. Ejecute make install
   Si es la primera vez que trabaja con Asterisk, es posible que desee instalar la PBX de ejemplo, con extensiones de demostración, etc. Si es así, ejecute:

6. Ejecute make samples
   Al hacerlo, sobrescribirá cualquier archivo de configuración existente que haya instalado.

7. Finalmente, puede lanzar Asterisk en modo de primer plano (no como daemon) con asterisk -vvvc
   Verá un montón de mensajes verbose pasar por su pantalla mientras Asterisk se inicializa (ese es el modo "muy muy verboso"). Cuando esté listo, si especificó la "c", obtendrá una consola de línea de comandos, que se ve así:
   *CLI>
   Puede escribir core show help en cualquier momento para obtener ayuda con el sistema. Para obtener ayuda con un comando específico, escriba core show help <command>.

man asterisk en el símbolo del sistema Unix/Linux le dará información detallada sobre cómo iniciar y detener Asterisk, así como todas las opciones de línea de comandos para iniciarlo.

ACERCA DE LOS ARCHIVOS DE CONFIGURACIÓN

Todos los archivos de configuración de Asterisk comparten un formato común. Los comentarios están delimitados por ; (ya que #, por supuesto, al ser un dígito DTMF, puede aparecer en muchos lugares). Un archivo de configuración se divide en secciones cuyos nombres aparecen entre []. Cada sección normalmente contiene declaraciones de la forma variable = value, aunque puede ver variable => value en ejemplos más antiguos.

NOTA ESPECIAL SOBRE EL TIEMPO

Quienes utilizan teléfonos SIP deben ser conscientes de que Asterisk es sensible a grandes saltos en el tiempo. Cambiar manualmente la hora del sistema usando date(1) (u otros comandos similares) puede provocar fallos en los registros SIP y en otros procesos internos. Por esta razón, siempre debe utilizar un paquete de sincronización de tiempo para mantener la hora de su sistema precisa. Todos los SO/distribuciones ponen a disposición uno o más de los siguientes paquetes:

• ntpd/ntpsec
• chronyd
• systemd-timesyncd

Asegúrese de instalar y configurar uno (y solo uno) de ellos.

DESCRIPTORES DE ARCHIVO

Dependiendo del tamaño de su sistema y de su configuración, Asterisk puede consumir una gran cantidad de descriptores de archivo. En UNIX, los descriptores de archivo se utilizan para más que solo archivos en disco. Los descriptores de archivo también se utilizan para manejar la comunicación de red (por ejemplo, llamadas SIP, IAX2 o H.323) y el acceso a hardware (por ejemplo, hardware de troncales analógicas y digitales). Asterisk accede a muchos archivos en disco para todo, desde información de configuración hasta almacenamiento de correo de voz.

La mayoría de los sistemas limitan el número de descriptores de archivo que Asterisk puede tener abiertos a la vez. Esto puede limitar el número de llamadas simultáneas que su sistema puede manejar. Por ejemplo, si el límite está establecido en 1024 (un valor predeterminado común), Asterisk puede manejar aproximadamente 150 llamadas SIP simultáneamente. Para cambiar el número de descriptores de archivo, siga las instrucciones para su sistema a continuación:

SISTEMA LINUX BASADO EN PAM

Si su sistema utiliza PAM (Módulos de autenticación conectables, Pluggable Authentication Modules), edite /etc/security/limits.conf. Agregue estas líneas al final del archivo:

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

(ajuste los números a su gusto). Es posible que necesite reiniciar el sistema para que estos cambios surtan efecto.

SISTEMA UNIX GENÉRICO

Si no hay instrucciones específicamente adaptadas a su sistema más arriba, puede intentar agregar el comando ulimit -n 8192 al script que inicia Asterisk.

MÁS INFORMACIÓN

Visite el sitio web de la Documentación de Asterisk para obtener más documentación sobre varias características y, por favor, lea todos los ejemplos de configuración que incluyen documentación sobre las opciones de configuración.

Finalmente, es posible que desee unirse a los Foros de la comunidad de Asterisk

¡Bienvenido a la creciente comunidad mundial de usuarios de Asterisk!

        Mark Spencer, and the Asterisk.org development community

Asterisk es una marca comercial de Sangoma Technologies Corporation

[Sangoma] [Página principal] [Soporte] [Documentación] [Foros de la comunidad] [Notas de la versión] [Seguridad] [Archivo de la lista de correo]