Como instalar Pangolín en Debian
Requisitos
Pangolín autohospedado
Un
servidor
limpio con Debian (11 o 12).
Permisos de administrador (sudo o usuario root).
Puertos abiertos necesarios en tu firewall (habitualmente HTTP/HTTPS u otros puertos personalizados que configure Pangolin).
Guía de Instalacióninstalación Paso a Paso
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
1.Actualizar el Sistema:Paso 1.
AsegúrateDescargar deel que los paquetes de tu sistema operativo estén totalmente actualizados ejecutando:instalador
Conéctese a su servidor a través de SSH y descargue el instalador:
sudo apt update && sudo apt upgraderizo -yfsSL https://static.pangolin.net/get-installer.sh | bash
El instalador admite arquitecturas AMD64 (x86_64) y ARM64.
Verificación: El comando debe finalizar sin errores de repositorios y conEjecute el sistema al día.instalador
instalador con privilegios de root:
2.Instalar Dependencias Esenciales:Paso 2.
Instala
herramientas
básicas
necesarias
para
descargarsudo y./instalador
gestionar
paquetes,
como
curl,
git
y
utilidades
El instalador coloca todos los archivos en el directorio actual. Mueva el instalador al directorio de red: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.
sudo apt install -y curl wget git apt-transport-https ca-certificates gnupg lsb-release
Verificación:Configurar Compruebacorreo queelectrónico curl responde correctamente ejecutando curl --version.(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)
3.Instalar Docker y Docker Compose:Paso 3.
PangolinIniciar sela despliega habitualmente de forma contenerizada. Añade el repositorio oficial de Docker e instálalo: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 Añadircompleta!
clavePara GPGcompletar yla repositorioconfiguración oficialinicial, de Docker
sudo mkdir -p /etc/apt/keyrings
curl -fsSLvisite:
https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o <your-dashboard-domain>/etc/apt/keyrings/docker.gpg
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian \
$(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
# Instalar Docker Engine y Docker Compose
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-pluginauth/initial-setup
Verificación:Accede Ejecutaal sudo docker compose version para confirmar que se instaló la versión correcta del plugin.panel
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.
4.Clonar o Descargar Pangolin:Paso 4.
Clona
https://<your-dashboard-domain>/auth/initial-setup
El panel debe cargarse con el repositoriocertificado oficialSSL deconfigurado Pangolinautomáticamente. oEs descargaposible losque ficherosel primer certificado tarde unos minutos en validarse, así que no se preocupe si el navegador emite una advertencia insegura.
Obtenga el token de configuración necesariosde paralos su despliegue en tu directorioregistros de trabajo (por ejemplo, en /opt/pangolin):Pangolin
Verifique los registros del contenedor de Pangolin y copie el token de configuración impreso en stdout:
sudo mkdirestibador -pcomponer /opt/pangolinregistros cd /opt/pangolin
# Clonar el repositorio correspondiente o descargar la estructura docker-compose
git clone https://github.com/fosrl/pangolin.git .pangolín
Necesitará ese token en la página de configuración inicial para registrar la primera cuenta de administrador.
Verificación:Crear Lista el contenidocuenta de la carpeta con ls -la para asegurarte de que están presentes los archivos de configuración y el docker-compose.yml.administrador
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)
Configurar las Variables de Entorno
Paso 5
5.ConfigurarUtilice lasuna Variablescontraseña segura y única para su cuenta de Entorno:Pasoadministrador. 5.Esta cuenta tiene acceso completo al sistema.
CopiaCrea eltu archivoprimera de ejemplo de entorno y edítalo con tus parámetros personalizados (como dominios públicos, credenciales de base de datos y puertos):organización
Después de iniciar sesión:
Ingrese el nombre y la descripción de la organización
Haga clic en “Crear organización”
¡ahora estás listo para comenzar a agregar aplicaciones y configurar tu proxy inverso!
cp .env.example .env
nano .env
Ajustes clave a revisar en el .env:
APP_URL: Tu dominio público configurado.
Puertos de escucha y claves secretas o tokens de conexión. Verificación: Guarda los cambios en el archivo (Ctrl+O, Enter, Ctrl+X en Nano) y asegúrate de que no queden campos obligatorios vacíos.
Iniciar el Despliegue con Docker Compose
Paso 6
6.Iniciar el Despliegue con Docker Compose:Paso 6.
Despliega los contenedores de Pangolin en segundo plano utilizando Docker Compose:
sudo docker compose up -d
Verificación: Ejecuta sudo docker compose ps para comprobar que todos los servicios relacionados con Pangolin se encuentran en estado Up (en ejecución).
