Documentación

Inicio rápido + descripción de cada función y de cada dispositivo (en constante actualización)

Preguntas frecuentes FAQ

Este documento reúne los problemas más habituales que surgen al usar el panel y cómo diagnosticarlos.

Instalación y acceso

P: ¿Qué hace falta para instalar el panel?

Un servidor Linux con IP pública (se recomiendan distribuciones populares como Debian / Ubuntu / CentOS), con 512 MB de memoria o más ya funciona con fluidez. Los servidores gestionados no necesitan instalar nada: basta con poder conectarse por SSH.

P: ¿Cuáles son la cuenta y la contraseña predeterminadas?

La cuenta predeterminada es admin y la contraseña 123456. Cámbialas inmediatamente tras el primer acceso (icono de usuario en la esquina superior derecha del panel → ajustes de usuario).

P: ¿Qué hago si olvido la contraseña de acceso?

Si ya la habías cambiado y la has olvidado, puedes restablecerla en el servidor del panel. Ejecuta el siguiente comando para restablecerla a la predeterminada (o para indicar una nueva contraseña):

# Entra en el directorio de instalación del panel y usa el script integrado para restablecer la contraseña
cd /opt/ssh-everywhere
python3 -c "from app import reset_password; reset_password('nueva-contraseña')"

> El nombre exacto del script puede cambiar según la versión; también puedes editar directamente la tabla users de la base de datos data/ssheverywhere.db.

P: ¿Cómo cambio el puerto del panel (5501)?

Modifica el Environment=PORT=5501 del servicio systemd y luego recarga:

systemctl edit ssh-everywhere.service
# Añade o modifica: Environment=PORT=tu-puerto
systemctl daemon-reload && systemctl restart ssh-everywhere.service

Cuando termines, recuerda abrir el nuevo puerto en el cortafuegos en la nube/grupo de seguridad.

P: ¿No puedo acceder al panel (puerto 5501)?

Diagnostica en este orden:

1. Confirma que el servicio del panel está en ejecución: systemctl status ssh-everywhere.service

2. Comprueba si el cortafuegos en la nube/grupo de seguridad del servidor del panel permite el 5501 (esta es la causa más habitual)

3. Confirma que accedes a http://IP-pública-del-servidor:5501 (no https, salvo que hayas configurado un proxy inverso)

Relacionado con los servidores

P: ¿Qué hago si un servidor aparece «sin conexión»?

«Sin conexión» solo indica que el panel no puede conectarse a él por SSH; no significa que el servidor esté caído. Diagnostica en este orden:

1. Confirma que el servidor está encendido: mira el estado de alimentación en la consola del proveedor

2. Comprueba si el puerto SSH es alcanzable: desde el servidor del panel ejecuta nc -zv <IP-de-destino> <puerto> para ver si el puerto responde

3. Revisa el cortafuegos/grupo de seguridad: si el cortafuegos en la nube/grupo de seguridad del servidor de destino permite el puerto SSH

4. En servidores NAT, revisa el mapeo de puertos: confirma que el mapeo de puertos NAT sigue existiendo y que la IP interna de destino es correcta

5. Revisa la lista blanca de IP de origen: algunos proveedores limitan el acceso al puerto SSH por IP de origen; hay que añadir la IP del servidor del panel a la lista blanca

6. Verifica la cuenta y la contraseña: si el usuario y la contraseña/clave privada son correctos

P: ¿No se conecta al añadir un servidor?

  • Confirma que el puerto SSH, el usuario y la contraseña son correctos
  • Confirma que el sshd del servidor de destino está en ejecución
  • Confirma que el cortafuegos permite el puerto SSH
  • Las grandes nubes (Tencent Cloud/Alibaba Cloud) desactivan root por defecto: inicia sesión con un usuario normal (como ubuntu)

P: ¿No se conecta un servidor NAT (puerto distinto del 22)?

El mapeo de puertos del servidor NAT debe ser accesible desde la red en la que está el servidor del panel. Causas habituales:

  • El mapeo de puertos ya no funciona (compruébalo o recréalo en el panel del proveedor)
  • El proveedor aplica una lista blanca por IP de origen (añade la IP del servidor del panel)
  • La IP/puerto interno de destino del mapeo está mal

Relacionado con la penetración / el reenvío de puertos

P: ¿La penetración de puertos aparece «sin conexión»?

  • La penetración depende de que el Agent esté en línea. Si el Agent está sin conexión (el dispositivo apagado, la red cortada o el Agent detenido), la penetración se interrumpe
  • Después de reiniciar el servicio del panel, la penetración se recupera automáticamente cuando el Agent vuelve a conectarse; solo hay que esperar un poco
  • Confirma que el cortafuegos en la nube del servidor del panel permite el puerto de escucha

P: ¿El reenvío de un puerto distinto del 22 no funciona?

Para reenviar puertos que no son SSH (como 9117), el servidor de penetración debe tener instalado el Agent de la versión nueva (las versiones antiguas solo admiten el 22). Basta con reinstalar el Agent.

P: ¿He creado un reenvío de puertos pero no funciona?

El reenvío de puertos tradicional debe hacerse en el propio servidor con IP pública propia. Comprueba:

1. Si el servidor de destino/el cortafuegos intermedio permite el puerto de destino

2. Si la IP de destino que has puesto es una dirección realmente alcanzable

3. Si el grupo de seguridad de la nube bloquea el puerto de escucha

P: ¿Qué diferencia hay entre penetración de puertos y reenvío de puertos?

  • Penetración de puertos: se usa para dispositivos sin IP pública, va por el túnel inverso y abre un puerto público en el servidor del panel.
  • Reenvío de puertos: se usa para servidores con IP pública, va por el DNAT del cortafuegos del sistema y se hace en el propio servidor de destino.

Para más detalles, consulta Penetración de puertos y Reenvío de puertos.

Relacionado con Docker / la instalación de aplicaciones

P: ¿Qué hago si falla la instalación del Catálogo de aplicaciones/Docker?

El panel muestra el mensaje de error tal cual (no informa de un éxito falso). Causas habituales:

1. Distribución demasiado antigua: las versiones ya EOL como Fedora 32 tienen los repositorios sin mantenimiento y la instalación agota el tiempo de espera o falla. Se recomienda actualizar el sistema.

2. Red inalcanzable: la fuente oficial de Docker (get.docker.com / download.docker.com) puede no ser accesible en algunos entornos de red (como servidores NAT de China continental). En ese caso hay que configurar un espejo nacional de Docker o usar la función «fuentes de espejo» para cambiar al espejo de Alibaba Cloud.

3. Diferencias en los nombres de los paquetes: algunas aplicaciones (como ufw o el deb.nodesource de Node.js) dependen de una distribución concreta y puede que no se instalen fuera de Debian/Ubuntu; el mensaje de error lo indicará claramente.

P: ¿La descarga de imágenes de Docker es muy lenta o agota el tiempo de espera en servidores de China continental?

Es un problema de red, no del panel. Se recomienda configurar un acelerador de imágenes de Docker (aceleradores públicos como docker.1ms.run / docker.m.daocloud.io), o ejecutar antes en el servidor:

# Referencia: configurar el acelerador personal de Alibaba Cloud (hay que sustituirlo por la dirección de tu acelerador)
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<'EOF'
{ "registry-mirrors": ["https://dirección-de-tu-acelerador"] }
EOF
sudo systemctl restart docker

Técnicas generales de diagnóstico

1. Comprueba primero si el puerto responde y luego revisa la cuenta y la contraseña: nc -zv <IP> <puerto>

2. Compara con otros servidores: si un servidor del mismo tipo sí conecta y este no, el problema es específico de este (cortafuegos/mapeo/lista blanca)

3. Mira los registros: los registros del panel están en service.log; los registros de la penetración/del Agent ayudan a localizar problemas de conexión