Skip to content

Transfert de fichiers ZMODEM sur iOS et macOS : envoi avec rz, téléchargement avec sz et CRC dans NeoServer

Transférez des fichiers dans un terminal SSH NeoServer avec rz et sz. Découvrez la couverture des apps iOS et macOS, les étapes d'envoi et de téléchargement, les vérifications CRC et les limites de transfert.

5 min de lectureNeoServer

Vous êtes déjà dans un répertoire distant et devez envoyer un fichier de configuration ou rapporter un journal sur votre appareil ? L’implémentation ZMODEM native de NeoServer vous permet de transférer des fichiers dans le terminal SSH : exécutez rz pour envoyer, ou sz pour télécharger. Un panneau de transfert gère la sélection des fichiers, la progression, la confirmation de réception et l’annulation.

Prise en charge sur iOS et macOS

Le flux décrit ci-dessous utilise le terminal iOS de NeoServer, y compris l’app basée sur iOS fonctionnant sur macOS. Le terminal natif macOS distinct ne dispose pas encore de cette intégration ZMODEM dans l’implémentation actuelle. Sur un Mac, vérifiez quelle édition vous utilisez avant d’essayer les commandes.

Ici, ZMODEM natif signifie que le protocole de transfert est implémenté directement en Swift, y compris le cadrage, la vérification CRC et la retransmission. Aucune extension de navigateur ni passerelle de transfert en JavaScript n’est nécessaire.

Préparer le serveur distant

Utilisez une connexion terminal SSH et assurez-vous que la machine distante fournit rz et sz. Le projet lrzsz fournit des implémentations en ligne de commande des protocoles de transfert. Vérifiez les commandes dans votre shell distant :

command -v rz
command -v sz

Si l’une des commandes est manquante, installez le paquet lrzsz de la distribution de votre serveur ou demandez à l’administrateur du serveur de le fournir. NeoServer gère le côté client ; la machine distante doit toujours disposer de l’émetteur ou du récepteur correspondant.

Commencez avec un shell SSH direct. Les connexions Mosh ne transportent pas le flux d’octets brut du terminal requis par cette intégration. Si vous utilisez tmux, screen ou zellij, cette couche intermédiaire doit également laisser passer correctement le trafic ZMODEM.

Envoyer des fichiers avec rz

rz signifie que la machine distante reçoit les fichiers. Du point de vue de votre appareil, il s’agit d’un envoi.

  1. Dans le terminal distant, placez-vous dans le répertoire de destination et vérifiez-le avec pwd.
  2. Exécutez rz.
  3. NeoServer ouvre son panneau ZMODEM. Sélectionnez Choose Files et choisissez un ou plusieurs fichiers locaux.
  4. Suivez la progression et attendez la fin avant de reprendre un travail normal dans le terminal.
cd ~/uploads
pwd
rz

Le répertoire de destination doit déjà exister et être accessible en écriture par votre compte SSH. Les fichiers sont envoyés au récepteur qui s’exécute dans ce répertoire. Si un fichier portant le même nom existe déjà à distance, les options du récepteur distant déterminent comment ce conflit est géré.

NeoServer prépare des copies locales des fichiers sélectionnés pour l’envoi et les transmet par blocs. Les copies temporaires d’envoi sont nettoyées lorsque le transfert se termine, est annulé ou se déconnecte.

Télécharger des fichiers avec sz

sz fait en sorte que la machine distante envoie des fichiers à NeoServer. Indiquez un ou plusieurs chemins de fichiers distants :

sz server.log

Pour plusieurs fichiers, listez-les ensemble. Mettez entre guillemets les chemins contenant des espaces :

sz server.log report.json "build output.txt"

NeoServer présente chaque fichier entrant pour confirmation. Choisissez Receive File pour l’accepter, ou Skip File pour l’exclure du lot. Les fichiers reçus apparaissent dans la section Received Files du panneau ; utilisez Save to Files pour exporter les fichiers terminés vers l’emplacement de votre choix.

Sur iOS, les téléchargements terminés sont également disponibles dans le dossier ZMODEM de NeoServer dans l’app Fichiers. Chaque fichier reçu est stocké dans son propre répertoire, de sorte que des téléchargements distincts ne s’écrasent pas mutuellement dans le stockage local.

Vérifications CRC et fichiers incomplets

ZMODEM ajoute des contrôles d’intégrité à ses trames de transfert et à ses blocs de données. Pour une explication au niveau du protocole, consultez la documentation ZMODEM de Tera Term.

NeoServer accepte les trames entrantes Hex, Binary16 et Binary32, avec vérification CRC16 ou CRC32 selon le cas. Les envois utilisent CRC16. Une erreur de somme de contrôle peut déclencher une nouvelle tentative ou une retransmission depuis un décalage pendant la session de transfert en cours.

Les téléchargements sont écrits dans un fichier temporaire .partial. NeoServer ne déplace le téléchargement vers son nom de fichier final qu’une fois les vérifications de transfert réussies, y compris la longueur attendue lorsque l’émetteur la fournit. Les transferts annulés, échoués ou interrompus suppriment les fichiers de téléchargement inachevés ; les fichiers déjà terminés restent disponibles.

Le CRC détecte la corruption pendant le transfert ; il n’établit pas qui a créé un fichier. Si vous avez besoin d’une vérification de bout en bout indépendante, comparez un hachage cryptographique du fichier source et du fichier reçu à l’aide d’outils disponibles sur les deux machines.

Annuler, réessayer et limites de transfert

Pendant un transfert, NeoServer bloque la saisie clavier ordinaire du terminal pour éviter de mélanger les frappes avec les données du protocole. Utilisez Cancel dans le panneau ZMODEM pour arrêter le transfert.

Gardez ces limites à l’esprit :

  • Fichiers uniquement. Le transfert de répertoires n’est pas pris en charge. Archivez d’abord un répertoire, puis envoyez l’archive comme fichier.
  • Taille d’un seul fichier : au plus 4 294 967 295 octets, soit 4 GiB moins un octet.
  • Les nouvelles tentatives appartiennent à la session en cours. NeoServer ne conserve pas d’état de reprise entre les connexions interrompues. Reconnectez-vous et démarrez un nouveau transfert si la connexion est perdue.
  • Utilisez SSH. Cette intégration ne fonctionne ni via le chemin terminal Mosh ni via un transport 7 bits.

Si rz ou sz n’ouvre pas le panneau de transfert

Confirmez d’abord que la commande existe sur la machine distante et que vous utilisez l’édition de terminal NeoServer prise en charge. Essayez ensuite la même commande dans un shell SSH direct, en dehors de tout multiplexeur de terminal.

Pour les envois, vérifiez le répertoire de destination distant et les autorisations du compte. Pour les téléchargements, vérifiez le chemin source et l’autorisation de lecture. Si un transfert démarre mais ne peut pas se terminer, utilisez le message d’erreur du panneau et réessayez après avoir vérifié la connexion, la taille du fichier et l’espace de stockage local.

ZMODEM est utile lorsque vous souhaitez déplacer des fichiers depuis le répertoire dans lequel vous travaillez déjà. Les outils SFTP de NeoServer restent utiles pour parcourir les dossiers distants et gérer les fichiers visuellement. Pour la connexion SSH initiale, consultez le guide de démarrage rapide de NeoServer.

NeoServer

SSH, Mosh, Docker & SFTP client for iPhone, iPad and Mac

App Store

Prêt à l'essayer ?

NeoServer · SSH, Mosh, Docker & SFTP client for iPhone, iPad and Mac

Gratuit sur l'App Store