Panduan pemasangan

Pasang MaxiPBX pada pelayan anda

Sepuluh langkah, daripada nama domain PBX anda hingga akses pertama ke antara muka. Mula-mula anda menyediakan FQDN dan tembok api, kemudian Control Plane menjana skrip unik yang anda jalankan melalui SSH, lalu wizard web mengambil alih untuk konfigurasi.

Sebelum anda bermula

  • Pelayan Debian 13 yang baru dipasang, tanpa sebarang perkhidmatan atau aplikasi lain.
  • Akses SSH dengan akaun root (atau akaun yang boleh bertukar menjadi root).
  • Nama domain yang zon DNSnya diurus oleh anda, untuk mencipta FQDN PBX anda (contohnya pbx.yourdomain.com).
  • Akaun pada MaxiPBX Control Plane, di my.maxipbx.com.
  • Akses ke tembok api atau penghala di hadapan pelayan, untuk membuka port yang diperlukan.
Sebelum pemasangan

Sediakan rangkaian

  1. Langkah 1 : Cipta FQDN pelayan anda

    Pertama sekali, berikan nama domain penuh (FQDN) kepada PBX anda, contohnya pbx.yourdomain.com. Dalam zon DNS domain anda, halakan nama ini ke alamat IP pelayan anda:

    PerhatianFQDN mesti sudah menghala ke pelayan anda semasa anda memulakan pemasangan (langkah 8). Ciptanya terlebih dahulu.

    NamaJenisNilai
    pbx.yourdomain.com A Alamat IPv4 pelayan andaWajib
    pbx.yourdomain.com AAAA Alamat IPv6 pelayan andaJika pelayan anda mempunyai alamat IPv6

    PetuaPerubahan DNS boleh mengambil masa beberapa minit untuk tersebar. Untuk menyemak bahawa nama tersebut menghala ke IP pelayan anda, jalankan “ping pbx.yourdomain.com” daripada komputer anda.

  2. Langkah 2 : Buka port tembok api

    PBX mempunyai tembok apinya sendiri, yang membuka hanya port yang diperlukannya. Jika terdapat tembok api atau penghala di hadapannya (tembok api penyedia pengehosan, penghala syarikat, modem internet), buka semua port di bawah pada peranti tersebut, dari luar ke PBX.

    PerhatianPort 8443 TCP hanya diperlukan semasa pemasangan: ia digunakan oleh wizard pemasangan (langkah 10). Bukanya sebelum memulakan pemasangan, kemudian tutup semula setelah PBX diaktifkan: ia tidak lagi diperlukan.

    PortProtokolPerkhidmatanKegunaan
    8443 Hanya semasa pemasangan TCP Wizard Wizard pemasangan (langkah 10). Tutup semula selepas PBX diaktifkan
    80 TCP Nginx Peruntukan telefon melalui HTTP, pembaharuan sijil Let's Encrypt
    443 TCP Nginx Antara muka web, API, aplikasi mudah alih dan desktop, telefon web (WebRTC), peruntukan HTTPS
    5060 UDP + TCP Kamailio SIP: telefon, softphone, trunk pengendali
    5061 TCP Kamailio SIP disulitkan (TLS), sijil ECDSA
    5062 TCP Kamailio SIP disulitkan (TLS), sijil RSA untuk telefon yang tidak menyokong ECDSA
    30000-40000 UDP rtpengine Suara (RTP) untuk semua panggilan: tanpa port ini, tiada audio
    3478-3479 UDP + TCP coturn STUN/TURN: audio untuk aplikasi dan telefon web di belakang NAT
    5349-5350 UDP + TCP coturn TURN disulitkan (TLS), peranan yang sama pada rangkaian yang terhad
    389 TCP MaxiPBX API Direktori LDAP untuk telefon
    10389 TCP MaxiPBX API Direktori LDAP pada port alternatif, untuk model tertentu
    22 TCP SSH Pentadbiran jauh dan penyelenggaraan oleh MaxiPBX. Boleh dihadkan kepada alamat IP kami

    PetuaJika PBX berada di belakang NAT (alamat IP peribadi), sediakan pemajuan port (port forwarding) untuk keseluruhan senarai ini ke IP dalamannya, dengan julat RTP yang sama 30000-40000 UDP.

Dalam Control Plane

Jana kunci pemasangan anda

  1. Langkah 3 : Log masuk ke Control Plane

    Buka my.maxipbx.com dalam pelayar anda dan log masuk dengan akaun anda. Control Plane ialah tempat anda mengurus keseluruhan armada PBX anda.

    Buka Control Plane
  2. Langkah 4 : Buka senarai PBX anda

    Dalam menu, pergi ke “Armada PBX”, kemudian klik “PBX”. Di sana anda akan melihat semua PBX yang sudah dipautkan ke akaun anda.

  3. Langkah 5 : Jana kunci pemasangan

    Klik “Jana kunci pemasangan”. Kunci ini memautkan pelayan yang akan dipasang ke akaun anda: setelah dipasang, ia akan terus muncul dalam armada anda.

  4. Langkah 6 : Paparkan dan salin skrip pemasangan

    Paparkan skrip pemasangan dan salin sepenuhnya. Skrip ini sudah mengandungi kunci anda: anda tidak perlu mengubah apa-apa di dalamnya.

    PerhatianSkrip ini mengandungi kunci khusus untuk akaun anda. Jangan kongsi atau terbitkannya di mana-mana.

Pada pelayan anda

Jalankan pemasangan

  1. Langkah 7 : Sambung melalui SSH dengan akaun root

    Daripada terminal (atau klien seperti PuTTY pada Windows), sambung ke pelayan Debian 13 baharu anda dengan akaun root. Gantikan YOUR_IP dengan alamat IP pelayan anda.

    ssh root@YOUR_IP

    PetuaJika anda log masuk dengan akaun lain, tukar kepada root dengan arahan “su -” atau “sudo -i” sebelum meneruskan.

  2. Langkah 8 : Tampal skrip dan tekan Enter

    Tampal skrip pemasangan yang disalin pada langkah 6 ke dalam terminal, kemudian tekan Enter.

  3. Langkah 9 : Biarkan pemasangan berjalan

    Kemajuan pemasangan dipaparkan pada skrin secara berperingkat. Biarkan ia berjalan sehingga selesai tanpa menyentuh apa-apa.

    PerhatianJangan tutup terminal atau putuskan sambungan SSH semasa pemasangan.

Dalam pelayar anda

Lengkapkan konfigurasi

  1. Langkah 10 : Buka wizard pemasangan

    Pada akhir pemasangan, terminal memaparkan alamat PBX anda dalam bentuk di bawah. Bukanya dalam pelayar anda, kemudian ikuti wizard pemasangan: ia membimbing anda melalui konfigurasi awal.

    https://YOUR_IP:8443

    PetuaJika pelayar anda memaparkan amaran keselamatan tentang sijil pada akses pertama ini, anda boleh meneruskan ke laman tersebut untuk melancarkan wizard.

    Perlukan bantuan?Jika anda mempunyai sebarang keraguan semasa menggunakan wizard, jangan teragak-agak untuk menghubungi rakan kongsi penjual semula MaxiPBX anda: mereka sedia membantu anda.

PBX anda telah dipasang

Setelah wizard selesai, PBX anda sedia digunakan dan dipautkan ke armada anda dalam Control Plane. Anda kini boleh mencipta pengguna, telefon dan talian anda.

Perlukan bantuan?

Pasukan kami boleh membantu anda semasa pemasangan atau melaksanakannya bagi pihak anda.