Kurulum kılavuzu

MaxiPBX'i sunucunuza kurun

PBX'inizin alan adından arayüze ilk erişiminize kadar on adım. Önce FQDN'i ve güvenlik duvarını hazırlarsınız, ardından Control Plane SSH üzerinden çalıştıracağınız benzersiz bir betik oluşturur ve son olarak yapılandırmayı bir web sihirbazı devralır.

Başlamadan önce

  • Üzerinde başka hiçbir hizmet veya uygulama bulunmayan, yeni kurulmuş bir Debian 13 sunucusu.
  • root hesabıyla (veya root olabilen bir hesapla) SSH erişimi.
  • PBX'inizin FQDN'ini oluşturmak için DNS bölgesini yönettiğiniz bir alan adı (örneğin pbx.yourdomain.com).
  • my.maxipbx.com adresindeki MaxiPBX Control Plane üzerinde bir hesap.
  • Gerekli portları açmak için sunucunun önündeki güvenlik duvarına veya yönlendiriciye erişim.
Kurulumdan önce

Ağı hazırlayın

  1. Adım 1 : Sunucunuzun FQDN'ini oluşturun

    Her şeyden önce PBX'inize tam nitelikli bir alan adı (FQDN) verin, örneğin pbx.yourdomain.com. Alan adınızın DNS bölgesinde bu adı sunucunuzun IP adresine yönlendirin:

    DikkatKurulumu başlattığınız anda (adım 8) FQDN'in sunucunuza zaten yönlendirilmiş olması gerekir. İlk olarak bunu oluşturun.

    AdTürDeğer
    pbx.yourdomain.com A Sunucunuzun IPv4 adresiZorunlu
    pbx.yourdomain.com AAAA Sunucunuzun IPv6 adresiSunucunuzun bir IPv6 adresi varsa

    İpucuBir DNS değişikliğinin yayılması birkaç dakika sürebilir. Adın sunucunuzun IP adresiyle yanıt verdiğini doğrulamak için bilgisayarınızdan “ping pbx.yourdomain.com” komutunu çalıştırın.

  2. Adım 2 : Güvenlik duvarı portlarını açın

    PBX'in, tam olarak ihtiyaç duyduğu portları açan kendi güvenlik duvarı vardır. Önünde bir güvenlik duvarı veya yönlendirici bulunuyorsa (barındırma sağlayıcısının güvenlik duvarı, kurumsal yönlendirici, internet modemi), aşağıdaki tüm portları bu cihaz üzerinde dışarıdan PBX'e doğru açın.

    Dikkat8443 TCP portu yalnızca kurulum sırasında gereklidir: kurulum sihirbazı tarafından kullanılır (adım 10). Kurulumu başlatmadan önce açın, PBX etkinleştirildikten sonra yeniden kapatın: artık gerekli değildir.

    PortProtokolHizmetNe işe yarar
    8443 Yalnızca kurulum sırasında TCP Sihirbaz Kurulum sihirbazı (adım 10). PBX etkinleştirildikten sonra yeniden kapatın
    80 TCP Nginx HTTP üzerinden telefon provisioning'i, Let's Encrypt sertifikasının yenilenmesi
    443 TCP Nginx Web arayüzü, API, mobil ve masaüstü uygulamalar, web telefonu (WebRTC), HTTPS provisioning
    5060 UDP + TCP Kamailio SIP: telefonlar, softphone'lar, operatör trunk'ları
    5061 TCP Kamailio Şifreli SIP (TLS), ECDSA sertifikası
    5062 TCP Kamailio Şifreli SIP (TLS), ECDSA desteklemeyen telefonlar için RSA sertifikası
    30000-40000 UDP rtpengine Tüm çağrıların sesi (RTP): bu portlar olmadan ses iletilmez
    3478-3479 UDP + TCP coturn STUN/TURN: NAT arkasındaki uygulamaların ve web telefonunun sesi
    5349-5350 UDP + TCP coturn Şifreli TURN (TLS), kısıtlayıcı ağlarda aynı işlev
    389 TCP MaxiPBX API Telefonlar için LDAP rehberi
    10389 TCP MaxiPBX API Bazı modeller için alternatif porttaki LDAP rehberi
    22 TCP SSH MaxiPBX tarafından uzaktan yönetim ve bakım. Yalnızca IP adreslerimizle sınırlandırılabilir

    İpucuPBX bir NAT arkasındaysa (özel IP adresi), bu listedeki tüm portlar için aynı RTP aralığı 30000-40000 UDP ile birlikte dahili IP adresine port yönlendirmesi yapın.

Control Plane'de

Kurulum anahtarınızı oluşturun

  1. Adım 3 : Control Plane'e giriş yapın

    Tarayıcınızda my.maxipbx.com adresini açın ve hesabınızla giriş yapın. Tüm PBX filonuzu Control Plane üzerinden yönetirsiniz.

    Control Plane'i aç
  2. Adım 4 : PBX listenizi açın

    Menüde “PBX Filosu” bölümüne gidin, ardından “PBX” öğesine tıklayın. Burada hesabınıza bağlı tüm PBX'leri görürsünüz.

  3. Adım 5 : Bir kurulum anahtarı oluşturun

    “Kurulum anahtarı oluştur” düğmesine tıklayın. Bu anahtar, kurulacak sunucuyu hesabınıza bağlar: kurulum tamamlandığında sunucu doğrudan filonuzda görünür.

  4. Adım 6 : Kurulum betiğini görüntüleyin ve kopyalayın

    Kurulum betiğini görüntüleyin ve tamamını kopyalayın. Betik anahtarınızı zaten içerir: üzerinde herhangi bir değişiklik yapmanız gerekmez.

    DikkatBetik, hesabınıza özgü bir anahtar içerir. Bunu kimseyle paylaşmayın ve hiçbir yerde yayımlamayın.

Sunucunuzda

Kurulumu başlatın

  1. Adım 7 : root hesabıyla SSH üzerinden bağlanın

    Bir terminalden (veya Windows'ta PuTTY gibi bir istemciden) yeni Debian 13 sunucunuza root hesabıyla bağlanın. YOUR_IP ifadesini sunucunuzun IP adresiyle değiştirin.

    ssh root@YOUR_IP

    İpucuBaşka bir hesapla oturum açtıysanız, devam etmeden önce “su -” veya “sudo -i” komutuyla root hesabına geçin.

  2. Adım 8 : Betiği yapıştırın ve onaylayın

    Adım 6'da kopyaladığınız kurulum betiğini terminale yapıştırın, ardından Enter tuşuna basın.

  3. Adım 9 : Kurulumun tamamlanmasını bekleyin

    Kurulumun ilerleyişi ekranda adım adım görüntülenir. Hiçbir şeye dokunmadan sonuna kadar çalışmasına izin verin.

    DikkatKurulum sırasında terminali kapatmayın ve SSH bağlantısını kesmeyin.

Tarayıcınızda

Yapılandırmayı tamamlayın

  1. Adım 10 : Kurulum sihirbazını açın

    Kurulumun sonunda terminal, PBX'inizin adresini aşağıdaki biçimde görüntüler. Bu adresi tarayıcınızda açın ve kurulum sihirbazını izleyin: sihirbaz ilk yapılandırma boyunca size rehberlik eder.

    https://YOUR_IP:8443

    İpucuBu ilk erişimde tarayıcınız sertifikayla ilgili bir güvenlik uyarısı gösterirse, sihirbazı başlatmak için siteye devam edebilirsiniz.

    Yardım mı gerekiyor?Sihirbaz sırasında herhangi bir tereddüdünüz olursa MaxiPBX bayi iş ortağınızla iletişime geçmekten çekinmeyin: size destek olmak için oradadır.

PBX'iniz kuruldu

Sihirbaz tamamlandığında PBX'iniz kullanıma hazırdır ve Control Plane'deki filonuza bağlanmıştır. Artık kullanıcılarınızı, telefonlarınızı ve hatlarınızı oluşturabilirsiniz.

Yardıma mı ihtiyacınız var?

Ekibimiz kurulum sırasında size destek olabilir veya kurulumu sizin yerinize üstlenebilir.