Panduan instalasi

Instal MaxiPBX di server Anda

Sepuluh langkah, dari nama domain PBX Anda hingga akses pertama ke antarmuka. Pertama, Anda menyiapkan FQDN dan firewall, kemudian Control Plane membuat skrip unik yang Anda jalankan melalui SSH, lalu wizard web mengambil alih untuk konfigurasi.

Sebelum memulai

  • Server Debian 13 yang baru diinstal, tanpa layanan atau aplikasi lain di dalamnya.
  • Akses SSH dengan akun root (atau akun yang dapat beralih menjadi root).
  • Nama domain yang zona DNS-nya Anda kelola, untuk membuat FQDN PBX Anda (misalnya pbx.yourdomain.com).
  • Akun di MaxiPBX Control Plane, di my.maxipbx.com.
  • Akses ke firewall atau router di depan server, untuk membuka port yang diperlukan.
Sebelum instalasi

Siapkan jaringan

  1. Langkah 1 : Buat FQDN server Anda

    Pertama-tama, berikan nama domain lengkap (FQDN) untuk PBX Anda, misalnya pbx.yourdomain.com. Di zona DNS domain Anda, arahkan nama ini ke alamat IP server Anda:

    PerhatianFQDN harus sudah mengarah ke server Anda saat Anda memulai instalasi (langkah 8). Buatlah terlebih dahulu.

    NamaTipeNilai
    pbx.yourdomain.com A Alamat IPv4 server AndaWajib
    pbx.yourdomain.com AAAA Alamat IPv6 server AndaJika server Anda memiliki alamat IPv6

    TipsPerubahan DNS dapat memerlukan beberapa menit untuk tersebar. Untuk memeriksa bahwa nama tersebut mengarah ke IP server Anda, jalankan “ping pbx.yourdomain.com” dari komputer Anda.

  2. Langkah 2 : Buka port firewall

    PBX memiliki firewall sendiri, yang hanya membuka port yang dibutuhkannya. Jika ada firewall atau router di depannya (firewall penyedia hosting, router perusahaan, modem internet), buka semua port di bawah ini pada perangkat tersebut, dari luar menuju PBX.

    PerhatianPort 8443 TCP hanya diperlukan selama instalasi: port ini digunakan oleh wizard instalasi (langkah 10). Buka port ini sebelum memulai instalasi, lalu tutup kembali setelah PBX diaktifkan: port ini tidak lagi diperlukan.

    PortProtokolLayananKegunaan
    8443 Hanya selama instalasi TCP Wizard Wizard instalasi (langkah 10). Tutup kembali setelah PBX diaktifkan
    80 TCP Nginx Provisioning telepon melalui HTTP, perpanjangan sertifikat Let's Encrypt
    443 TCP Nginx Antarmuka web, API, aplikasi seluler dan desktop, telepon web (WebRTC), provisioning HTTPS
    5060 UDP + TCP Kamailio SIP: telepon, softphone, trunk operator
    5061 TCP Kamailio SIP terenkripsi (TLS), sertifikat ECDSA
    5062 TCP Kamailio SIP terenkripsi (TLS), sertifikat RSA untuk telepon yang tidak mendukung ECDSA
    30000-40000 UDP rtpengine Suara (RTP) untuk semua panggilan: tanpa port ini, tidak ada audio
    3478-3479 UDP + TCP coturn STUN/TURN: audio untuk aplikasi dan telepon web di balik NAT
    5349-5350 UDP + TCP coturn TURN terenkripsi (TLS), peran yang sama pada jaringan yang ketat
    389 TCP MaxiPBX API Direktori LDAP untuk telepon
    10389 TCP MaxiPBX API Direktori LDAP pada port alternatif, untuk model tertentu
    22 TCP SSH Administrasi jarak jauh dan pemeliharaan oleh MaxiPBX. Dapat dibatasi ke alamat IP kami

    TipsJika PBX berada di balik NAT (alamat IP privat), atur penerusan port (port forwarding) untuk seluruh daftar ini ke IP internalnya, dengan rentang RTP yang sama 30000-40000 UDP.

Di Control Plane

Buat kunci instalasi Anda

  1. Langkah 3 : Masuk ke Control Plane

    Buka my.maxipbx.com di browser Anda dan masuk dengan akun Anda. Control Plane adalah tempat Anda mengelola seluruh armada PBX Anda.

    Buka Control Plane
  2. Langkah 4 : Buka daftar PBX Anda

    Di menu, buka “Armada PBX”, lalu klik “PBX”. Di sana Anda akan melihat semua PBX yang sudah terhubung ke akun Anda.

  3. Langkah 5 : Buat kunci instalasi

    Klik “Buat kunci instalasi”. Kunci ini menghubungkan server yang akan diinstal ke akun Anda: setelah terinstal, server akan langsung muncul di armada Anda.

  4. Langkah 6 : Tampilkan dan salin skrip instalasi

    Tampilkan skrip instalasi dan salin seluruhnya. Skrip sudah berisi kunci Anda: Anda tidak perlu mengubah apa pun di dalamnya.

    PerhatianSkrip berisi kunci khusus untuk akun Anda. Jangan bagikan atau publikasikan di mana pun.

Di server Anda

Jalankan instalasi

  1. Langkah 7 : Hubungkan melalui SSH dengan akun root

    Dari terminal (atau klien seperti PuTTY di Windows), hubungkan ke server Debian 13 baru Anda dengan akun root. Ganti YOUR_IP dengan alamat IP server Anda.

    ssh root@YOUR_IP

    TipsJika Anda masuk dengan akun lain, beralihlah ke root dengan perintah “su -” atau “sudo -i” sebelum melanjutkan.

  2. Langkah 8 : Tempel skrip dan tekan Enter

    Tempel skrip instalasi yang disalin pada langkah 6 ke terminal, lalu tekan Enter.

  3. Langkah 9 : Biarkan instalasi berjalan

    Kemajuan instalasi ditampilkan di layar secara bertahap. Biarkan hingga selesai tanpa menyentuh apa pun.

    PerhatianJangan menutup terminal atau memutus koneksi SSH selama instalasi.

Di browser Anda

Selesaikan konfigurasi

  1. Langkah 10 : Buka wizard instalasi

    Di akhir instalasi, terminal menampilkan alamat PBX Anda dalam format di bawah ini. Buka alamat tersebut di browser Anda, lalu ikuti wizard instalasi: wizard akan memandu Anda melalui konfigurasi awal.

    https://YOUR_IP:8443

    TipsJika browser Anda menampilkan peringatan keamanan tentang sertifikat pada akses pertama ini, Anda dapat melanjutkan ke situs untuk menjalankan wizard.

    Butuh bantuan?Jika Anda ragu saat menggunakan wizard, jangan ragu untuk menghubungi mitra reseller MaxiPBX Anda: mereka siap mendampingi Anda.

PBX Anda telah terinstal

Setelah wizard selesai, PBX Anda siap digunakan dan terhubung ke armada Anda di Control Plane. Kini Anda dapat membuat pengguna, telepon, dan saluran.

Butuh bantuan?

Tim kami dapat mendampingi Anda selama instalasi atau melakukannya untuk Anda.