
asterisk v23.5.0-rc2
Asterisk 프로젝트의 공식 저장소.
Asterisk(R) 오픈소스 PBX
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는 오픈소스 PBX 및 전화 통신 툴킷입니다. 어떤 의미에서는 하위 계층의 인터넷 및 전화 통신 채널과 상위 계층의 인터넷 및 전화 통신 애플리케이션 간의 미들웨어 역할을 합니다. 그러나 Asterisk는 인터넷 전화 통신뿐만 아니라 더 많은 전화 통신 인터페이스를 지원합니다. 또한 Asterisk는 기존 PSTN 전화 통신에 대한 방대한 지원도 제공합니다.
프로젝트에 대한 자세한 내용은 Asterisk 홈페이지와 공식 Asterisk 문서를 방문하십시오.
지원되는 운영 체제
Linux
Asterisk 오픈소스 PBX는 주로 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 스크립트는 대부분의 Debian 및 Redhat 기반 Linux 배포판에서 종속성을 설치하는 데 사용할 수 있습니다. 이 스크립트는 SUSE, Arch, Gentoo, FreeBSD, NetBSD 및 OpenBSD도 처리하지만, 해당 배포판에서는 완전한 지원이 없거나 최신 상태가 아닐 수 있습니다.
그럼 시작해 보겠습니다:
-
문서를 읽으십시오.
Asterisk 문서 웹사이트에는 Asterisk 빌드, 설치, 구성 및 실행에 대한 전체 정보가 있습니다. -
./configure실행
구성 스크립트를 실행하여 컴파일 중 사용되는 시스템 종속 변수의 값을 추정합니다. 스크립트가 일부 필요한 구성 요소가 누락되었다고 표시하면./contrib/scripts/install_prereq install을 실행하여 필요한 구성 요소를 설치할 수 있습니다. 이렇게 하면 Asterisk의 모든 기능에 대한 모든 종속성이 설치됩니다. 스크립트를 실행한 후./configure를 다시 실행해야 합니다. -
make menuselect실행
컴파일할 모듈을 선택하고 다양한 선택적 모듈의 종속성을 확인하려면 이 단계가 필요합니다. -
make실행
빌드가 성공적으로 완료되었다고 가정합니다: -
make install실행
Asterisk를 처음 사용하는 경우 데모 확장 등이 포함된 샘플 PBX를 설치할 수 있습니다. 그렇다면 다음을 실행하십시오: -
make samples실행
이렇게 하면 기존 구성 파일이 모두 덮어쓰기됩니다. -
마지막으로,
asterisk -vvvc를 사용하여 Asterisk를 포그라운드 모드(데몬 아님)로 실행할 수 있습니다.
Asterisk가 초기화되면 화면에 많은 자세한 메시지가 지나갑니다("매우 자세한" 모드). 준비가 되면 "c" 옵션을 지정했다면 다음과 같은 명령줄 콘솔이 나타납니다:
*CLI>
언제든지core show help를 입력하여 시스템 도움말을 확인할 수 있습니다. 특정 명령에 대한 도움말은core show help <command>를 입력하십시오.
Unix/Linux 명령 프롬프트에서 man asterisk를 입력하면 Asterisk 시작 및 중지 방법과 시작 시 모든 명령줄 옵션에 대한 자세한 정보를 얻을 수 있습니다.
구성 파일에 관하여
모든 Asterisk 구성 파일은 공통 형식을 공유합니다. 주석은 ;으로 구분됩니다(#은 DTMF 숫자이므로 여러 곳에서 나타날 수 있기 때문). 구성 파일은 이름이 [] 안에 표시된 섹션으로 나뉩니다. 각 섹션에는 일반적으로 variable = value 형식의 문이 포함되지만, 이전 샘플에서는 variable => value를 볼 수도 있습니다.
시간에 관한 특별 참고 사항
SIP 전화를 사용하는 경우 Asterisk가 시간의 큰 변화에 민감하다는 점을 알아야 합니다. date(1)(또는 유사한 명령)을 사용하여 시스템 시간을 수동으로 변경하면 SIP 등록 및 기타 내부 프로세스가 실패할 수 있습니다. 따라서 시스템 시간을 정확하게 유지하려면 항상 시간 동기화 패키지를 사용해야 합니다. 모든 OS/배포판은 다음 패키지 중 하나 이상을 제공합니다:
- ntpd/ntpsec
- chronyd
- systemd-timesyncd
반드시 이 중 하나(하나만)를 설치하고 구성하십시오.
파일 디스크립터
시스템 크기와 구성에 따라 Asterisk는 많은 수의 파일 디스크립터를 사용할 수 있습니다. UNIX에서 파일 디스크립터는 디스크의 파일뿐만 아니라 네트워크 통신(예: SIP, IAX2, H.323 호출) 및 하드웨어 액세스(예: 아날로그 및 디지털 트렁크 하드웨어)를 처리하는 데도 사용됩니다. Asterisk는 구성 정보부터 음성 메일 저장에 이르기까지 모든 것에 대해 많은 디스크 내 파일에 액세스합니다.
대부분의 시스템은 Asterisk가 한 번에 열 수 있는 파일 디스크립터 수를 제한합니다. 이로 인해 시스템이 처리할 수 있는 동시 호출 수가 제한될 수 있습니다. 예를 들어, 제한이 1024(일반적인 기본값)로 설정된 경우 Asterisk는 약 150개의 SIP 호출을 동시에 처리할 수 있습니다. 파일 디스크립터 수를 변경하려면 아래 시스템 지침을 따르십시오:
PAM 기반 Linux 시스템
시스템이 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 시스템
위에 시스템에 특별히 적용된 지침이 없는 경우 Asterisk를 시작하는 스크립트에 ulimit -n 8192 명령을 추가해 볼 수 있습니다.
추가 정보
다양한 기능에 대한 더 많은 문서는 Asterisk 문서 웹사이트를 방문하고 구성 옵션에 대한 설명이 포함된 모든 구성 샘플을 읽어보십시오.
마지막으로, Asterisk 커뮤니티 포럼에 가입하실 수 있습니다.
계속 성장하는 전 세계 Asterisk 사용자 커뮤니티에 오신 것을 환영합니다!
Mark Spencer, and the Asterisk.org development community
Asterisk는 Sangoma Technologies Corporation의 상표입니다.
[Sangoma] [홈페이지] [지원] [문서] [커뮤니티 포럼] [릴리스 노트] [보안] [메일링 리스트 아카이브]