Conexión

Ajustes → Conexión define cómo llega ROMKADE Manager a la consola. La primera configuración se describe paso a paso en Conectar tu consola; esta página trata los detalles y los cambios posteriores.

Campos

Campo	Por defecto	Notas
Dirección IP o nombre	—	Puede cambiar cuando se reinicia el router: resérvala en el router (reserva DHCP).
Puerto SSH	22
Usuario	—	A menudo root en los firmwares de consolas portátiles.
Autenticación	Contraseña	Contraseña o Clave SSH. El último campo cambia en consecuencia.
Carpeta de ROMs	según el firmware	/mnt/mmc/Roms en Anbernic. Ajustes → Sistema propone la carpeta encontrada en la consola.

Contraseña o clave SSH

• Contraseña: se guarda con Guardar en el llavero (con Docker, en el volumen de datos; si no, en el llavero del sistema). Nunca vuelve a mostrarse; Sustituir la contraseña la cambia.

• Clave SSH: indica la ruta de la clave privada (por ejemplo ~/.ssh/id_ed25519 desde el código fuente). Su clave pública debe estar en ~/.ssh/authorized_keys en la consola:

  ssh-copy-id -i ~/.ssh/id_ed25519.pub root@192.168.1.42
  

Clave SSH con Docker

ROMKADE Manager se ejecuta en un contenedor: solo ve su volumen de datos, no la carpeta ~/.ssh de tu ordenador. Copia la clave privada en el volumen una sola vez, desde la carpeta romkade (macOS, Linux, o WSL en Windows):

docker compose exec -T romkade sh -c 'cat > /data/id_ed25519 && chmod 600 /data/id_ed25519' < ~/.ssh/id_ed25519

Después indica /data/id_ed25519 como Ruta de la clave privada. La clave se queda en el volumen, legible solo por la cuenta del contenedor. En Windows sin WSL, la contraseña es más sencilla.

Identidad de la consola

La clave SSH de la consola se comprueba en cada conexión. La primera vez, comparas su huella y la apruebas. Si cambia más adelante, la conexión se bloquea: ROMKADE Manager no habla con un dispositivo que no reconoce.

Para aprobar una nueva clave tras un cambio legítimo (firmware reinstalado, tarjeta nueva), vuelve a comprobar la huella con ssh-keyscan como en la primera configuración y, después, apruébala.

Cada consola tiene su propia identidad: los favoritos están vinculados a ella.

Prueba de conexión

Ajustes → Prueba de conexión → Probar comprueba, por orden:

Paso	Comprueba	Solución habitual
Red (puerto 22)	La consola responde en la red	Consola encendida, mismo Wi-Fi, dirección correcta
Servidor SSH	Responde un servidor SSH	Activa SSH en los ajustes de la consola
Clave de la consola	La clave es la aprobada	Apruébala (paso 2) o averigua por qué ha cambiado
Credenciales	Se aceptan el usuario y la contraseña o la clave	Actualiza la contraseña o la clave
Comando en la consola	Se ejecuta un comando sencillo	—
Carpeta de ROMs	La carpeta existe	Corrige la ruta; comprueba que la tarjeta está en su sitio

Cuando un paso falla, los siguientes no se prueban, y la página indica qué hacer. No se modifica nada en la consola.

Comportamiento de la conexión

Todas las funciones comparten una única conexión SSH, que se mantiene abierta 90 segundos después de su último uso. Si la consola deja de responder, las peticiones siguientes fallan de inmediato durante 15 segundos en lugar de esperar cada una a que se agote el tiempo.