유사 사이트를 조심하세요. 한국에이아이통신(주)의 공식 사이트는 katel.kr · katcloud.kr · zerocall.kr · aicallpay.com 입니다.공식 채널 확인
KAT CloudKOEN로그인

FreeSWITCH SIP 게이트웨이 설정: external 프로필과 gateway로 트렁크 연결하기

FreeSWITCH에서 외부 SIP 트렁크는 external 프로필 아래 gateway로 정의하고, 들어온 통화는 public 컨텍스트에서, 거는 통화는 sofia/gateway 경로로 처리합니다. 개념과 자리표시자 예시, 점검 명령을 정리했습니다.

가이드한국에이아이통신(주) KAT Cloud 팀5분 읽기
FreeSWITCH SIP 게이트웨이 설정: external 프로필과 gateway로 트렁크 연결하기

FreeSWITCH에서 외부 SIP 트렁크는 Sofia SIP 모듈의 external 프로필 아래에 gateway로 정의합니다. 프로필은 "어느 IP·포트로 SIP를 듣고, NAT에서 어떤 공인 주소를 쓰고, 어떤 코덱을 제안할지"를 정하고, gateway는 "어느 상대 서버에, 어떤 계정으로, 등록할지 말지"를 정합니다. 들어온 통화는 보통 public 컨텍스트 다이얼플랜에서 받고, 거는 통화는 sofia/gateway/<이름>/<번호>로 내보냅니다. KAT Cloud의 실제 SIP 접속 정보는 콘솔 또는 도입 상담으로 받으며, 이 글의 값은 모두 자리표시자입니다.

프로필과 게이트웨이의 관계

FreeSWITCH 기본 구성에는 보통 두 개의 SIP 프로필이 있습니다. 내선 전화기를 받는 internal과 외부 사업자를 상대하는 external입니다. 트렁크는 external 쪽에 붙입니다.

구성위치(기본 구성 기준)정하는 것
프로필sip_profiles/external.xml수신 IP·포트, 외부 주소, 기본 컨텍스트, 코덱
게이트웨이sip_profiles/external/*.xml상대 서버, 계정, 등록 여부, 상태 확인
받는 통화dialplan/public/*.xml착신번호별 처리
거는 통화dialplan/default/*.xml 등내선 → 게이트웨이 경로

게이트웨이 하나가 SIP 트렁크 하나라고 보면 이해가 쉽습니다. 상대 사업자가 여러 개면 게이트웨이 파일을 여러 개 둡니다.

게이트웨이 예시

sip.example.com과 계정 값은 실제 KAT Cloud 정보가 아닙니다.

xml
<include>
  <gateway name="trunk">
    <param name="proxy" value="sip.example.com"/>
    <param name="realm" value="sip.example.com"/>
    <param name="username" value="EXAMPLE_USER"/>
    <param name="password" value="EXAMPLE_PASSWORD"/>
    <param name="register" value="true"/>
    <param name="caller-id-in-from" value="true"/>
    <param name="ping" value="30"/>
  </gateway>
</include>
  • register: 등록형 트렁크면 true, IP 인증형이면 false로 두고 상대에게 내 공인 IP를 허용 등록합니다. 두 방식의 차이는 REGISTER vs IP 인증에 정리했습니다.
  • ping: 주기적으로 OPTIONS를 보내 상대가 살아 있는지 봅니다. 응답이 없으면 게이트웨이가 DOWN으로 표시됩니다.
  • caller-id-in-from: 발신번호를 From 헤더에 넣을지 정합니다. 상대가 어떤 헤더로 발신번호를 받는지에 맞춥니다.

external 프로필에서 볼 항목

xml
<param name="sip-port" value="5080"/>
<param name="context" value="public"/>
<param name="ext-sip-ip" value="198.51.100.20"/>
<param name="ext-rtp-ip" value="198.51.100.20"/>
<param name="inbound-codec-prefs" value="PCMU"/>
<param name="outbound-codec-prefs" value="PCMU"/>
  • 코덱: KAT Cloud는 G.711 μ-law(PCMU)와 A-law(PCMA)를 지원합니다. 국내 구간은 PCMU가 기본이므로 PCMU를 앞에 둡니다.
  • 외부 주소: 서버가 사설망 안에 있으면 ext-sip-ip, ext-rtp-ip에 공인 IP를 적어야 SDP에 사설 IP가 실리지 않습니다. 빠뜨리면 단방향 음성이 생기기 쉽습니다.
  • 포트: 기본 구성에서 external은 5080을 쓰는 경우가 많습니다. 상대에게 알려 준 포트와 실제 프로필 포트가 같은지 확인하세요.

다이얼플랜으로 통화 처리

받는 통화는 public 컨텍스트에서 착신번호로 잡습니다.

xml
<extension name="from-trunk">
  <condition field="destination_number" expression="^(\+?82)?0?70\d{7,8}$">
    <action application="answer"/>
    <action application="transfer" data="ai-agent XML default"/>
  </condition>
</extension>

거는 통화는 게이트웨이로 bridge 합니다.

xml
<extension name="to-trunk">
  <condition field="destination_number" expression="^(0\d{8,10})$">
    <action application="bridge" data="sofia/gateway/trunk/$1"/>
  </condition>
</extension>

정규식은 예시입니다. 착신번호가 국내형으로 오는지 국제형으로 오는지 첫 시험 통화 로그로 확인한 뒤 맞추세요. 받은 통화를 음성 AI로 넘기는 설계는 기존 PBX에 AI 붙이기와 RTP와 음성 코덱을 함께 보면 좋습니다.

점검 명령

fs_cli 명령보는 것
sofia status프로필·게이트웨이 상태 요약
sofia status gateway trunk등록 상태(REGED), ping 결과
sofia profile external rescan새 게이트웨이 파일 반영
sofia global siptrace onSIP 메시지 원문 출력

응답 코드로 원인을 좁히는 방법은 SIP 응답 코드 읽는 법에 있습니다.

KAT Cloud의 SIP 직접 연결은 모든 플랜에서 무료입니다(기능, 요금). KAT Cloud 가입하기로 7일 무료 체험을 시작하거나, 구성이 복잡하다면 도입 상담을 신청하세요.

자주 묻는 질문

FreeSWITCH 게이트웨이가 DOWN으로 나오면 무엇을 확인하나요?

FreeSWITCH 게이트웨이가 DOWN이면 ping으로 보낸 OPTIONS에 상대가 응답하지 않는다는 뜻입니다. 상대 주소와 포트, 방화벽의 SIP 포트 허용, IP 인증형이라면 상대 쪽에 내 공인 IP가 등록되었는지를 차례로 확인하세요.

KAT Cloud와 연결할 때 FreeSWITCH 코덱은 무엇으로 두나요?

KAT Cloud는 G.711 μ-law(PCMU)와 A-law(PCMA)를 지원하므로 FreeSWITCH 프로필의 코덱 우선순위에 PCMU를 앞에 두고, 필요하면 PCMA를 뒤에 넣습니다.

들어온 통화가 FreeSWITCH 다이얼플랜에서 매칭되지 않는 이유는 무엇인가요?

FreeSWITCH에서 들어온 통화가 매칭되지 않는 흔한 이유는 프로필의 기본 컨텍스트와 다이얼플랜 위치가 다르거나, 착신번호 형식(국내형·국제형)이 정규식과 맞지 않는 경우입니다. SIP 트레이스로 실제 착신번호를 본 뒤 조건을 맞추세요.

  • #FreeSWITCH
  • #SIP 게이트웨이
  • #Sofia
  • #SIP 트렁크
  • #음성 서버

Get started

만든 AI에 전화번호 연결

070 번호 발급, SIP 직접 연결, 음성 AI 모델 연결, 문자·웹훅까지 API 하나로. 월 10,000원부터.