A Asterisk(R) PBX Open Source

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

SEGURANÇA

É imperativo que você leia e entenda completamente o conteúdo do documento de informações de segurança antes de tentar configurar e executar um servidor Asterisk.

Veja Considerações Importantes de Segurança para mais informações.

O QUE É ASTERISK?

Asterisk é um PBX Open Source e kit de ferramentas de telefonia. É, em certo sentido, um middleware entre canais de Internet e telefonia na base, e aplicações de Internet e telefonia no topo. No entanto, o Asterisk suporta mais interfaces de telefonia do que apenas telefonia pela Internet. O Asterisk também possui um vasto suporte para telefonia PSTN tradicional.

Para mais informações sobre o projeto em si, visite a Página Inicial do Asterisk e a Documentação oficial do Asterisk.

SISTEMAS OPERACIONAIS SUPORTADOS

Linux

O Asterisk PBX Open Source é desenvolvido e testado principalmente no sistema operacional GNU/Linux, e é suportado em todas as principais distribuições GNU/Linux.

Outros

O Asterisk também foi 'portado' e supostamente funciona corretamente em outros sistemas operacionais, como Apple Mac OS X e as variantes BSD.

PRIMEIROS PASSOS

A maioria dos usuários está usando VoIP/SIP exclusivamente atualmente, mas se você precisar fazer interface com serviços ou dispositivos TDM ou analógicos, certifique-se de ter hardware suportado.

O hardware de telefonia suportado inclui:

• Todas as placas de interface analógica e digital da Sangoma
• Qualquer placa de som full duplex suportada pelo PortAudio
• O banco de canais Xorcom Astribank

ATUALIZANDO DE UMA VERSÃO ANTERIOR

Se você está atualizando de uma versão anterior do Asterisk, certifique-se de ler os Registros de Alterações (Change Logs).

Registros de Alterações

NOVAS INSTALAÇÕES

Certifique-se de que seu sistema contenha um compilador compatível e bibliotecas de desenvolvimento. O Asterisk requer a GNU Compiler Collection (GCC) versão 4.1 ou superior, ou um compilador que suporte a especificação C99 e algumas das extensões de linguagem do GCC. Além disso, seu sistema precisa ter os cabeçalhos da biblioteca C disponíveis, e os cabeçalhos e bibliotecas do ncurses.

Há muitos módulos que possuem dependências adicionais. Para ver quais bibliotecas estão sendo procuradas, consulte ./configure --help, ou execute make menuselect para visualizar as dependências de módulos específicos.

Em muitas distribuições, essas dependências são instaladas por pacotes com nomes como 'glibc-devel', 'ncurses-devel', 'openssl-devel' e 'zlib-devel' ou similares. O script contrib/scripts/install_prereq pode ser usado para instalar as dependências na maioria das distribuições Linux baseadas em Debian e Redhat. O script também lida com SUSE, Arch, Gentoo, FreeBSD, NetBSD e OpenBSD, mas essas distribuições podem não ter suporte completo ou podem estar desatualizadas.

Então, vamos prosseguir:

1. Leia a documentação.
   O site Documentação do Asterisk tem informações completas para compilar, instalar, configurar e executar o Asterisk.

2. Execute ./configure
   Execute o script configure para adivinhar valores para variáveis dependentes do sistema usadas durante a compilação. Se o script indicar que alguns componentes necessários estão faltando, você pode executar ./contrib/scripts/install_prereq install para instalar os componentes necessários. Observe que isso instalará todas as dependências para todas as funcionalidades do Asterisk. Após executar o script, você precisará executar ./configure novamente.

3. Execute make menuselect
   Isso é necessário se você quiser selecionar os módulos que serão compilados e verificar dependências para vários módulos opcionais.

4. Execute make
   Supondo que a compilação seja concluída com sucesso:

5. Execute make install
   Se esta é sua primeira vez trabalhando com Asterisk, você pode desejar instalar o PBX de exemplo, com ramais de demonstração, etc. Se sim, execute:

6. Execute make samples
   Isso sobrescreverá quaisquer arquivos de configuração existentes que você tenha instalado.

7. Finalmente, você pode iniciar o Asterisk em modo foreground (não como daemon) com asterisk -vvvc
   Você verá um monte de mensagens verbosas passarem pela tela enquanto o Asterisk inicializa (esse é o modo "very very verbose"). Quando estiver pronto, se você especificou o "c", você obterá um console de linha de comando, que se parece com isto:
   *CLI>
   Você pode digitar core show help a qualquer momento para obter ajuda com o sistema. Para ajuda com um comando específico, digite core show help <comando>.

man asterisk no prompt de comando Unix/Linux fornecerá informações detalhadas sobre como iniciar e parar o Asterisk, bem como todas as opções de linha de comando para iniciar o Asterisk.

SOBRE ARQUIVOS DE CONFIGURAÇÃO

Todos os arquivos de configuração do Asterisk compartilham um formato comum. Comentários são delimitados por ; (já que #, obviamente, sendo um dígito DTMF, pode ocorrer em muitos lugares). Um arquivo de configuração é dividido em seções cujos nomes aparecem entre []. Cada seção normalmente contém declarações no formato variable = value, embora você possa ver variable => value em exemplos mais antigos.

NOTA ESPECIAL SOBRE TEMPO

Aqueles que usam telefones SIP devem estar cientes de que o Asterisk é sensível a grandes saltos no tempo. Alterar manualmente a hora do sistema usando date(1) (ou outros comandos similares) pode causar falhas em registros SIP e outros processos internos. Por esse motivo, você deve sempre usar um pacote de sincronização de tempo para manter a hora do seu sistema precisa. Todos os sistemas operacionais/distribuições disponibilizam um ou mais dos seguintes pacotes:

• ntpd/ntpsec
• chronyd
• systemd-timesyncd

Certifique-se de instalar e configurar um (e apenas um) deles.

DESCRITORES DE ARQUIVO

Dependendo do tamanho do seu sistema e da sua configuração, o Asterisk pode consumir um grande número de descritores de arquivo. No UNIX, os descritores de arquivo são usados para mais do que apenas arquivos em disco. Descritores de arquivo também são usados para lidar com comunicação de rede (por exemplo, chamadas SIP, IAX2 ou H.323) e acesso a hardware (por exemplo, hardware de tronco analógico e digital). O Asterisk acessa muitos arquivos em disco para tudo, desde informações de configuração até armazenamento de correio de voz.

A maioria dos sistemas limita o número de descritores de arquivo que o Asterisk pode ter abertos de uma só vez. Isso pode limitar o número de chamadas simultâneas que seu sistema pode manipular. Por exemplo, se o limite for definido em 1024 (um valor padrão comum), o Asterisk pode lidar com aproximadamente 150 chamadas SIP simultaneamente. Para alterar o número de descritores de arquivo, siga as instruções para o seu sistema abaixo:

SISTEMA LINUX BASEADO EM PAM

Se seu sistema usa PAM (Pluggable Authentication Modules), edite /etc/security/limits.conf. Adicione estas linhas ao final do arquivo:

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

(ajuste os números a gosto). Pode ser necessário reinicializar o sistema para que essas alterações entrem em vigor.

SISTEMA UNIX GENÉRICO

Se não houver instruções especificamente adaptadas ao seu sistema acima, você pode tentar adicionar o comando ulimit -n 8192 ao script que inicia o Asterisk.

MAIS INFORMAÇÕES

Visite o site Documentação do Asterisk para mais documentação sobre vários recursos e leia todos os exemplos de configuração que incluem documentação sobre as opções de configuração.

Finalmente, você pode desejar participar dos Fóruns da Comunidade Asterisk

Bem-vindo à crescente comunidade mundial de usuários do Asterisk!

        Mark Spencer, and the Asterisk.org development community

Asterisk é uma marca registrada da Sangoma Technologies Corporation

[Sangoma] [Página Inicial] [Suporte] [Documentação] [Fóruns da Comunidade] [Notas de Lançamento] [Segurança] [Arquivo da Lista de Discussão]