Skip to main content

Como instalar Pangolín en Debian

Pangolín autohospedado

Guía de instalación rápida

Implemente su propia instancia totalmente alojada de Pangolin Community Edition

Requisitos previos

Antes de comenzar, asegúrese de tener:
  • Servidor Linux con acceso root y dirección IP pública
  • Nombre de dominio apuntando a la dirección IP de su servidor para el panel
  • Dirección de correo electrónico para cifrar certificados SSL e iniciar sesión como administrador
  • Abrir puertos en el firewall para 80 (TCP), 443 (TCP), 51820 (UDP) y 21820 (UDP para clientes)
Recomendado: Ubuntu 20.04+ o Debian 11+ para una mejor compatibilidad y rendimiento.

Elija su servidor

¿necesitas ayuda para elegir? Vea nuestro guía completa de VPS para sugerencias.

DNS y redes

Antes de instalar Pangolin, asegúrese de haber configurado DNS para su dominio(s) y haber abierto el puerto requerido en su firewall. Vea nuestra guía en DNS y redes para más información.

Proceso de instalación


Descargar el instalador

Conéctese a su servidor a través de SSH y descargue el instalador: 


curl -fsSL https://static.pangolin.net/get-installer.sh | bash


El instalador admite arquitecturas AMD64 (x86_64) y ARM64.

Ejecute el instalador

Ejecute el instalador con privilegios de root: 


sudo ./install


El instalador coloca todos los archivos en el directorio actual. Mueva el instalador al directorio de instalación deseado antes de ejecutarlo.


Configurar ajustes básicos

El instalador le solicitará la configuración esencial:
  • Edición: Elija Community Edition o Edición empresarial. Revise las diferencias de edición antes de continuar.
  • Dominio base: Ingrese su dominio raíz sin subdominios (por ejemplo, ejemplo.com)
  • Dominio del panel de control: Presione Enter para aceptar el valor predeterminado pangolin.example.com o ingrese un dominio personalizado
  • Cifremos el correo electrónico: Proporcione un correo electrónico para obtener certificados SSL e iniciar sesión como administrador
  • Túneles: Elija si desea instalar Gerbil para conexiones en túnel (predeterminado: sí). Puedes ejecutar Pangolin sin hacer túneles. Funcionará como un proxy inverso estándar.


Configurar correo electrónico (opcional)

La funcionalidad de correo electrónico es opcional y se puede agregar más adelante.
Elija si desea habilitar la funcionalidad de correo electrónico SMTP:
  • Predeterminado: No (recomendado para la configuración inicial)
  • Si está habilitado: Necesitará los detalles del servidor SMTP (host, puerto, nombre de usuario, contraseña)

5

Iniciar la instalación

Confirme que desea instalar e iniciar los contenedores:
  • El instalador extraerá imágenes de Docker (pangolín, jerbo, traefik)
  • Los contenedores se iniciarán automáticamente
  • Este proceso dura de 2 a 3 minutos dependiendo de su conexión a Internet
Verá indicadores de progreso a medida que se extraiga y arranque cada contenedor.

Configuración posterior a la instalación

Una vez que la instalación se complete exitosamente, verás: 


¡instalación completa!

Para completar la configuración inicial, visite:
https://<your-dashboard-domain>/auth/initial-setup



1

Accede al panel

Navegue hasta la URL que se muestra en la salida del instalador e ingrese el token de configuración que muestra el instalador. Si decidió no iniciar los contenedores durante la instalación, recupere el token de los registros del contenedor Pangolin cuando se inicie por primera vez. 


https://<your-dashboard-domain>/auth/initial-setup


El panel debe cargarse con el certificado SSL configurado automáticamente. Es posible que el primer certificado tarde unos minutos en validarse, así que no se preocupe si el navegador emite una advertencia insegura.

2

Obtenga el token de configuración de los registros de Pangolin

Verifique los registros del contenedor de Pangolin y copie el token de configuración impreso en stdout: 


sudo docker compose logs pangolin


Necesitará ese token en la página de configuración inicial para registrar la primera cuenta de administrador.

3

Crear cuenta de administrador

Complete la configuración inicial del usuario administrador:
  • Pegue el token de configuración de los registros de Pangolin
  • Ingrese su dirección de correo electrónico de administrador
  • Establezca una contraseña segura
  • Verifique su correo electrónico (si el correo electrónico está configurado)
Utilice una contraseña segura y única para su cuenta de administrador. Esta cuenta tiene acceso completo al sistema.

4

Crea tu primera organización

Después de iniciar sesión:
  1. Ingrese el nombre y la descripción de la organización
  2. Haga clic en “Crear organización”
¡ahora estás listo para comenzar a agregar aplicaciones y configurar tu proxy inverso!
Back to top