Saltar al contenido principal

Guía de Instalación Rápida

Esta guía le mostrará la forma más rápida y sencilla de poner en marcha su propia plataforma de videoconferencias autoalojada.

Nuestro método recomendado utiliza un sencillo script automatizado que configura todos los componentes necesarios para ejecutar la plataforma en un servidor limpio con Ubuntu o Debian. Como alternativa, para quienes prefieren un servicio gestionado, nuestra solución oficial en la nube, PlugNmeet Cloud, proporciona un servidor listo para usar, permitiéndole omitir por completo el proceso de instalación.

Comencemos a configurar su servidor.

Paso 1: Requisitos del Servidor​

Antes de comenzar, asegúrese de contar con lo siguiente:

  • Un servidor limpio con Ubuntu o Debian y una dirección IP pública. Recomendamos cualquier versión LTS de Ubuntu. Es fundamental que el servidor no tenga otros servidores web como Apache o Nginx en ejecución, ya que esto provocará conflictos.

  • Hardware y Ancho de Banda: El servidor Plug-N-Meet en sí es una aplicación muy ligera. El hardware que necesita depende de la carga de trabajo prevista, específicamente del número de usuarios concurrentes y de la frecuencia con la que grabe sesiones.

    Para un grupo pequeño o para realizar pruebas, un servidor simple (p. ej., 2 núcleos de CPU, 2-4 GB de RAM) es suficiente.

    Para un entorno de producción, recomendamos:

    • Ancho de Banda: Este es el factor más crítico. Se recomienda un mínimo de 100 Mbits/s, pero cuanto más tenga, mejor será la experiencia de usuario.
    • CPU: Al menos 4 núcleos (se recomiendan 8 o más si se utiliza el grabador).
    • RAM: Al menos 4 GB (se recomiendan 8 GB o más si se utiliza el grabador).

    ¿Se pregunta qué soporta esto? Un solo servidor de 4 vCore / 16 GB gestionó 300–500 usuarios en una sala sin fallos en nuestros Benchmarks.

  • Dos subdominios que apunten a la IP pública de su servidor (p. ej., plugnmeet.ejemplo.com y turn.ejemplo.com).

  • Una dirección de correo electrónico válida para generar un certificado SSL de Let's Encrypt.

Configuración del Firewall

Si su servidor está detrás de un firewall, por favor, revise nuestra Guía de Configuración del Firewall para asegurarse de que los puertos necesarios estén abiertos antes de continuar.

Paso 2: Ejecutar la Instalación Automatizada​

Conéctese a su servidor a través de SSH. El método recomendado y más transparente es descargar primero el script y luego ejecutarlo. Esto le permite inspeccionar el contenido del script antes de ejecutarlo como superusuario (root).

# 1. Descargar el script
wget https://raw.githubusercontent.com/mynaparrot/plugNmeet-install/main/install.sh

Luego elija uno de los dos modos siguientes.

Opción A: Instalación interactiva (la más sencilla)​

Simplemente ejecute el script sin argumentos. Le solicitará todo lo que necesita, como sus nombres de dominio, su dirección de correo electrónico y si desea instalar el grabador y el firewall.

# 2. Ejecutar el script como superusuario
sudo bash install.sh

Opción B: Instalación no interactiva (con opciones)​

Pase todo como argumentos y el script se ejecutará sin solicitar nada. Esto es ideal para la automatización o como script posterior a la instalación en la nube (p. ej., user-data de cloud-init), de modo que un servidor nuevo quede listo con plugNmeet completamente funcional.

sudo bash install.sh --domain plugnmeet.ejemplo.com --turn-domain turn.ejemplo.com --email admin@ejemplo.com --recorder yes --ufw yes
OpciónDescripción
-d, --domain <domain>Dominio del servidor plugNmeet (p. ej., plugnmeet.ejemplo.com)
-t, --turn-domain <domain>Dominio del servidor TURN (p. ej., turn.ejemplo.com)
-e, --email <email>Dirección de correo electrónico para el certificado SSL de Let's Encrypt
-r, --recorder <yes|no>Instalar el grabador (yes o no; si se omite, se le preguntará)
-f, --ufw <yes|no>Configurar el firewall UFW (yes o no; si se omite, se le preguntará)
-h, --helpMostrar todas las opciones y salir

Algunas cosas a tener en cuenta:

  • Tanto la forma --opción valor como --opción=valor funcionan (p. ej., --domain=plugnmeet.ejemplo.com).
  • Si omite alguna opción, el script simplemente se la solicitará.
  • Ejecute sudo bash install.sh --help en cualquier momento para ver todas las opciones.
  • Si no hay terminal disponible para solicitarle datos (por ejemplo, en un script posterior a la instalación en la nube) y falta algún valor, el script se detendrá con un error claro que le indicará qué opción debe pasar.

Alternativamente, puede descargarlo y ejecutarlo en un solo comando:

sudo su -c "bash <(wget -qO- https://raw.githubusercontent.com/mynaparrot/plugNmeet-install/main/install.sh)" root
Ejemplo de script posterior a la instalación en la nube

La mayoría de los proveedores en la nube permiten ejecutar un script automáticamente después de instalar el sistema operativo (p. ej., user-data de cloud-init). Utilice la forma no interactiva para que el servidor quede completamente listo sin pasos manuales:

#!/bin/bash
wget -q https://raw.githubusercontent.com/mynaparrot/plugNmeet-install/main/install.sh -O /root/install.sh
bash /root/install.sh --domain plugnmeet.ejemplo.com --turn-domain turn.ejemplo.com --email admin@ejemplo.com --recorder yes --ufw yes

Al final del proceso, el script mostrará su URL del Servidor, Clave de API y Secreto de API.

Sus Credenciales de Servidor

Recomendamos guardar estas credenciales ahora para tenerlas a mano. Si cierra la ventana, ¡no se preocupe! Siempre podrá recuperarlas después desde el archivo /opt/plugNmeet/config.yaml en su servidor.

Paso 3: Verificar su Instalación​

Una vez completada la instalación, puede verificar que todo funcione correctamente.

  1. Verificar el estado del servicio:

    # Verificar el servidor principal
    systemctl status plugnmeet

    # Verificar el servicio del grabador
    systemctl status plugnmeet-recorder

    Ambos servicios deberían mostrar un estado de active (running).

  2. Realizar un inicio de sesión de prueba: La mejor manera de confirmar que todo el sistema funciona es unirse a una reunión de prueba.

    Navegue a https://plugnmeet.ejemplo.com/login.html. En esta página, puede usar la API_KEY y el API_SECRET que guardó de la instalación para generar un token de acceso temporal y unirse a una conferencia de prueba.

¿Qué Sigue?​

¡Felicidades! Ahora tiene una plataforma de videoconferencias autoalojada y completamente funcional. Aquí hay algunas cosas que puede hacer a continuación:

  • Comenzar a usar Plug-N-Meet: Ahora que su servidor está en funcionamiento, visite nuestro Resumen de la Guía del Usuario para conocer las diferentes formas en que puede integrar y usar su nueva plataforma, desde plugins sin código hasta nuestra potente API.
  • Explorar la API: Para desarrolladores listos para empezar, nuestra Documentación de la API proporciona todos los detalles que necesita para comenzar a construir.
  • Administrar su servidor: Conozca los comandos comunes para administrar sus servicios, incluyendo iniciar, detener y ver registros.
  • Personalización Avanzada: Explore nuestros Hooks de Scripting y Almacenamiento para automatizar flujos de trabajo e integrarse con proveedores de almacenamiento externos.

Temas Avanzados​

Administrando Servicios​

Todos los componentes de Plug-N-Meet se ejecutan como servicios de systemd.

# Para iniciar, reiniciar o detener los servicios:
systemctl restart plugnmeet
systemctl restart plugnmeet-recorder

Para ver los archivos de registro:

tail -n 200 -f /opt/plugNmeet/log/plugNmeet.log
tail -n 200 -f /opt/plugNmeet/recorder/logs/recorder.log

Actualización de su Servidor​

Para actualizar su instalación de Plug-N-Meet a la última versión, simplemente ejecute el script update.sh:

sudo su -c "bash <(wget -qO- https://raw.githubusercontent.com/mynaparrot/plugNmeet-install/main/update.sh)" root

Despliegues Escalables​

Para necesidades a gran escala, Plug-N-Meet puede desplegarse en un clúster distribuido de múltiples servidores. Para obtener más información, lea nuestra Guía de Despliegue Escalable.