Guía de instalación

Instalar MaxiPBX en su servidor

Diez pasos, desde el nombre de dominio de su PBX hasta su primer acceso a la interfaz. Primero prepara el FQDN y el cortafuegos, después el Control Plane genera un script único que usted ejecuta por SSH y, por último, un asistente web se encarga de la configuración.

Antes de empezar

  • Un servidor Debian 13 recién instalado, sin ningún otro servicio ni aplicación.
  • Un acceso SSH con la cuenta root (o con una cuenta que pueda convertirse en root).
  • Un nombre de dominio cuya zona DNS gestione usted, para crear el FQDN de su PBX (por ejemplo pbx.yourdomain.com).
  • Una cuenta en el Control Plane de MaxiPBX, en la dirección my.maxipbx.com.
  • Acceso al cortafuegos o al router situado delante del servidor, para abrir los puertos necesarios.
Antes de la instalación

Preparar la red

  1. Paso 1 : Cree el FQDN de su servidor

    Ante todo, asigne a su PBX un nombre de dominio completo (FQDN), por ejemplo pbx.yourdomain.com. En la zona DNS de su dominio, haga que este nombre apunte a la dirección IP de su servidor:

    AtenciónEl FQDN ya debe apuntar a su servidor en el momento en que inicie la instalación (paso 8). Créelo en primer lugar.

    NombreTipoValor
    pbx.yourdomain.com A Dirección IPv4 de su servidorObligatorio
    pbx.yourdomain.com AAAA Dirección IPv6 de su servidorSi su servidor dispone de una dirección IPv6

    ConsejoUn cambio de DNS puede tardar unos minutos en propagarse. Para comprobar que el nombre responde con la IP de su servidor, ejecute «ping pbx.yourdomain.com» desde su equipo.

  2. Paso 2 : Abra los puertos del cortafuegos

    El PBX dispone de su propio cortafuegos, que abre exactamente los puertos que necesita. Si delante de él hay un cortafuegos o un router (cortafuegos del proveedor de alojamiento, router de empresa, router de internet), abra en él todos los puertos indicados a continuación, desde el exterior hacia el PBX.

    AtenciónEl puerto 8443 TCP solo es necesario durante la instalación: es el del asistente de instalación (paso 10). Ábralo antes de iniciar la instalación y vuelva a cerrarlo una vez activado el PBX: ya no se utiliza.

    PuertoProtocoloServicioPara qué sirve
    8443 Solo durante la instalación TCP Asistente Asistente de instalación (paso 10). Debe cerrarse de nuevo una vez activado el PBX
    80 TCP Nginx Aprovisionamiento de los terminales por HTTP, renovación del certificado Let's Encrypt
    443 TCP Nginx Interfaz web, API, aplicaciones móviles y de escritorio, teléfono web (WebRTC), aprovisionamiento HTTPS
    5060 UDP + TCP Kamailio SIP: terminales, softphones, troncales de operadores
    5061 TCP Kamailio SIP cifrado (TLS), certificado ECDSA
    5062 TCP Kamailio SIP cifrado (TLS), certificado RSA para los terminales que no admiten ECDSA
    30000-40000 UDP rtpengine Voz (RTP) de todas las llamadas: sin estos puertos, no hay audio
    3478-3479 UDP + TCP coturn STUN/TURN: audio de las aplicaciones y del teléfono web detrás de NAT
    5349-5350 UDP + TCP coturn TURN cifrado (TLS), misma función en redes restrictivas
    389 TCP API de MaxiPBX Directorio LDAP para los teléfonos
    10389 TCP API de MaxiPBX Directorio LDAP en un puerto alternativo, para determinados modelos
    22 TCP SSH Administración y mantenimiento remotos por parte de MaxiPBX. Puede limitarse a nuestras direcciones IP

    ConsejoSi el PBX está detrás de NAT (dirección IP privada), configure una redirección de puertos de toda esta lista hacia su IP interna, con el mismo rango RTP 30000-40000 UDP.

En el Control Plane

Generar su clave de instalación

  1. Paso 3 : Inicie sesión en el Control Plane

    Abra my.maxipbx.com en su navegador e inicie sesión con su cuenta. Desde el Control Plane gestiona todo su parque de PBX.

    Abrir el Control Plane
  2. Paso 4 : Abra la lista de sus PBX

    En el menú, vaya a «Parque PBX» y haga clic en «PBX». Allí verá todos los PBX ya vinculados a su cuenta.

  3. Paso 5 : Genere una clave de instalación

    Haga clic en «Generar una clave de instalación». Esta clave vincula el futuro servidor a su cuenta: una vez instalado, aparecerá directamente en su parque.

  4. Paso 6 : Muestre y copie el script de instalación

    Muestre el script de instalación y cópielo completo. Ya contiene su clave: no necesita modificar nada.

    AtenciónEl script contiene una clave propia de su cuenta. No lo comparta ni lo publique en ningún sitio.

En su servidor

Iniciar la instalación

  1. Paso 7 : Conéctese por SSH con la cuenta root

    Desde un terminal (o un cliente como PuTTY en Windows), conéctese a su nuevo servidor Debian 13 con la cuenta root. Sustituya YOUR_IP por la dirección IP de su servidor.

    ssh root@YOUR_IP

    ConsejoSi ha iniciado sesión con otra cuenta, cambie a root con el comando «su -» o «sudo -i» antes de continuar.

  2. Paso 8 : Pegue el script y confirme

    Pegue en el terminal el script de instalación copiado en el paso 6 y pulse Intro.

  3. Paso 9 : Deje que la instalación se complete

    El progreso de la instalación se muestra en pantalla a medida que avanza. Deje que llegue hasta el final sin tocar nada.

    AtenciónNo cierre el terminal ni interrumpa la conexión SSH durante la instalación.

En su navegador

Finalizar la configuración

  1. Paso 10 : Abra el asistente de instalación

    Al final de la instalación, el terminal muestra la dirección de su PBX con el formato indicado a continuación. Ábrala en su navegador y siga el asistente de instalación: le guiará en la configuración inicial.

    https://YOUR_IP:8443

    ConsejoSi su navegador muestra una advertencia de seguridad sobre el certificado en este primer acceso, puede continuar hacia el sitio para iniciar el asistente.

    ¿Necesita ayuda?Si tiene alguna duda durante el asistente, no dude en ponerse en contacto con su partner distribuidor de MaxiPBX: está a su disposición para acompañarle.

Su PBX está instalado

Una vez finalizado el asistente, su PBX está listo y vinculado a su parque en el Control Plane. Ya puede crear sus usuarios, terminales y líneas.

¿Necesita ayuda con la instalación?

Nuestro equipo puede acompañarle durante la instalación o encargarse de ella por usted.