Ghid de instalare

Instalați MaxiPBX pe serverul dumneavoastră

Zece pași, de la numele de domeniu al PBX-ului până la primul acces la interfață. Mai întâi pregătiți FQDN-ul și firewall-ul, apoi Control Plane generează un script unic pe care îl rulați prin SSH, iar în final un asistent web preia configurarea.

Înainte de a începe

  • Un server Debian 13 proaspăt instalat, fără alte servicii sau aplicații pe el.
  • Acces SSH cu contul root (sau cu un cont care poate deveni root).
  • Un nume de domeniu a cărui zonă DNS o administrați, pentru a crea FQDN-ul PBX-ului (de exemplu pbx.yourdomain.com).
  • Un cont în MaxiPBX Control Plane, la adresa my.maxipbx.com.
  • Acces la firewall-ul sau routerul aflat în fața serverului, pentru a deschide porturile necesare.
Înainte de instalare

Pregătiți rețeaua

  1. Pasul 1 : Creați FQDN-ul serverului

    Înainte de toate, atribuiți PBX-ului un nume de domeniu complet calificat (FQDN), de exemplu pbx.yourdomain.com. În zona DNS a domeniului, direcționați acest nume către adresa IP a serverului:

    AtențieFQDN-ul trebuie să indice deja către server în momentul în care lansați instalarea (pasul 8). Creați-l mai întâi.

    NumeTipValoare
    pbx.yourdomain.com A Adresa IPv4 a serveruluiObligatoriu
    pbx.yourdomain.com AAAA Adresa IPv6 a serveruluiDacă serverul are o adresă IPv6

    SfatPropagarea unei modificări DNS poate dura câteva minute. Pentru a verifica dacă numele răspunde cu IP-ul serverului, rulați „ping pbx.yourdomain.com” de pe calculatorul dumneavoastră.

  2. Pasul 2 : Deschideți porturile din firewall

    PBX-ul are propriul firewall, care deschide exact porturile de care are nevoie. Dacă în fața sa se află un firewall sau un router (firewall-ul furnizorului de găzduire, router de companie, modem de internet), deschideți pe acesta toate porturile de mai jos, din exterior către PBX.

    AtențiePortul 8443 TCP este necesar doar în timpul instalării: este utilizat de asistentul de instalare (pasul 10). Deschideți-l înainte de a lansa instalarea, apoi închideți-l din nou după activarea PBX-ului: nu mai este necesar.

    PortProtocolServiciuLa ce folosește
    8443 Doar în timpul instalării TCP Asistent Asistentul de instalare (pasul 10). Închideți-l din nou după activarea PBX-ului
    80 TCP Nginx Provisioning-ul telefoanelor prin HTTP, reînnoirea certificatului Let's Encrypt
    443 TCP Nginx Interfață web, API, aplicații mobile și desktop, telefon web (WebRTC), provisioning HTTPS
    5060 UDP + TCP Kamailio SIP: telefoane, softphone-uri, trunk-uri ale operatorilor
    5061 TCP Kamailio SIP criptat (TLS), certificat ECDSA
    5062 TCP Kamailio SIP criptat (TLS), certificat RSA pentru telefoanele care nu acceptă ECDSA
    30000-40000 UDP rtpengine Vocea (RTP) pentru toate apelurile: fără aceste porturi, nu există sunet
    3478-3479 UDP + TCP coturn STUN/TURN: sunetul aplicațiilor și al telefonului web în spatele unui NAT
    5349-5350 UDP + TCP coturn TURN criptat (TLS), același rol în rețelele restrictive
    389 TCP API MaxiPBX Agendă LDAP pentru telefoane
    10389 TCP API MaxiPBX Agendă LDAP pe un port alternativ, pentru anumite modele
    22 TCP SSH Administrare și mentenanță de la distanță de către MaxiPBX. Poate fi restricționat la adresele noastre IP

    SfatDacă PBX-ul se află în spatele unui NAT (adresă IP privată), configurați redirecționarea porturilor pentru întreaga listă către IP-ul său intern, cu aceeași plajă RTP 30000-40000 UDP.

În Control Plane

Generați cheia de instalare

  1. Pasul 3 : Conectați-vă la Control Plane

    Deschideți my.maxipbx.com în browser și conectați-vă cu contul dumneavoastră. Din Control Plane administrați întregul parc de PBX-uri.

    Deschideți Control Plane
  2. Pasul 4 : Deschideți lista PBX-urilor

    În meniu, accesați „Parc PBX”, apoi faceți clic pe „PBX”. Aici vedeți toate PBX-urile deja asociate contului dumneavoastră.

  3. Pasul 5 : Generați o cheie de instalare

    Faceți clic pe „Generați o cheie de instalare”. Această cheie asociază viitorul server cu contul dumneavoastră: după instalare, acesta va apărea direct în parcul dumneavoastră.

  4. Pasul 6 : Afișați și copiați scriptul de instalare

    Afișați scriptul de instalare și copiați-l integral. Acesta conține deja cheia dumneavoastră: nu trebuie să modificați nimic în el.

    AtențieScriptul conține o cheie specifică contului dumneavoastră. Nu îl partajați și nu îl publicați nicăieri.

Pe serverul dumneavoastră

Lansați instalarea

  1. Pasul 7 : Conectați-vă prin SSH cu contul root

    Dintr-un terminal (sau dintr-un client precum PuTTY pe Windows), conectați-vă la noul server Debian 13 cu contul root. Înlocuiți YOUR_IP cu adresa IP a serverului.

    ssh root@YOUR_IP

    SfatDacă sunteți conectat cu alt cont, treceți la root cu comanda „su -” sau „sudo -i” înainte de a continua.

  2. Pasul 8 : Lipiți scriptul și confirmați

    Lipiți în terminal scriptul de instalare copiat la pasul 6, apoi apăsați Enter.

  3. Pasul 9 : Lăsați instalarea să se desfășoare

    Progresul instalării este afișat pe ecran pe măsură ce avansează. Lăsați-o să ruleze până la final fără a interveni.

    AtențieNu închideți terminalul și nu întrerupeți conexiunea SSH în timpul instalării.

În browser

Finalizați configurarea

  1. Pasul 10 : Deschideți asistentul de instalare

    La finalul instalării, terminalul afișează adresa PBX-ului, în forma de mai jos. Deschideți-o în browser, apoi urmați asistentul de instalare: acesta vă ghidează prin configurarea inițială.

    https://YOUR_IP:8443

    SfatDacă browserul afișează un avertisment de securitate privind certificatul la acest prim acces, puteți continua către site pentru a lansa asistentul.

    Aveți nevoie de ajutor?Dacă aveți nelămuriri în timpul asistentului, nu ezitați să contactați partenerul dumneavoastră revânzător MaxiPBX: acesta vă stă la dispoziție pentru asistență.

PBX-ul dumneavoastră este instalat

După finalizarea asistentului, PBX-ul este pregătit și asociat parcului dumneavoastră din Control Plane. Puteți crea utilizatorii, telefoanele și liniile.

Aveți nevoie de ajutor?

Echipa noastră vă poate asista în timpul instalării sau se poate ocupa de aceasta în locul dumneavoastră.