
asterisk v23.5.0-rc2
Официальный репозиторий проекта Asterisk.
Asterisk(R) — Открытая АТС
By Mark Spencer <[email protected]> and the Asterisk.org developer community.
Copyright (C) 2001-2025 Sangoma Technologies Corporation and other copyright holders.
БЕЗОПАСНОСТЬ
Крайне важно, чтобы вы прочитали и полностью поняли содержание документа по безопасности, прежде чем пытаться настроить и запустить сервер Asterisk.
См. Важные соображения по безопасности для получения дополнительной информации.
ЧТО ТАКОЕ ASTERISK?
Asterisk — это открытая АТС и набор инструментов для телефонии. В некотором смысле это «промежуточное ПО» между каналами Интернета и телефонии снизу и приложениями Интернета и телефонии сверху. Однако Asterisk поддерживает гораздо больше интерфейсов телефонии, чем только интернет-телефонию. Asterisk также имеет обширную поддержку традиционной телефонии TфОП.
Для получения дополнительной информации о проекте посетите домашнюю страницу Asterisk и официальную документацию Asterisk.
ПОДДЕРЖИВАЕМЫЕ ОПЕРАЦИОННЫЕ СИСТЕМЫ
Linux
Открытая АТС Asterisk разрабатывается и тестируется в первую очередь в операционной системе GNU/Linux и поддерживается во всех основных дистрибутивах GNU/Linux.
Другие
Asterisk также был «портирован» и, по сообщениям, корректно работает на других операционных системах, включая Apple Mac OS X и варианты BSD.
НАЧАЛО РАБОТЫ
В настоящее время большинство пользователей используют исключительно VoIP/SIP, но если вам необходимо взаимодействовать с TDM или аналоговыми службами или устройствами, убедитесь, что у вас есть поддерживаемое оборудование.
Поддерживаемое телефонное оборудование включает:
- Все аналоговые и цифровые интерфейсные карты от Sangoma
- Любая полнодуплексная звуковая карта, поддерживаемая PortAudio
- Канальный банк Xorcom Astribank
ОБНОВЛЕНИЕ С БОЛЕЕ РАННЕЙ ВЕРСИИ
Если вы обновляетесь с предыдущей версии Asterisk, обязательно прочитайте журналы изменений.
НОВЫЕ УСТАНОВКИ
Убедитесь, что ваша система содержит совместимый компилятор и библиотеки разработки. Asterisk требует либо GNU Compiler Collection (GCC) версии 4.1 или выше, либо компилятор, поддерживающий спецификацию C99 и некоторые расширения языка gcc. Кроме того, ваша система должна иметь заголовочные файлы библиотеки C, а также заголовочные файлы и библиотеки для ncurses.
Существует множество модулей, имеющих дополнительные зависимости. Чтобы увидеть,
какие библиотеки ищутся, смотрите ./configure --help или выполните
make menuselect для просмотра зависимостей конкретных модулей.
Во многих дистрибутивах эти зависимости устанавливаются пакетами с именами
'glibc-devel', 'ncurses-devel', 'openssl-devel' и 'zlib-devel'
или аналогичными. Скрипт contrib/scripts/install_prereq можно использовать для установки
зависимостей для большинства дистрибутивов Linux на основе Debian и Redhat.
Скрипт также поддерживает SUSE, Arch, Gentoo, FreeBSD, NetBSD и OpenBSD, но
эти дистрибутивы могут иметь неполную поддержку или устаревшие версии.
Итак, приступим:
-
Прочитайте документацию.
На веб-сайте Документация Asterisk есть полная информация по сборке, установке, настройке и запуску Asterisk. -
Выполните
./configure
Запустите скрипт configure для определения значений системно-зависимых переменных, используемых во время компиляции. Если скрипт укажет на отсутствие некоторых необходимых компонентов, вы можете выполнить./contrib/scripts/install_prereq installдля установки необходимых компонентов. Обратите внимание, что это установит все зависимости для всех функций Asterisk. После выполнения скрипта вам нужно будет повторно запустить./configure. -
Выполните
make menuselect
Это необходимо, если вы хотите выбрать модули, которые будут скомпилированы, и проверить зависимости различных опциональных модулей. -
Выполните
make
Предполагая, что сборка завершилась успешно: -
Выполните
make install
Если вы впервые работаете с Asterisk, вы можете установить образец АТС с демонстрационными добавочными номерами и т.д. Если да, то выполните: -
Выполните
make samples
Это перезапишет все существующие конфигурационные файлы, которые у вас установлены. -
Наконец, вы можете запустить Asterisk в режиме переднего плана (не демон) с помощью
asterisk -vvvc
Вы увидите множество подробных сообщений, проносящихся по экрану, пока Asterisk инициализируется (это режим «очень-очень подробный»). Когда он будет готов, если вы указали «c», вы получите командную строку консоли, которая выглядит так:
*CLI>
В любой момент вы можете ввестиcore show helpдля получения справки по системе. Для справки по конкретной команде введитеcore show help <команда>.
man asterisk в командной строке Unix/Linux выдаст подробную
информацию о том, как запускать и останавливать Asterisk, а также все параметры
командной строки для запуска Asterisk.
О КОНФИГУРАЦИОННЫХ ФАЙЛАХ
Все конфигурационные файлы Asterisk имеют общий формат. Комментарии
обозначаются символом ; (поскольку #, будучи DTMF-цифрой, может встречаться
во многих местах). Конфигурационный файл разделён на секции, имена которых
указываются в []. Каждая секция обычно содержит инструкции в форме
variable = value, хотя в старых образцах может встречаться variable => value.
ОСОБОЕ ПРИМЕЧАНИЕ О ВРЕМЕНИ
Пользователям SIP-телефонов следует знать, что Asterisk чувствителен к большим скачкам времени. Ручное изменение системного времени с помощью date(1) (или других подобных команд) может привести к сбоям регистрации SIP и других внутренних процессов. По этой причине всегда следует использовать пакет синхронизации времени для поддержания точности системного времени. Все ОС/дистрибутивы предоставляют один или несколько из следующих пакетов:
- ntpd/ntpsec
- chronyd
- systemd-timesyncd
Обязательно установите и настройте один (и только один) из них.
ФАЙЛОВЫЕ ДЕСКРИПТОРЫ
В зависимости от размера вашей системы и её конфигурации Asterisk может потреблять большое количество файловых дескрипторов. В UNIX файловые дескрипторы используются не только для файлов на диске. Они также используются для обработки сетевого взаимодействия (например, вызовы SIP, IAX2 или H.323) и доступа к аппаратному обеспечению (например, аналоговое и цифровое магистральное оборудование). Asterisk обращается ко многим файлам на диске для всего: от конфигурационной информации до хранения голосовой почты.
Большинство систем ограничивают количество файловых дескрипторов, которые Asterisk может иметь открытыми одновременно. Это может ограничить количество одновременных вызовов, которые может обрабатывать ваша система. Например, если лимит установлен на 1024 (обычное значение по умолчанию), Asterisk может обрабатывать примерно 150 одновременных вызовов SIP. Чтобы изменить количество файловых дескрипторов, следуйте инструкциям для вашей системы ниже:
СИСТЕМА LINUX НА ОСНОВЕ PAM
Если ваша система использует PAM (Pluggable Authentication Modules), отредактируйте
/etc/security/limits.conf. Добавьте следующие строки в конец файла:
root soft nofile 4096
root hard nofile 8196
asterisk soft nofile 4096
asterisk hard nofile 8196
(отрегулируйте числа по своему усмотрению). Возможно, потребуется перезагрузить систему, чтобы изменения вступили в силу.
ОБЩАЯ СИСТЕМА UNIX
Если выше нет инструкций, специально адаптированных для вашей системы,
вы можете попробовать добавить команду ulimit -n 8192 в скрипт,
запускающий Asterisk.
ДОПОЛНИТЕЛЬНАЯ ИНФОРМАЦИЯ
Посетите веб-сайт Документация Asterisk для получения дополнительной документации по различным функциям и, пожалуйста, прочитайте все образцы конфигурации, содержащие документацию по параметрам настройки.
Наконец, вы можете присоединиться к Форумам сообщества Asterisk
Добро пожаловать в растущее всемирное сообщество пользователей Asterisk!
Mark Spencer, and the Asterisk.org development community
Asterisk является торговой маркой Sangoma Technologies Corporation
[Sangoma] [Домашняя страница] [Поддержка] [Документация] [Форумы сообщества] [Примечания к выпускам] [Безопасность] [Архив списков рассылки]