Usar el servidor de casa desde Android

1. Cómo funciona

La interfaz se carga desde GitHub Pages en el navegador de Android y habla con 127.0.0.1:6883 de la propia tablet. El cliente SSH (ConnectBot o Termux) redirige ese puerto al 127.0.0.1:6883 del equipo de casa, donde corre el servidor local. Así, archivos, comandos y servicios MCP son los de casa. Sin túnel, el equipo de casa también puede publicarse con un proxy inverso.

• Sin exponer ZeroChat: el servidor sigue escuchando solo en 127.0.0.1; lo único accesible desde fuera es SSH.
• Puerto 6883: distinto del 6388 por defecto, para que convivan el ZeroChat del escritorio y el de la tablet.
• Modelo en casa: si usas LM Studio u otro servidor de modelos en el mismo equipo, redirige también su puerto (1234 en LM Studio) y apunta el perfil a http://127.0.0.1:1234/v1.

2. Preparar el equipo de casa

Endurecer sshd (recomendado)

En /etc/ssh/sshd_config (o un fichero en /etc/ssh/sshd_config.d/), solo claves y solo tu usuario; después reinicia el servicio (sudo systemctl restart sshd):

PasswordAuthentication no
KbdInteractiveAuthentication no
PermitRootLogin no
AllowUsers usuario
AllowTcpForwarding local

Orden de arranque

El servidor se lanza en la propia sesión SSH, desde el directorio del proyecto y sin abrir el navegador de casa. No hace falta copiar ninguna URL: la tablet se identifica en la página con el usuario y la contraseña de la cuenta de casa (sección 3).

cd ~/proyectos/mi-proyecto && zerochat --no-browser --keep-server --port 6883

• Directorio de trabajo: el cd elige el directorio del proyecto, que aparece en la cabecera del servidor. Después puedes cambiarlo desde la interfaz, en el modo proyecto.
• --keep-server: el navegador de Android deja de enviar latidos cuando la pestaña pasa a segundo plano; sin esta opción el servidor se cerraría al minuto de cambiar de aplicación. Con ella la página no envía latidos: relee el estado del servidor, o reconecta, al volver a la pestaña.
• Vive con la sesión: al cerrar la sesión SSH, ZeroChat se detiene junto con los comandos que tenga en marcha. Al reconectar arranca de nuevo con el mismo token del día; vuelve a la pestaña y la página reconecta sola.
• Ruta de zerochat: una sesión SSH con orden forzada o automatizada no carga tu PATH completo. Si zerochat no está en /usr/bin, usa la ruta completa que muestra command -v zerochat.

Clave restringida (opcional)

Para que la tablet no tenga consola en casa, crea un par de claves solo para ella y añade la pública a ~/.ssh/authorized_keys con estas restricciones, en una sola línea. Con ella solo se puede abrir el túnel a esos dos puertos y lanzar ZeroChat:

restrict,pty,port-forwarding,permitopen="127.0.0.1:6883",permitopen="127.0.0.1:1234",command="cd ~/proyectos/mi-proyecto && /home/usuario/venv/bin/zerochat --no-browser --keep-server --port 6883" ssh-ed25519 AAAA… tablet

pty es necesario: con terminal, al cerrar la sesión ZeroChat recibe la señal de cierre y se detiene; sin ella seguiría en marcha ocupando el puerto.

3. Conectar desde Android

ConnectBot

1. En las claves públicas de ConnectBot, genera una clave Ed25519 y copia su parte pública al authorized_keys de casa (sección 2).
2. Crea el host usuario@casa con esa clave.
3. En las redirecciones de puertos (Port forwards) del host, añade dos de tipo Local: 6883 → 127.0.0.1:6883 y 1234 → 127.0.0.1:1234.
4. Conecta. Con la clave restringida, la sesión no admite órdenes: solo mantiene el túnel y ZeroChat.

Sin la clave restringida, escribe la orden de arranque en la consola o ponla en la automatización tras el inicio de sesión (Post-login automation) del host para lanzarla al conectar.

Termux

Con la clave restringida basta con abrir la sesión, sin -N, para que arranque ZeroChat:

ssh -i ~/.ssh/tablet -L 6883:127.0.0.1:6883 -L 1234:127.0.0.1:1234 usuario@casa

Sin ella, pasa la orden de arranque con -t, para que la sesión tenga terminal y ZeroChat se detenga al cerrarla:

ssh -t -L 6883:127.0.0.1:6883 -L 1234:127.0.0.1:1234 usuario@casa 'cd ~/proyectos/mi-proyecto && zerochat --no-browser --keep-server --port 6883'

En el navegador

1. Abre ZeroChat y abre el panel de Conexión (el icono del enchufe, junto a la rueda de configuración de la barra lateral).
2. Desactiva Conexión local, escribe http://127.0.0.1:6883 como URL del servidor local, deja Usar proxy desactivado y pulsa Conectar.
3. Identifícate con el usuario y la contraseña de la cuenta que ejecuta ZeroChat en casa. La página guarda el token del día, nunca la contraseña.

• Acceso a la red local: si el navegador pide permiso para que la página acceda a dispositivos de la red local, acéptalo; sin él no llega a 127.0.0.1.
• Configuración propia: perfiles, claves API y conversaciones se guardan en el navegador de la tablet, separados de los del escritorio. Crea allí el perfil con el modelo de casa.
• Identificación: el token del día caduca a medianoche y entonces la página vuelve a pedir el usuario y la contraseña, sin detener el servidor. Tras 5 intentos fallidos seguidos, ZeroChat rechaza los siguientes durante 15 minutos.

4. Situaciones habituales