¿Ya estás en un directorio remoto y necesitas subir un archivo de configuración o traer un registro a tu dispositivo? La implementación nativa de ZMODEM de NeoServer te permite transferir archivos dentro del terminal SSH: ejecuta rz para subir o sz para descargar. Un panel de transferencia se encarga de la selección de archivos, el progreso, la confirmación de recepción y la cancelación.
Soporte en iOS y macOS
El flujo de trabajo que se describe a continuación usa el terminal de iOS de NeoServer, incluida la app basada en iOS en macOS. El terminal nativo independiente de macOS todavía no cuenta con esta integración de ZMODEM en la implementación actual. En un Mac, comprueba qué edición estás usando antes de probar los comandos.
Aquí, ZMODEM nativo significa que el protocolo de transferencia está implementado directamente en Swift, incluidos el enmarcado, la verificación CRC y la retransmisión. No se necesita ninguna extensión de navegador ni un puente de transferencia en JavaScript.
Prepara el servidor remoto
Usa una conexión de terminal SSH y asegúrate de que la máquina remota proporciona rz y sz. El proyecto lrzsz ofrece implementaciones de línea de comandos de los protocolos de transferencia. Comprueba los comandos en tu shell remoto:
command -v rz
command -v sz
Si falta alguno de los dos comandos, instala el paquete lrzsz de la distribución de tu servidor o pide al administrador que lo proporcione. NeoServer se encarga de la parte del cliente; la máquina remota sigue necesitando el emisor o el receptor correspondiente.
Empieza con un shell SSH directo. Las conexiones Mosh no transmiten el flujo de bytes del terminal en bruto que requiere esta integración. Si usas tmux, screen o zellij, esa capa intermedia también debe pasar correctamente el tráfico ZMODEM.
Sube archivos con rz
rz significa que la máquina remota recibe archivos. Desde el punto de vista de tu dispositivo, se trata de una subida.
- En el terminal remoto, cámbiate al directorio de destino y compruébalo con
pwd. - Ejecuta
rz. - NeoServer abre su panel ZMODEM. Selecciona Choose Files y elige uno o más archivos locales.
- Observa el progreso y espera a que termine antes de volver al trabajo normal en el terminal.
cd ~/uploads
pwd
rz
El directorio de destino debe existir previamente y ser escribible por tu cuenta SSH. Los archivos se envían al receptor que se ejecuta en ese directorio. Si ya existe remotamente un archivo con el mismo nombre, las opciones del receptor remoto determinan cómo se gestiona ese conflicto.
NeoServer prepara copias locales de los archivos de subida seleccionados y los transmite por fragmentos. Las copias temporales de subida se eliminan cuando la transferencia se completa, se cancela o se desconecta.
Descarga archivos con sz
sz hace que la máquina remota envíe archivos a NeoServer. Pasa una o más rutas de archivos remotos:
sz server.log
Para varios archivos, lístalos juntos. Entrecomilla las rutas que contengan espacios:
sz server.log report.json "build output.txt"
NeoServer presenta cada archivo entrante para su confirmación. Elige Receive File para aceptarlo o Skip File para dejarlo fuera del lote. Los archivos recibidos aparecen en la sección Received Files del panel; usa Save to Files para exportar los archivos completados a la ubicación que elijas.
En iOS, las descargas completadas también están disponibles en la carpeta ZMODEM de NeoServer en la app Archivos. Cada archivo recibido se guarda en su propio directorio, de modo que las descargas separadas no se sobrescriben entre sí en el almacenamiento local.
Comprobaciones CRC y archivos incompletos
ZMODEM añade comprobaciones de integridad a sus tramas de transferencia y bloques de datos. Para una explicación a nivel de protocolo, consulta la documentación de ZMODEM de Tera Term.
NeoServer acepta tramas entrantes Hex, Binary16 y Binary32, con verificación CRC16 o CRC32 según corresponda. Las subidas usan CRC16. Un error de suma de comprobación puede provocar un reintento o una retransmisión desde un desplazamiento concreto durante la sesión de transferencia actual.
Las descargas se escriben en un archivo temporal .partial. NeoServer solo mueve la descarga a su nombre de archivo definitivo cuando se superan las comprobaciones de la transferencia, incluida la longitud esperada cuando el emisor la facilita. Las transferencias canceladas, fallidas o desconectadas eliminan los archivos de descarga inacabados; los archivos ya completados siguen disponibles.
El CRC detecta corrupción en la transferencia; no establece quién creó un archivo. Si necesitas una comprobación independiente de extremo a extremo, compara un hash criptográfico del archivo de origen y del recibido con herramientas disponibles en ambas máquinas.
Cancelar, reintentar y límites de transferencia
Durante una transferencia, NeoServer bloquea la entrada habitual del teclado del terminal para evitar mezclar pulsaciones con los datos del protocolo. Usa Cancel en el panel ZMODEM para detener la transferencia.
Ten en cuenta estos límites:
- Solo archivos. La transferencia de directorios no es compatible. Comprime primero el directorio y envía después el comprimido como archivo.
- Tamaño de cada archivo: como máximo 4,294,967,295 bytes, es decir, 4 GiB menos un byte.
- Los reintentos pertenecen a la sesión actual. NeoServer no guarda el estado de reanudación entre conexiones interrumpidas. Reconecta e inicia una nueva transferencia si se pierde la conexión.
- Usa SSH. Esta integración no funciona a través de la ruta de terminal de Mosh ni de un transporte de 7 bits.
Si rz o sz no abre el panel de transferencia
Primero confirma que el comando existe en la máquina remota y que estás usando la edición de terminal de NeoServer compatible. Después prueba el mismo comando en un shell SSH directo, fuera de cualquier multiplexor de terminal.
Para las subidas, comprueba el directorio de destino remoto y los permisos de la cuenta. Para las descargas, comprueba la ruta de origen y el permiso de lectura. Si una transferencia empieza pero no puede terminar, usa el mensaje de error del panel y reinténtala después de revisar la conexión, el tamaño del archivo y el espacio de almacenamiento local.
ZMODEM resulta útil cuando quieres mover archivos desde el directorio en el que ya estás trabajando. Las herramientas SFTP de NeoServer siguen siendo útiles para explorar carpetas remotas y gestionar archivos de forma visual. Para la conexión SSH inicial, consulta la guía de inicio rápido de NeoServer.
¿Listo para probarlo?
NeoServer · SSH, Mosh, Docker & SFTP client for iPhone, iPad and Mac
Gratis en el App Store