설치 가이드

서버에 MaxiPBX 설치하기

PBX 도메인 이름 설정부터 인터페이스 첫 로그인까지 총 10단계입니다. 먼저 FQDN과 방화벽을 준비하고, Control Plane에서 생성된 고유 스크립트를 SSH로 실행한 후, 웹 마법사가 이어서 설정을 진행합니다.

시작하기 전에

  • 다른 서비스나 애플리케이션이 없는 새로 설치된 Debian 13 서버.
  • root 계정으로의 SSH 접속 권한(또는 root로 전환할 수 있는 계정).
  • PBX의 FQDN(예: pbx.yourdomain.com)을 만들기 위해 DNS 영역을 관리할 수 있는 도메인 이름.
  • my.maxipbx.com의 MaxiPBX Control Plane 계정.
  • 필요한 포트를 열기 위한, 서버 앞단의 방화벽 또는 라우터에 대한 접근 권한.
설치 전

네트워크 준비

  1. 단계 1 : 서버의 FQDN 만들기

    먼저 PBX에 정규화된 도메인 이름(FQDN)을 지정하십시오(예: pbx.yourdomain.com). 도메인의 DNS 영역에서 이 이름이 서버의 IP 주소를 가리키도록 설정합니다.

    주의설치를 시작하는 시점(8단계)에는 FQDN이 이미 서버를 가리키고 있어야 합니다. 가장 먼저 만들어 주십시오.

    이름유형값
    pbx.yourdomain.com A 서버의 IPv4 주소필수
    pbx.yourdomain.com AAAA 서버의 IPv6 주소서버에 IPv6 주소가 있는 경우

    팁DNS 변경 사항이 반영되기까지 몇 분 정도 걸릴 수 있습니다. 이름이 서버의 IP로 확인되는지 점검하려면 컴퓨터에서 “ping pbx.yourdomain.com”을 실행하십시오.

  2. 단계 2 : 방화벽 포트 열기

    PBX에는 자체 방화벽이 있어 필요한 포트만 정확히 엽니다. 앞단에 방화벽이나 라우터(호스팅 업체 방화벽, 사내 라우터, 인터넷 공유기)가 있는 경우, 해당 장비에서 아래의 모든 포트를 외부에서 PBX 방향으로 열어 주십시오.

    주의포트 8443 TCP는 설치 중에만 필요합니다. 설치 마법사(10단계)에서 사용됩니다. 설치를 시작하기 전에 열고, PBX가 활성화되면 더 이상 필요하지 않으므로 다시 닫으십시오.

    포트프로토콜서비스용도
    8443 설치 중에만 TCP 마법사 설치 마법사(10단계). PBX 활성화 후에는 다시 닫으십시오
    80 TCP Nginx HTTP를 통한 전화기 프로비저닝, Let's Encrypt 인증서 갱신
    443 TCP Nginx 웹 인터페이스, API, 모바일 및 데스크톱 앱, 웹 전화(WebRTC), HTTPS 프로비저닝
    5060 UDP + TCP Kamailio SIP: 전화기, 소프트폰, 통신사 트렁크
    5061 TCP Kamailio 암호화된 SIP(TLS), ECDSA 인증서
    5062 TCP Kamailio 암호화된 SIP(TLS), ECDSA를 지원하지 않는 전화기용 RSA 인증서
    30000-40000 UDP rtpengine 모든 통화의 음성(RTP): 이 포트가 없으면 소리가 들리지 않습니다
    3478-3479 UDP + TCP coturn STUN/TURN: NAT 환경에서 앱 및 웹 전화의 오디오
    5349-5350 UDP + TCP coturn 암호화된 TURN(TLS), 제한적인 네트워크에서 동일한 역할
    389 TCP MaxiPBX API 전화기용 LDAP 디렉터리
    10389 TCP MaxiPBX API 대체 포트의 LDAP 디렉터리(일부 모델용)
    22 TCP SSH MaxiPBX의 원격 관리 및 유지보수. 당사 IP 주소로만 제한할 수 있습니다

    팁PBX가 NAT 뒤(사설 IP 주소)에 있는 경우, 이 목록의 모든 포트를 내부 IP로 포트 포워딩하십시오. RTP 범위도 동일하게 30000-40000 UDP입니다.

Control Plane에서

설치 키 생성

  1. 단계 3 : Control Plane에 로그인

    브라우저에서 my.maxipbx.com을 열고 계정으로 로그인하십시오. Control Plane에서 전체 PBX 플릿을 관리합니다.

    Control Plane 열기
  2. 단계 4 : PBX 목록 열기

    메뉴에서 “PBX 플릿”으로 이동한 다음 “PBX”를 클릭하십시오. 계정에 이미 연결된 모든 PBX가 표시됩니다.

  3. 단계 5 : 설치 키 생성

    “설치 키 생성”을 클릭하십시오. 이 키는 새 서버를 계정에 연결합니다. 설치가 완료되면 서버가 플릿에 바로 표시됩니다.

  4. 단계 6 : 설치 스크립트 표시 및 복사

    설치 스크립트를 표시하고 전체를 복사하십시오. 스크립트에 이미 키가 포함되어 있으므로 아무것도 변경할 필요가 없습니다.

    주의이 스크립트에는 계정 고유의 키가 포함되어 있습니다. 공유하거나 어디에도 게시하지 마십시오.

서버에서

설치 실행

  1. 단계 7 : root 계정으로 SSH 접속

    터미널(또는 Windows의 PuTTY 같은 클라이언트)에서 새로 설치한 Debian 13 서버에 root 계정으로 접속하십시오. YOUR_IP를 서버의 IP 주소로 바꾸십시오.

    ssh root@YOUR_IP

    팁다른 계정으로 로그인한 경우, 계속하기 전에 “su -” 또는 “sudo -i” 명령으로 root로 전환하십시오.

  2. 단계 8 : 스크립트를 붙여넣고 Enter 키 누르기

    6단계에서 복사한 설치 스크립트를 터미널에 붙여넣은 다음 Enter 키를 누르십시오.

  3. 단계 9 : 설치 진행 대기

    설치 진행 상황이 화면에 실시간으로 표시됩니다. 아무것도 건드리지 말고 끝까지 진행되도록 두십시오.

    주의설치 중에는 터미널을 닫거나 SSH 연결을 끊지 마십시오.

브라우저에서

설정 완료

  1. 단계 10 : 설치 마법사 열기

    설치가 끝나면 터미널에 PBX 주소가 아래와 같은 형식으로 표시됩니다. 브라우저에서 이 주소를 열고 설치 마법사를 따르십시오. 마법사가 초기 설정을 안내해 드립니다.

    https://YOUR_IP:8443

    팁처음 방문할 때 브라우저에 인증서 관련 보안 경고가 표시되면, 사이트로 계속 진행하여 마법사를 시작할 수 있습니다.

    도움이 필요하신가요?마법사를 사용하는 중 궁금한 점이 있으시면 언제든지 MaxiPBX 리셀러 파트너에게 문의하십시오. 파트너가 도와드립니다.

PBX 설치가 완료되었습니다

마법사가 완료되면 PBX를 사용할 준비가 되며 Control Plane의 플릿에 연결됩니다. 이제 사용자, 전화기 및 회선을 만들 수 있습니다.

도움이 필요하신가요?

당사 팀이 설치 과정을 지원해 드리거나 설치를 대신 진행해 드릴 수 있습니다.