SSH, SFTP y herramientas remotas

Lo que puedes hacer

• Busca con Buscar hosts…: coincide con el nombre, el hostname y las etiquetas.
• Filtra con los chips de grupo: Todos y un chip por grupo y subgrupo (el chip de un grupo incluye sus subgrupos). Gestionar grupos abre el gestor de grupos.
• Con un grupo seleccionado, Conectar todos (N) conecta todos los hosts del grupo y de sus subgrupos.
• Los hosts con estrella aparecen en Favoritos y el resto en Todos los Hosts.
• Toca un host para conectar. El menú de cada tarjeta tiene Conectar, Favorito, Editar y Eliminar.
• Agregar Host abre el formulario; Rápido abre Conexión Rápida.
• En el gestor de grupos, Nuevo grupo pide un Nombre, un Grupo padre, un Tema (heredado por los hosts) y Grabar sesiones automáticamente: los hosts de ese grupo y sus subgrupos inician el registro de sesión (la insignia LOG) en cuanto conectan. Eliminar grupo deja sus hosts sin grupo.

Lo que no puedes hacer, y por qué

• Guardar un segundo host en Free, por cualquier puerta: Agregar Host, Conexión Rápida, las importaciones (JSON, SSH config, CSV) y la importación de instancias cloud se detienen en 1 host guardado y muestran el muro de Terminal Pro. El límite es 1 host guardado.Pro
• Dar a un grupo entero un proxy, una identidad por defecto o variables de entorno: en un grupo solo se pueden fijar el tema y Grabar sesiones automáticamente.Aún no

Lo que puedes hacer

• Conexión: una Etiqueta opcional, el Hostname, el Puerto (22 por defecto) y el Usuario.
• Autenticación → Método de Auth: Contraseña, Par de Claves o Interactivo por Teclado. La contraseña se guarda cifrada; al editar un host el campo dice (sin cambios).
• Con Par de Claves, elige una clave de Claves SSH (las vinculadas al dispositivo están marcadas), o elige Pegar manualmente y pega la clave privada, con su Frase de Clave si la tiene. El campo de frase no aparece para claves vinculadas al dispositivo.
• Con Interactivo por Teclado el servidor pide lo que necesite durante la conexión, por ejemplo un código de un solo uso: Se te solicitará durante la conexión.
• Usar identidad rellena el usuario y la credencial desde una identidad guardada; Guardar como identidad guarda los actuales. Una identidad es una plantilla que se copia al host, no un enlace vivo: cambiarla después no cambia los hosts que ya la usaron.
• Organización: elige un Grupo y añade Etiquetas separadas por comas.
• Avanzado: Proxy / Jump Host con un proxy SOCKS5 o HTTP (host y puerto); Host de salto, otro host guardado que hace de bastión, hasta 3 saltos, que aparece cuando tienes otro host guardado; y el interruptor Agent Forwarding.
• Elige un Color y marca el host como favorito con la estrella.

Lo que no puedes hacer, y por qué

• Fijar un comando de inicio o redirecciones de puertos guardadas en un host: el formulario no tiene campos para ello, y guardar un host desde el formulario borra ambos.Aún no
• Usar por sí solo el chip SSH Jump Host: se conserva por datos antiguos y no hace nada. El salto real es la lista Host de salto.Aún no

Lo que puedes hacer

• Escribe usuario@host o usuario@host:puerto en Cadena de Conexión; una dirección IPv6 va entre corchetes, usuario@[::1]:22. Una vista previa muestra el usuario, el host y el puerto.
• Escribe la contraseña en Contraseña (opcional) y toca Conectar. El botón sigue apagado hasta que el texto contiene una @.
• El host se guarda en Hosts antes de conectar, si el plan tiene sitio. En Free, con 1 host ya guardado, conecta igualmente, pero el host nuevo no se guarda y se abre el muro de Terminal Pro.

Lo que no puedes hacer, y por qué

• Conectar con una clave o con un código de un solo uso: Conexión Rápida siempre crea un host con Contraseña, y sin contraseña la pestaña dice Error: No password stored for this host. Usa Agregar Host para claves e Interactivo por Teclado.Aún no

Lo que puedes hacer

• Lee el Host, el Tipo de clave y la Huella Digital (en formato SHA256:) y compárala con la que muestra tu servidor.
• Un servidor nuevo muestra Verificar Clave del Host: Confiar y Conectar guarda la clave y continúa; Rechazar cancela.
• Si la clave guardada y la del servidor difieren, el diálogo se titula ¡Clave del Host Cambiada!, muestra la Huella anterior y avisa de un posible ataque man-in-the-middle. Continúa solo si sabes que el servidor se reinstaló o se reconfiguró.
• Si no respondes en 60 segundos, se rechaza la conexión.

Lo que no puedes hacer, y por qué

• Ver o quitar la lista de servidores de confianza: no hay pantalla para ello. Puedes añadir entradas importando un fichero known_hosts.Aún no

Lo que puedes hacer

• Responde cada aviso en su campo Respuesta N (el texto se oculta o se muestra según pida el servidor) y toca Enviar. Cancelar descarta el intento.
• Tienes 120 segundos para responder.

Lo que no puedes hacer, y por qué

• Guardar las respuestas: cada conexión vuelve a preguntar.A propósito

Lo que puedes hacer

• Reconoce las claves vinculadas al dispositivo por su insignia Vinculada al dispositivo.
• Importar un fichero de clave privada de tu teléfono con el selector de archivos del sistema; el nombre del fichero pasa a ser la etiqueta.
• Generar clave crea un par nuevo (sección siguiente).
• Copiar clave pública pone la clave pública en el portapapeles.
• Desplegar añade la clave pública a ~/.ssh/authorized_keys del servidor de la sesión en primer plano, creando la carpeta con modo 700 y el fichero con modo 600. El botón aparece mientras hay una sesión abierta. La pestaña escribe [Key deployed to authorized_keys] cuando el comando se ha ejecutado; PocketCode no comprueba su resultado, así que prueba la clave después.
• Eliminar borra la clave; en una clave vinculada al dispositivo también la borra del Keystore de Android.

Lo que no puedes hacer, y por qué

• Copiar o desplegar la clave pública de una clave importada: la app no guarda clave pública de las importaciones (la tarjeta muestra imported en lugar de una huella). Una clave importada solo firma conexiones.Aún no
• Exportar la clave privada de una clave vinculada al dispositivo: nunca sale del Keystore de Android.A propósito

Lo que puedes hacer

• Rellena Etiqueta de la clave y elige un Tipo de clave con su Tamaño en bits: RSA (2048 o 4096, con 4096 preseleccionado), ED25519 (256), ECDSA (256, 384 o 521), DSA (1024) o DEVICE-BOUND.
• Añade una Frase de contraseña opcional a la clave privada (no para DEVICE-BOUND).
• DEVICE-BOUND crea una clave ECDSA P-256 dentro del Keystore de Android. La clave privada no se puede exportar, copiar ni sincronizar; solo la clave pública sale del teléfono. Requerir biometría/PIN reciente para firmar viene activado: la clave solo firma durante los 30 segundos posteriores a que te autentiques con biometría o con el PIN del dispositivo. PocketCode no muestra un aviso propio al conectar.

Lo que no puedes hacer, y por qué

• Usar una clave vinculada al dispositivo en otro teléfono o restaurarla desde una copia de seguridad.Dispositivo

Lo que puedes hacer

• Una pulsación larga en una pestaña abre Renombrar, Duplicar sesión (en pestañas que vienen de un host guardado) y Cerrar otras pestañas (si hay más de una).
• Cerrar una pestaña que sigue conectada pregunta ¿Cerrar sesión activa?: al cerrarla se desconecta y se detienen sus redirecciones de puertos. Cerrar otras pestañas siempre pregunta.
• Cuando vuelve la red, PocketCode reconecta solo las sesiones caídas. El interruptor está en Configuración → Terminal → Reconexión automática del terminal, activado por defecto. La pestaña escribe [Network connection lost] y después [Network restored — reconnecting…].

Lo que no puedes hacer, y por qué

• Tener más de una sesión abierta en Free: abrir otra pestaña, conectar un segundo host, Duplicar sesión y Shell Multiplexado muestran el muro de Terminal Pro. El límite es 1 sesión SSH activa; un shell local en la pantalla Terminal se cuenta aparte.Pro
• Mantener las sesiones activas en segundo plano sin ayuda de Android: puede pausar o cortar las sesiones SSH y las redirecciones de puertos al cambiar de app, salvo que PocketCode esté excluida de la optimización de batería. La app lo pregunta una vez: Mantén las sesiones SSH activas en segundo plano → Abrir ajustes.Dispositivo

Lo que puedes hacer

• Shell Multiplexado abre otra shell sobre la misma conexión SSH en una pestaña nueva llamada <host> (mux).
• Difundir envía cada comando que escribes a todas las pestañas conectadas a la vez; las pestañas de shell local que estén conectadas también lo reciben. Mientras está activo se ve la insignia BROADCAST; toca Difusión desactivada para pararlo.

Lo que no puedes hacer, y por qué

• Usar Difundir en Free: muestra el muro de Terminal Pro.Pro
• Llegar a Difundir y Shell Multiplexado desde el panel acoplado en una pantalla ancha: solo existen en el menú de herramientas, que el diseño acoplado oculta. Estrecha la ventana por debajo de unos 660 dp, o activa la vista dividida (Pro), para recuperar el menú.A propósito

Lo que puedes hacer

• Explora el servidor: primero las carpetas y luego los archivos, cada fila con sus permisos y, en los archivos, su tamaño. Toca una carpeta para abrirla y usa la flecha de retroceso para subir.
• Nueva carpeta y, desde el menú Más opciones de una fila, Renombrar o Eliminar.
• Mantén pulsada una fila para empezar a seleccionar, toca para añadir más y elimínalas juntas. Se te pregunta ¿Eliminar N elementos seleccionados? No se puede deshacer. Cada elemento se borra por separado, así que un fallo no detiene al resto.
• Vista de dos paneles cambia al diseño de dos paneles.

Lo que no puedes hacer, y por qué

• Descargar, subir o abrir un archivo desde esta vista: tocar un archivo no hace nada, solo se abren las carpetas.Aún no
• Eliminar una carpeta que aún tiene archivos: las carpetas se borran con la llamada SFTP rmdir, así que vacíalas antes.A propósito
• Ver por qué falló una operación: los errores no se muestran. Una carpeta que no se puede leer parece vacía (Este directorio está vacío), y un renombrado o borrado fallido deja la lista como estaba.Aún no

Lo que puedes hacer

• El panel Local empieza en la carpeta que contiene tus proyectos; el panel Remoto empieza en /. Toca una carpeta para abrirla y usa la flecha de la parte superior de un panel para subir.
• Vuelve con Vista de un panel.

Lo que no puedes hacer, y por qué

• Copiar un archivo entre los paneles arrastrándolo: la hoja lo ofrece, pero el soltar todavía no está conectado a la transferencia, así que no se copia nada.Aún no

Lo que puedes hacer

• Ver las transferencias en cola (Esperando, Completada, Fallida), cancelar una o limpiar las terminadas con Limpiar Completadas.

Lo que no puedes hacer, y por qué

• Añadir una transferencia a la cola: nada en la app le envía archivos todavía, así que siempre dice No hay transferencias activas.Aún no

Lo que puedes hacer

• Toca Adjuntar archivo y elige un archivo: se sube por SFTP a /tmp/<nombre del archivo> del servidor, y la ruta se escribe en la barra de entrada, lista para tu siguiente comando.

Lo que no puedes hacer, y por qué

• Elegir el destino o conservar un archivo existente: el archivo va siempre a /tmp, y uno con el mismo nombre se sobrescribe.A propósito

Lo que puedes hacer

• Añadir regla abre un formulario: Tipo (Local (L), Remoto (R) o Dinámico), Etiqueta, Puerto local, Host remoto (preajustado a localhost), Puerto remoto e Inicio automático.
• Local (L) escucha en un puerto de tu teléfono y envía el tráfico a través del servidor a Host remoto:Puerto remoto, tal como lo ve el servidor. Por ejemplo, llegar a una base de datos del servidor por localhost:5432.
• Remoto (R) escucha en Puerto remoto en el servidor y envía el tráfico a Host remoto:Puerto local, al que se llega desde tu teléfono (localhost por defecto). Por ejemplo, exponer un servidor de desarrollo que corre en el teléfono.
• Cada regla muestra Activo o Detenido; puedes iniciarla, detenerla o borrarla.
• Cerrar la pestaña o desconectar termina las redirecciones de la sesión.

Lo que no puedes hacer, y por qué

• Tener más de 1 regla a la vez en Free (contada sobre la sesión en primer plano).Pro
• Usar Dinámico como proxy SOCKS: la regla se llama Proxy SOCKS y escribe SOCKS5 proxy on localhost:N, pero la app la implementa como una redirección simple de ese puerto a localhost en el mismo número de puerto, no como un proxy SOCKS5.Aún no
• Conservar las reglas entre sesiones: no se guardan con el host, así que Inicio automático no tiene nada que iniciar en la siguiente conexión.Aún no

Lo que puedes hacer

• Nueva conexión: protocolo VNC (puerto 5900) o RDP (3389), una etiqueta, host, puerto, un usuario (RDP) y una contraseña, un nivel de calidad y Solo lectura.
• Conectar abre una conexión directa a ese host y puerto (no por SSH), hace el saludo VNC (sin autenticación, o con contraseña VNC) y escribe Connected: con el nombre del servidor y el tamaño de pantalla en una pestaña nueva, además de cualquier aviso sonoro o texto del portapapeles que envíe el servidor.

Lo que no puedes hacer, y por qué

• Ver o controlar la pantalla remota: la conexión lee las actualizaciones de pantalla y las descarta, y no hay vista ni entrada de ratón o teclado.Aún no
• Usar RDP: elegir RDP ejecuta el mismo código VNC y no hay cliente RDP.Aún no

Lo que puedes hacer

• Ver Dispositivos detectados, los dispositivos USB que informa Android.
• Añadir configuración: Dispositivo (vacío = auto), Baud (115200 por defecto), Bits (8), Stop (1) y un menú Paridad (Ninguna, Impar, Par, Mark, Space). Ese menú y los botones Guardar y Cancelar están siempre en español.
• El botón de reproducir de una configuración guardada conecta: busca el dispositivo con la API de host USB de Android, abre su interfaz de datos serie y fija la codificación de línea; si todo va bien, la pestaña dice Connected to ….
• La primera vez, el propio diálogo de Android pide permiso para usar el dispositivo USB (la pestaña escribe Requesting USB permission for <dispositivo>…). Concédelo y la conexión sigue; PocketCode espera tu respuesta hasta 60 segundos.

Lo que no puedes hacer, y por qué

• Conectar tras rechazar el permiso USB, o tras 60 segundos sin contestar a su diálogo: la pestaña escribe USB permission not granted for <dispositivo> y la sesión acaba en error. Pulsa reproducir otra vez para reintentarlo.Dispositivo
• Usar un adaptador que no exponga una interfaz de datos CDC o específica del fabricante con endpoints bulk: la pestaña escribe USB device does not have expected CDC serial endpoints.Dispositivo

Lo que puedes hacer

• Toca un chip para ejecutar el CLI de ese proveedor en el servidor de la sesión en primer plano (aws ec2 describe-instances, gcloud compute instances list, az vm list, doctl compute droplet list, kubectl get pods, docker ps). El CLI tiene que estar instalado en el servidor. La pestaña escribe [Cloud discovery (AWS): N bytes received].
• Importar instancias (JSON): pega un array JSON como [{"provider":"AWS","name":"…","publicIp":"…"}]. Cada instancia con dirección IP se guarda como host (usuario root, puerto 22, etiquetado con su proveedor) y aparece en Instancias (N) con Conectar. En Free solo se guardan como hosts las que caben en el límite de 1 host, pero todas las instancias aparecen en Instancias (N); para el resto se abre el muro de Terminal Pro.

Lo que no puedes hacer, y por qué

• Importar instancias automáticamente: el descubrimiento solo escribe cuántos bytes devolvió el CLI y no convierte la salida en instancias. El JSON hay que pegarlo.Aún no
• Conectar a una instancia importada sin añadir antes credenciales: los hosts importados son hosts con Contraseña sin contraseña guardada. Edita el host para añadir una contraseña o elegir una clave.Aún no

Lo que puedes hacer

• Agregar watchdog: Etiqueta, Comando (preajustado a systemctl is-active nginx), Salida esperada (preajustada a active) e Intervalo (segundos) (preajustado a 60).
• Inicia o detén un monitor con su interruptor, o bórralo. La primera comprobación se hace tras un intervalo.
• Cada comprobación ejecuta el comando sobre la sesión que estaba en primer plano al iniciar el monitor. Si la salida no contiene el texto esperado (sin distinguir mayúsculas), la pestaña escribe ⚠ Watchdog alert: <comando> → <salida> y el monitor se marca como fallido.

Lo que no puedes hacer, y por qué

• Crear un watchdog en Free.Pro
• Recibir una notificación del sistema: las alertas son líneas en la pestaña del terminal, y los monitores solo corren mientras la app está en marcha.A propósito
• Ligar un monitor a un host concreto: corre sobre la sesión que esté en primer plano cuando lo inicias.A propósito

Lo que puedes hacer

• Crear webhook: Nombre, Seleccionar host y Comando. Cada webhook muestra su enlace, pocketcode://terminal/webhook/<id>?secret=<secreto>, enmascarado en pantalla y con un botón de copiar, además de un interruptor Activo / Inactivo, N ejecuciones y Eliminar.
• Cuando algo abre el enlace, PocketCode comprueba el id y el secreto. Solo si el webhook está activo y ambos coinciden pregunta ¿Ejecutar la automatización? (Un enlace ha pedido ejecutar la regla «X» en HOST.). Ejecutar conecta con el host y envía el comando; Cancelar no hace nada. Un secreto equivocado no recibe respuesta alguna.

Lo que no puedes hacer, y por qué

• Crear un webhook en Free.Pro
• Ejecutar un webhook sin supervisión: cada disparo pide antes tu confirmación.A propósito
• Disparar un webhook desde la web: solo existe el enlace pocketcode://. La app no abre un puerto de escucha en tu teléfono para ejecutar comandos en tus servidores.A propósito

Lo que puedes hacer

• Lista los paquetes instalados del host (lee pkg list-installed y, si falla, dpkg -l, quedándose con los instalados), búscalos con Buscar paquetes… y actualiza.
• Actualizar Todo (apt update && apt upgrade -y), Listar Todo, Limpiar (apt autoclean) e Instalar (pide Ingresa un nombre de paquete: y ejecuta apt install <nombre> -y).
• Sobre un paquete: su información (apt show) y quitarlo (apt remove <nombre> -y).

Lo que no puedes hacer, y por qué

• Usar otro gestor de paquetes (yum, dnf, apk…): los comandos están fijados a apt.Aún no
• Ejecutar los comandos con sudo automáticamente: corren como tu usuario SSH tal cual se escriben, así que en un servidor donde ese usuario no es root pueden fallar con un error de permisos.A propósito

Lo que puedes hacer

• Sincronizar genera una copia de tus hosts, tus snippets y algunos ajustes del terminal; los interruptores de Datos a sincronizar eligen qué entra. Última sincronización muestra cuándo se hizo.
• Conexiones en tu cuenta (un camino distinto de esta copia): con Activar sincronización en el diálogo Sincronización de Configuración (Cloud Sync, función Pro) y Conexiones (SSH/DB) marcada, guardar, editar, marcar con estrella o eliminar un host envía sus datos a tu cuenta de PocketCode: nombre, dirección, puerto, usuario, tipo de autenticación, etiquetas, favorito, grupo, proxy y el ajuste de reenvío de agente. Las contraseñas, las claves, las frases de paso y el comando de inicio se quedan en el teléfono. Los hosts que llegan por las importaciones JSON, SSH config o CSV no se envían. La misma casilla también lleva las conexiones del módulo Base de Datos, pero solo con su propio juego, más corto, de datos (nombre, host, puerto, motor y grupo): nunca un usuario ni una contraseña. Con Cloud Sync apagado, o esa casilla sin marcar, no sale nada.
• Cifrado end-to-end → Activar cifrado pide una Contraseña maestra y cifra la copia con AES-256-GCM, con una clave derivada de la contraseña (PBKDF2, 100 000 rondas). No se puede recuperar si la pierdes.

Lo que no puedes hacer, y por qué

• Recuperar en otro dispositivo los hosts sincronizados: la app guarda la lista que descarga, pero nada la convierte en hosts.Aún no
• Enviar esta copia a otro dispositivo o a la nube: la copia se escribe en un fichero dentro de la app (terminal_sync_backup.json) y no se sube nada; la app no tiene forma de restaurar desde ella.Aún no
• Incluir claves SSH: el interruptor Claves SSH existe, pero la copia nunca contiene claves.Aún no

Lo que puedes hacer

• Alojar una sala: ponle un Nombre de la sala y comparte el Código de 6 dígitos que muestra.
• Unirse a una sala: las salas cercanas se encuentran en la red local, o escribes el Código de 6 dígitos. Quien aloja ve Nueva solicitud (N quiere unirse) y toca Aceptar o Rechazar.
• La lista de miembros muestra cada rol: Solo lectura, Lectura y escritura o Admin. Quien aloja puede cambiar roles y quitar miembros; cualquiera puede Salir de la sala y quien aloja puede Cerrar sala.
• El tráfico entre dispositivos va cifrado (acuerdo de claves ECDH y AES-GCM). Desde Android 13, la primera vez que alojas una sala, buscas salas o te unes a una, Android pide el permiso de dispositivos cercanos (red local); hasta que lo concedas, esas tres acciones siguen bloqueadas.

Lo que no puedes hacer, y por qué

• Compartir hosts o snippets en una sala: la pista dice que se aloja o se une uno a una sala para compartirlos en vivo, pero hoy solo funcionan los miembros y los roles.Aún no
• Usar una sala fuera de tu red local: el descubrimiento y la conexión son solo LAN.Requiere red
• Conservar una sala tras reiniciar la app: una sala existe solo mientras está activa.A propósito

Lo que puedes hacer

• El JSON incluye tus hosts (nombre, dirección, puerto, usuario, tipo de autenticación, etiquetas, color, favorito y comando de inicio), tus grupos (nombre, color, icono) y tus snippets propios, no los predefinidos.

Lo que no puedes hacer, y por qué

• Exportar contraseñas, claves o ajustes: nunca están en el JSON. Al importarlo de nuevo se recrean los grupos, pero los hosts no vuelven a colocarse en ellos.Aún no
• Cifrar la exportación con una contraseña, guardarla como fichero o mostrarla como código QR: el texto es plano y copiar y pegar es la única vía de entrada y salida.Aún no

Lo que puedes hacer

• JSON: la exportación anterior. Los hosts ya guardados (mismo hostname, puerto y usuario) se omiten.
• SSH config: cada bloque Host se convierte en un host; los bloques con patrón comodín como Host * se omiten. Un bloque con IdentityFile pasa a ser un host de Par de Claves sin la clave, y ProxyJump pasa a ser un Host de salto cuando apunta a un host que existe.
• known_hosts: las entradas en texto plano pasan a ser servidores de confianza; las entradas con hash (lo habitual en OpenSSH) no se pueden recuperar y se omiten.
• CSV: necesita una fila de cabecera. Columnas reconocidas: label (o name), hostname (o host, address), port, username (o user) y group (o folder); solo el hostname es obligatorio. El grupo se busca por nombre o se crea.

Lo que no puedes hacer, y por qué

• Importar desde un fichero o un código QR: la hoja solo admite texto pegado.Aún no
• Importar contraseñas o claves: ningún formato las lleva, así que los hosts importados necesitan que añadas las credenciales en Editar Host.A propósito