Tutoriales de VPS
Pangolin en VPS (2026): Newt, HTTPS, autenticación y copias
Aloje Pangolin en Ubuntu, conecte servicios privados con Newt, configure Traefik HTTPS e identidad, calcule transferencia y compruebe copias, recuperación y actualización.

Un NAS, Home Assistant, una biblioteca de fotos o un entorno de desarrollo doméstico puede carecer de IP pública. Pangolin reúne proxy inverso, túneles cifrados, certificados de dominio y control de acceso por identidad en un panel propio. Permite publicar determinados servicios web privados sin mantener por separado FRP, el proxy, la automatización de certificados y la autenticación.
Esta guía instala Pangolin Community Edition en Ubuntu 24.04, conecta la red privada mediante Newt independiente y cubre Traefik HTTPS, usuarios, reglas, transferencia, copias, actualización y diagnóstico. La referencia del 14 de septiembre de 2026 utilizaba Pangolin 1.22.2. La revisión del 16 de noviembre de 2026 encontró Pangolin 1.26.0 y Newt 1.20.0 como versiones estables más recientes. Los descargadores eligen versiones actuales; el número antiguo no fija la instalación. Revise y registre las versiones reales del servidor, conector y proxy antes de publicarla.
El tráfico de los recursos web públicos pasa por el VPS: el visitante llega a Traefik/Pangolin, que envía la solicitud por el túnel Newt al servicio privado. La transferencia mensual, velocidad sostenida del puerto, conectividad y ubicación influyen directamente. Los recursos privados tienen sus propios modos de conexión; no todos siguen necesariamente ese recorrido.
El VPS proporciona entrada por dominio, TLS, identidad y reglas. Newt se ejecuta dentro de la red privada e inicia una conexión cifrada hacia fuera. La conexión doméstica no necesita IPv4 pública ni abrir puertos de las aplicaciones en el router.
Usos habituales:
- Dar HTTPS a NAS, fotos, Home Assistant o paneles de monitorización.
- Compartir un sitio con compañeros o clientes mediante autenticación o enlace con caducidad.
- Conectar ubicaciones domésticas, oficinas y otras redes de nube.
- Administrar recursos públicos, privados y sus políticas desde un panel.
- Sustituir una combinación mantenida por separado de FRP, Nginx, Certbot y Authelia.
Publicar una aplicación y formar una red privada de dispositivos son necesidades diferentes. Para acceso privado entre dispositivos, consulte NetBird. Para reenvío sencillo con menos componentes, vea FRP. Pangolin también ofrece acceso privado, pero un recurso web público es una entrada de internet cuya protección debe configurar y comprobar.
| Opción | Control | Recorrido habitual | HTTPS e identidad | Uso apropiado |
|---|---|---|---|---|
| Pangolin | VPS propio | Visitante → VPS → Newt → servicio privado | Integrados | Varios sitios, equipos y acceso temporal |
| Cloudflare Tunnel | Cloudflare | Visitante → Cloudflare → túnel | Disponibles mediante sus servicios | Evitar operar un VPS de entrada y aceptar plataforma externa |
| FRP | Propio | Visitante → frps → frpc → destino | Configuración adicional | SSH, juegos y reenvío TCP/UDP sencillo |
| NetBird | Puede alojarse | Peers directos si es posible; relay en otro caso | Centrado en identidad y políticas privadas | Red de dispositivos y permisos detallados |
Considere Cloudflare Tunnel si el acceso gestionado se ajusta a la aplicación y a las condiciones de la plataforma. Pangolin permite operar el VPS, los dominios y el acceso con responsabilidad propia de seguridad, mantenimiento y copias.
El recorrido público es navegador → VPS con Traefik, Pangolin y Gerbil → túnel cifrado → máquina Newt → servicio LAN. El diagrama conserva esa secuencia:
浏览器
↓ HTTPS
公网 VPS:Traefik + Pangolin + Gerbil
↓ 加密隧道
Newt 所在内网机器
↓ LAN
NAS / Home Assistant / 内网站点
Al descargar 10 GB, el VPS recibe aproximadamente esos datos del túnel y los envía al visitante, más sobrecarga. Si el proveedor cuenta solo salida, se factura principalmente el envío de la descarga; si cuenta ambas direcciones, puede sumar aproximadamente las dos etapas. Confirme dirección de facturación, exceso y velocidad sostenida.
| Caudal continuo | Datos teóricos en 30 días | Implicación |
|---|---|---|
| 1 Mbps | Unos 324 GB | Paneles ligeros y fotos ocasionales |
| 5 Mbps | Unos 1,62 TB | Archivos frecuentes o varios visitantes requieren margen |
| 10 Mbps | Unos 3,24 TB | Vídeo, copias y descargas grandes consumen la cuota |
| 100 Mbps | Unos 32,4 TB | Supera muchos planes pequeños limitados |
La fórmula de referencia Mbps × 1,000,000 ÷ 8 × 2,592,000 秒 equivale a Mbps × 1.000.000 bits/segundo ÷ 8 × 2.592.000 segundos. Son cantidades decimales de 30 días a caudal constante máximo, sin TLS, sobrecarga del túnel, retransmisiones ni picos. No son mediciones de proveedores.
La referencia antigua describía 1 vCPU/1 GB/8 GB SSD como mínimo. La guía actual propone 1 vCPU/2 GB/8 GB SSD como instalación básica y advierte que 1 GB puede necesitar swap durante instalación, actualización o picos. La recomendación sigue siendo 2 vCPU/2 GB/20 GB SSD. Considere 1 GB una prueba limitada, no una garantía de producción.
| Uso | VPS inicial sugerido | Prioridad |
|---|---|---|
| Personal, 2–5 sitios ligeros | 2 núcleos, 2 GB, 20 GB SSD, 1 TB/mes | Fiabilidad y transferencia suficiente |
| Fotos y archivos | 2–4 núcleos, 2–4 GB, 3 TB+ | Velocidad sostenida y cobro de salida |
| Equipo pequeño | 4 GB+ y SSD suficiente | Usuarios, registros y espacio para actualizar |
| Streaming o copias continuas | Plan dimensionado de alta transferencia | Calcular consumo y coste por exceso |
Evalúe visitante → VPS y VPS → conexión doméstica. Visitantes y servicio en Asia pasando por Europa generan un desvío; el mismo criterio vale para otras regiones. Estas estimaciones no prometen latencia ni capacidad de un proveedor.
Ejemplos:
- Dominio base
example.com. - Panel
pangolin.example.com. - Recurso público
nas.example.com. - IPv4 documental
203.0.113.10. - Directorio
/opt/pangolin.
Sustituya todos los valores. DNS comodín permite resolver nuevos subdominios sin crear cada registro:
Type: A
Name: *
Value: 203.0.113.10
Proxy: DNS only
También puede crear registros separados para pangolin.example.com y nas.example.com. AAAA solo con IPv6 funcional. DNS comodín no crea un certificado comodín: la validación HTTP predeterminada emite certificados para nombres concretos. Un certificado comodín necesita validación DNS adecuada y credenciales protegidas.
Compruebe DNS y puertos ocupados:
dig +short A pangolin.example.com
dig +short A nas.example.com
sudo ss -lntup | grep -E ':(22|80|443|51820|21820)\b' || true
Instale dnsutils si falta dig. Puertos predeterminados:
80/TCP: redirección HTTP y validación ACME habitual.443/TCP: panel y recursos HTTPS.51820/UDP: túneles de Sites, incluido Newt.21820/UDP: túneles de clientes a través del servidor.22/TCP: SSH restringido a administración.
21820/UDP se necesita para clientes, no para todo recurso web público con Newt. Las reglas de referencia lo incluyen para el quickstart completo; si no utiliza clientes, revise las publicaciones y cierre esa entrada. Puertos personalizados deben coincidir en configuración y firewall.
En Ubuntu 24.04:
sudo apt update
sudo apt upgrade -y
sudo apt install -y ca-certificates curl jq docker.io docker-compose-v2
sudo systemctl enable --now docker
sudo usermod -aG docker "$USER"
Salga y vuelva a entrar en SSH para activar el grupo Docker, que concede control equivalente a root. Compruebe less, openssl y dnsutils, además de netcat-openbsd para la prueba nc posterior:
docker version
docker compose version
docker run --rm hello-world
Use docker compose, no docker-compose antiguo. Resuelva la ocupación de 80/443 por Nginx, Caddy o Traefik antes de instalar. Si necesita administrar un proxy convencional aparte, consulte Nginx Proxy Manager; dos proxies no pueden ocupar las mismas entradas del host.
Configure primero el proveedor: 80/TCP, 443/TCP, 51820/UDP y 21820/UDP si utiliza clientes, con SSH solo desde administración. Reglas del quickstart completo:
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow from YOUR_ADMIN_IP to any port 22 proto tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 51820/udp
sudo ufw allow 21820/udp
sudo ufw enable
sudo ufw status numbered
Sustituya YOUR_ADMIN_IP antes de activar UFW. Conserve la conexión SSH y la consola del proveedor. Si pierde acceso, siga la lista de recuperación UFW.
Docker gestiona reenvío por separado. Verifique docker compose ps, ss, reglas del proveedor y un escaneo externo; no suponga que UFW oculta puertos publicados por error. El VPS forma parte de la seguridad de sus servicios privados.
El quickstart recomienda Ubuntu 20.04+ o Debian 11+ y admite Linux amd64/arm64. Descargue y revise el script en un directorio limpio. Ejecute por pasos: después de que el script descargue el binario, compruebe su digest con el archivo de la versión oficial elegida antes del último comando sudo:
sudo install -d -m 0750 -o "$USER" -g "$USER" /opt/pangolin
cd /opt/pangolin
curl -fsSLo get-installer.sh \
https://static.pangolin.net/get-installer.sh
less get-installer.sh
bash ./get-installer.sh
sudo ./installer
El script obtiene el instalador de la versión más reciente. Revisar solo el script no verifica ese binario; use los checksums publicados cuando estén disponibles. La versión de septiembre no fija la instalación, y ejecutar otra vez el instalador sobre una existente no es el procedimiento de actualización.
Los archivos se escriben en el directorio actual, así que entre en /opt/pangolin. Elija:
- Edición
Community. - Dominio base
example.com. - Panel
pangolin.example.com. - Correo mantenido para Let's Encrypt y administración.
- Túneles Gerbil habilitados.
- Omitir SMTP inicialmente si no está preparado.
Revise los servicios y las imágenes generadas:
cd /opt/pangolin
docker compose config --services
docker compose config --images
docker compose ps
Registre versiones Pangolin, Gerbil, Traefik y plugin Badger. Si alguna imagen usa latest, elija tag/digest explícito probado antes de uso público. Los componentes no comparten un número de versión. docker compose config --quiet valida sintaxis, no salud:
docker compose config --quiet
docker compose logs --tail=150
El formato histórico de la dirección inicial puede ser:
https://pangolin.example.com/auth/initial-setup?token=ONE_TIME_TOKEN
El quickstart actual abre initial-setup y pide el token mostrado por el instalador o los logs del contenedor Pangolin. Siga la salida de su versión; no suponga que siempre aparece en la consulta URL. Mantenga privados token y URL que lo contenga. Los logs iniciales pueden incluir esta credencial.
Complete el registro pronto desde un equipo confiable, cree el administrador y después la primera organización antes de añadir Sites. Compruebe:
- Panel con HTTPS válido.
- Certificado correspondiente a
pangolin.example.com. - Contraseña fuerte y exclusiva de administración.
- Cuenta normal independiente para uso diario.
- Administrador de emergencia probado antes de identidad externa.
Revise TLS y cabeceras:
curl -I https://pangolin.example.com
openssl s_client \
-connect pangolin.example.com:443 \
-servername pangolin.example.com </dev/null 2>/dev/null \
| openssl x509 -noout -subject -issuer -dates
No introduzca credenciales mientras exista un aviso de certificado sin resolver. Corrija DNS y emisión primero.
Site representa una ubicación privada: casa, oficina u otra nube. Créelo en su organización y copie Newt ID, Secret y Endpoint. Use un Linux estable y siempre conectado que alcance el destino; no tiene que ser el NAS.
La documentación actual recomienda Pangolin CLI para Sites nuevos; Newt sigue disponible como conector más pequeño. Aquí conservamos Newt con systemd. Consulte las instrucciones específicas de Newt si la página general muestra CLI. Newt usa NEWT_ID/NEWT_SECRET; no copie SITE_ID/SITE_SECRET del CLI a este servicio.
Descargue y revise:
curl -fsSLo get-newt.sh https://static.pangolin.net/get-newt.sh
less get-newt.sh
sudo bash ./get-newt.sh
rm -f get-newt.sh
También selecciona una versión actual. Revise notas, mensajes de verificación del archivo y compatibilidad del servidor antes de actualizar una instalación antigua. Un checksum omitido no significa verificación. Compruebe /usr/local/bin/newt antes de activar la unidad; ajuste ExecStart si instaló deliberadamente en otra ruta.
Cree el archivo privado:
sudo install -d -m 0700 /etc/newt
sudo install -m 0600 /dev/null /etc/newt/newt.env
sudoedit /etc/newt/newt.env
Introduzca los valores reales del Site:
NEWT_ID=REPLACE_WITH_SITE_ID
NEWT_SECRET=REPLACE_WITH_SITE_SECRET
PANGOLIN_ENDPOINT=https://pangolin.example.com
Mantenga Secret fuera de repositorios, capturas y comandos literales del historial. Cree la unidad:
sudoedit /etc/systemd/system/newt.service
Contenido:
[Unit]
Description=Pangolin Newt Tunnel Client
Wants=network-online.target
After=network-online.target
[Service]
Type=simple
User=root
Group=root
EnvironmentFile=/etc/newt/newt.env
ExecStart=/usr/local/bin/newt
Restart=always
RestartSec=2
UMask=0077
PrivateTmp=true
[Install]
WantedBy=multi-user.target
Newt lee las variables automáticamente, sin repetirlas como argumentos de proceso. El ejemplo utiliza root; limite quién modifica binario, unidad y entorno. Inicie:
sudo systemctl daemon-reload
sudo systemctl enable --now newt
sudo systemctl status newt --no-pager
sudo journalctl -u newt -n 100 --no-pager
Confirme Site online. La conexión saliente normalmente evita abrir puertos en el router doméstico, pero la red debe permitir HTTPS al Endpoint y los UDP configurados. Reinicie Newt después de editar el entorno.
Suponga NAS 192.168.1.20:5000 accesible mediante nas.example.com. Cree:
Resource type: Public
Domain: nas.example.com
Site: Home
Target hostname/IP: 192.168.1.20
Target port: 5000
Target method: HTTP
Target es una dirección alcanzable desde Newt, no necesariamente desde el VPS. localhost designa el espacio de red del propio conector; solo sirve si allí está el destino previsto. No representa automáticamente otro NAS o contenedor.
El protocolo interno es independiente del TLS público. Use HTTP con este destino HTTP, o HTTPS con un destino realmente HTTPS y validación adecuada. No desactive validación para ocultar un esquema o certificado equivocado. Revise requisitos WebSocket y de proxy confiable de cada aplicación, sin aceptar cabeceras de identidad de fuentes arbitrarias.
Desde la máquina Newt:
curl -I http://192.168.1.20:5000
nc -vz 192.168.1.20 5000
Desde otra red:
curl -I https://nas.example.com
Un recurso protegido puede redirigir al login; no equivale a un fallo del túnel. Algunos destinos rechazan HEAD aunque GET funcione. Pruebe la aplicación en navegador y datos móviles para evitar confusión por NAT loopback de casa.
La documentación actual habilita Platform SSO de forma predeterminada en recursos HTTP públicos, pero confirme el recurso y su política heredada. Un dominio difícil de adivinar no protege un NAS, Home Assistant o desarrollo.
- Mantenga autenticación de plataforma.
- Asigne únicamente usuarios y roles necesarios.
- Para visitantes, use Share Link con caducidad o método temporal adecuado.
- Revoque acceso al terminar.
- Revise usuarios, roles y recursos antiguos.
Los enlaces y tokens son credenciales al portador: quien los tiene puede acceder sin cuenta Pangolin. No son automáticamente de un solo uso; Never expire dura hasta revocación. Configure caducidad y pruebe vencimiento/eliminación. Este acceso no transmite identidad individual mediante cabeceras al destino.
Las reglas se procesan por prioridad de arriba abajo. Allow/Bypass Auth omite autenticación; Deny rechaza; Pass to Auth continúa a identidad, PIN o contraseña. Pruebe una cuenta normal permitida, otra sin permiso y un navegador sin sesión. No deje bypass amplio creado para diagnóstico. Consulte reglas y autenticación pública.
La autenticación del navegador no protege igual un puerto TCP/UDP arbitrario. Para SSH administrativo y bases, prefiera Private Resources o NetBird/WireGuard, con autenticación nativa y restricciones deliberadas. Para juegos, evalúe UDP, latencia y transferencia por separado. Compruebe funciones e identidad externa según versión y edición desplegada.
SMTP sirve para invitaciones, avisos y cuentas; es opcional para probar el túnel inicial. Primero complete panel → Site online → logs Newt correctos → recurso accesible → autenticación efectiva → copia recuperable:
Dashboard 可登录
→ Site 在线
→ Newt 日志正常
→ 一个测试资源可访问
→ 身份认证生效
→ 备份可恢复
Después añada SMTP y OIDC u otro proveedor compatible. Separar fases facilita diagnosticar DNS, cookies, callback, correo y túnel. Email OTP requiere entrega de correo funcional, no reemplaza configurar SMTP.
La URL callback debe coincidir con dominio público y HTTPS reales. Preserve correctamente Host y X-Forwarded-Proto a través de proxies confiables. Mantenga sesión local de administrador y pruebe el nuevo login en ventana privada antes de cerrarla.
Guarde config, docker-compose.yml, identidades de imágenes, plugins y demás archivos reales. Revise rutas:
cd /opt/pangolin
find . -maxdepth 2 -type f -printf '%P\n' | sort
docker compose config --images
El ejemplo compacto detiene la pila y muestra los archivos esenciales. No protege el reinicio ante una copia interrumpida ni incluye todos los montajes personalizados. Para la instalación predeterminada, utilice el procedimiento completo siguiente.
cd /opt/pangolin
sudo docker compose down
sudo tar \
--numeric-owner \
-czf "/root/pangolin-backup-$(date +%F-%H%M%S).tar.gz" \
config docker-compose.yml
sudo docker compose up -d
docker compose ps
Incluya .env, otros Compose y certificados cuando existan; no archive indiscriminadamente /opt. Base, claves, contraseñas SMTP y tokens deben permanecer privados. Permisos y comprobación simples:
sudo chmod 600 /root/pangolin-backup-*.tar.gz
sudo sha256sum /root/pangolin-backup-*.tar.gz
Para el quickstart de un solo archivo, este procedimiento root guarda datos/configuración detenidos, imágenes/montajes, sumas internas y checksum del archivo. Intenta reiniciar los servicios previamente activos incluso si falla la copia:
sudo bash <<'BACKUP'
set -Eeuo pipefail
umask 077
cd /opt/pangolin
compose=(docker compose -f docker-compose.yml)
mapfile -t running_services < <("${compose[@]}" ps --status running --services)
test "${#running_services[@]}" -gt 0
mapfile -t container_ids < <("${compose[@]}" ps -a -q)
test "${#container_ids[@]}" -gt 0
install -d -m 0700 /var/backups/pangolin
backup_dir=$(mktemp -d "/var/backups/pangolin/$(date -u +%Y%m%dT%H%M%SZ)-XXXXXX")
docker inspect --format '{{.Name}} {{.Config.Image}} {{.Image}}' "${container_ids[@]}" > "$backup_dir/images.txt"
docker inspect --format '{{.Name}} {{json .Mounts}}' "${container_ids[@]}" > "$backup_dir/mounts.txt"
resume_stack() { "${compose[@]}" start "${running_services[@]}" >/dev/null || true; }
trap resume_stack EXIT
"${compose[@]}" stop
cp -a config docker-compose.yml "$backup_dir/"
if test -f .env; then cp -p .env "$backup_dir/"; fi
(cd "$backup_dir" && find . -type f ! -name SHA256SUMS -print0 | sort -z | xargs -0 sha256sum > SHA256SUMS && sha256sum -c SHA256SUMS)
archive="$backup_dir.tar.gz"
tar --numeric-owner -C /var/backups/pangolin -czf "$archive" "$(basename "$backup_dir")"
tar -tzf "$archive" >/dev/null
(cd /var/backups/pangolin && sha256sum "$(basename "$archive")" > "$(basename "$archive").sha256")
printf 'Backup archive: %s\n' "$archive"
BACKUP
Suspenda cambios administrativos. Si usa nombres de proyecto distintos, overrides, bases externas o volúmenes fuera de config, adapte Compose e incluya su copia consistente antes de comprimir. Registrar montajes no copia los volúmenes. Compruebe salud tras el intento de reinicio y conserve bases/certificados extra en el mismo conjunto de recuperación.
Copie el host Newt aparte: /etc/newt/newt.env, /etc/systemd/system/newt.service e identidad de binario/versión. Cifre archivo y credenciales, y lleve copias y checksums fuera del host. Una copia SQLite local o automática previa a migración no sustituye un respaldo independiente.
En ensayo aislado, verifique checksum del archivo, extraiga y compruebe SHA256SUMS desde el directorio extraído. Restaure Compose, configuración, claves, certificados, datos completos y almacenes aparte; use las versiones registradas y propietarios correctos. Valide sintaxis, inicie aislado, compruebe usuarios/organización/recursos y un túnel controlado. Evite una copia compitiendo por dominio e identidad de producción antes del cambio deliberado.
La versión 1.22 introdujo funciones y migraciones; también debe revisar versiones posteriores. docker compose pull no elige una versión nueva si las imágenes están fijadas. Secuencia abreviada de mantenimiento:
cd /opt/pangolin
sudo docker compose down
sudo cp -a config "config.before-upgrade-$(date +%F-%H%M%S)"
sudo cp -a docker-compose.yml \
"docker-compose.yml.before-upgrade-$(date +%F-%H%M%S)"
sudo docker compose pull
sudo docker compose up -d
sudo docker compose ps
sudo docker compose logs --tail=200
Antes de utilizarla:
- Cree y verifique el conjunto completo de recuperación privado y externo.
- Lea notas del destino y revise combinación compatible de Pangolin, Gerbil, Traefik/Badger y conector.
- Cambie tags/digests elegidos y, cuando corresponda, Badger en la configuración real de Traefik antes de pull. La copia privada debe guardar configuración previa a editar.
- Siga actualizaciones incrementales y migraciones necesarias; descargue y reinicie en ventana planificada.
- Revise logs y accesos relevantes antes de aceptar el resultado.
Pangolin ejecuta migraciones automáticamente; una migración de base fallida puede impedir arrancar. Copias SQLite automáticas son útiles, pero no incluyen todos los elementos. Para AI Gateway en 1.22 específicamente, la versión exigía Badger v1.6.0+, Gerbil 1.5.0 para gateways privados y clientes compatibles. Son requisitos históricos de esa función, no una combinación actual prescrita para toda instalación. Con rutas personalizadas puede omitirse la edición automática; la migración de base tampoco actualiza Gerbil automáticamente.
Verifique:
- Login del panel.
- Site y Newt reconectados.
- HTTPS y aplicación real accesibles.
- Usuarios sin autorización bloqueados.
- Caducidad y revocación de enlaces.
- Copias fuera de directorios web públicos.
Si el esquema cambió, volver a una sola imagen antigua puede fallar. Restaure datos y configuración previos completos con versiones correspondientes cuando necesite rollback.
Un 502 no demuestra que todo el túnel funciona; suele indicar un paso upstream fallido. Revise en orden:
- Pruebe el destino desde Newt. En
curl -I http://目标IP:端口, sustituya IP/puerto por el destino real, como el NAS del bloque siguiente. - Confirme el Site seleccionado.
- Compruebe HTTP/HTTPS y TLS interno.
- Verifique si el servicio solo escucha en
127.0.0.1. - Confirme que el firewall LAN permite llegar desde Newt.
- Consulte logs de Newt y del VPS.
# Newt 主机
ip route
curl -v http://192.168.1.20:5000/
sudo journalctl -u newt -n 200 --no-pager
# Pangolin VPS
cd /opt/pangolin
docker compose ps
docker compose logs --since=15m
Ejecute los primeros comandos de este bloque en Newt y los posteriores al cambio de directorio en el VPS. localhost es la máquina o espacio de red del conector, no el NAS automáticamente. Revise direcciones y rutas Docker si destino o conector están en contenedores.
sudo systemctl status newt --no-pager
sudo journalctl -u newt -n 200 --no-pager
sudo stat -c '%a %U:%G %n' /etc/newt/newt.env
Compruebe:
- Site ID/Secret correctos y sin espacios sobrantes.
- Endpoint resuelto al VPS actual.
- UDP 51820, o puerto real del Site, permitido por el proveedor.
- Restricciones UDP y estabilidad de red doméstica.
- Hora sincronizada en ambas máquinas.
- Compatibilidad entre servidor y Newt.
Después revise DNS, hora y HTTPS:
getent ahosts pangolin.example.com
curl -I https://pangolin.example.com
timedatectl status
HTTPS correcto no prueba UDP. No publique comandos completos con secretos ni entornos en soporte público. Si se filtraron, rote credenciales del Site y actualice/reinicie el conector; borrar el mensaje no basta.
dig +short A pangolin.example.com
dig +short AAAA pangolin.example.com
curl -I http://pangolin.example.com
sudo ss -lntp | grep -E ':(80|443)\b'
cd /opt/pangolin
docker compose logs --since=30m | grep -iE 'acme|certificate|challenge|error'
Confirme:
- A apunta al VPS actual.
- AAAA únicamente con IPv6 funcional.
- Firewalls de proveedor y host permiten puertos del método ACME, normalmente 80/443 aquí.
- Ningún proxy antiguo ocupa esos puertos.
- CDN/proxy no interfiere con validación.
- Dominios y correo ACME correctos.
Corrija la causa antes de repetir: los límites de la CA pueden prolongar el fallo. Certificados comodín por DNS requieren configuración DNS propia, no solo estas pruebas HTTP.
Compare dominio público, HTTPS, cookies y callback externo con la URL real del navegador. Pruebe ventana privada.
Si nunca aparece autenticación:
- Confirme Platform SSO en recurso o política heredada.
- Busque Allow/Bypass demasiado amplio.
- Pruebe sin sesión y desde datos móviles.
- Revise prioridad y condiciones de coincidencia.
- Quite bypass temporal y vuelva a probar acceso denegado.
Un administrador ya conectado puede tener cookies y privilegios que un visitante no posee. Pruebe acceso autorizado, no autorizado y anónimo por separado.
- A/AAAA corresponden a IP reales alcanzables.
- Exposición 80/TCP, 443/TCP, 51820/UDP y 21820/UDP de clientes deliberada.
- SSH restringido y consola de recuperación disponible.
- Certificados de panel y recursos válidos.
- Entorno Newt con modo 600 y credenciales privadas.
- Destino permite solo fuentes LAN necesarias.
- Autenticación pública activa sin bypass amplio permanente.
- Enlaces caducan y se revocan al terminar.
- Transferencia y banda sostenida dimensionadas.
- Configuración, datos y versiones guardados antes de actualizar.
- Copias fuera del host y restauración probada.
- Pruebas externas de login, recursos y denegación.
El quickstart propio requiere Linux con IP pública y dominio del panel apuntando a él. Newt conecta hacia fuera; la casa normalmente no necesita IPv4 pública ni mapear puertos de aplicaciones.
El de Public Resources sí, incluidos archivos, fotos y vídeo. Verifique rutas de Private Resources según modo y arquitectura real, sin asumir conexión directa propia de otra plataforma.
Puede servir para pruebas con swap y carga muy limitada; la guía básica actual describe 2 GB. Prefiera 2 núcleos/2 GB/20 GB SSD, transferencia suficiente y velocidad sostenida. Archivos grandes suelen encontrar antes el límite de red.
Hay capacidades privadas y TCP/UDP, pero SSO de navegador no autentica cualquier protocolo directo. Use acceso privado y autenticación nativa para administrar; evalúe UDP, latencia, tráfico y restricciones de cada juego.
No. Cualquier host compatible siempre activo que alcance el destino puede servir: NAS, servidor doméstico, pequeño Linux o VM. VLAN aisladas pueden requerir rutas y permisos explícitos.
Un acceso gestionado reduce operación VPS cuando la plataforma externa encaja. Pangolin permite controlar VPS y recorrido con responsabilidad de Docker, seguridad, copias y actualizaciones. Un túnel saliente doméstico no protege automáticamente el recurso publicado.
Las tareas continuas incluyen HTTPS, salud del conector, identidad, permisos, enlaces temporales, transferencia y recuperación probada. Una instalación ligera puede empezar con 2 núcleos/2 GB/20 GB SSD y 1 TB si el uso lo justifica; fotos, archivos y vídeo exigen calcular consumo.
Valide primero panel, Site, Newt y un recurso autenticado. Añada SMTP, identidad externa y más red cuando ese acceso funcione. Mantenga al día versiones elegidas, pruebas de permisos y documentación de recuperación.