Skip to content

ZMODEM-Dateiübertragung auf iOS und macOS: rz-Uploads, sz-Downloads und CRC in NeoServer

Übertragen Sie Dateien im SSH-Terminal von NeoServer mit rz und sz. Erfahren Sie mehr über den App-Umfang auf iOS und macOS, Upload- und Download-Schritte, CRC-Prüfungen und Übertragungslimits.

4 Min. LesezeitNeoServer

Sie befinden sich bereits in einem entfernten Verzeichnis und müssen eine Konfigurationsdatei hochladen oder ein Protokoll auf Ihr Gerät holen? NeoServers native ZMODEM-Implementierung ermöglicht Dateiübertragungen direkt im SSH-Terminal: Führen Sie rz für einen Upload aus oder sz für einen Download. Ein Übertragungspanel übernimmt Dateiauswahl, Fortschritt, Empfangsbestätigung und Abbruch.

Unterstützung auf iOS und macOS

Der unten beschriebene Ablauf nutzt das iOS-Terminal von NeoServer, einschließlich der iOS-basierten App auf macOS. Das separate native macOS-Terminal verfügt in der aktuellen Implementierung noch nicht über diese ZMODEM-Integration. Prüfen Sie auf einem Mac vor dem Ausprobieren der Befehle, welche Edition Sie verwenden.

Natives ZMODEM bedeutet hier, dass das Übertragungsprotokoll direkt in Swift implementiert ist, einschließlich Framing, CRC-Prüfung und Neuübertragung. Eine Browser-Erweiterung oder eine JavaScript-Übertragungsbrücke ist nicht erforderlich.

Den entfernten Server vorbereiten

Verwenden Sie eine SSH-Terminalverbindung und stellen Sie sicher, dass der entfernte Rechner rz und sz bereitstellt. Das lrzsz-Projekt liefert Kommandozeilen-Implementierungen der Übertragungsprotokolle. Prüfen Sie die Befehle in Ihrer Remote-Shell:

command -v rz
command -v sz

Fehlt einer der beiden Befehle, installieren Sie das lrzsz-Paket Ihrer Server-Distribution oder bitten Sie den Server-Administrator, es bereitzustellen. NeoServer übernimmt die Client-Seite; der entfernte Rechner benötigt weiterhin den passenden Sender oder Empfänger.

Beginnen Sie mit einer direkten SSH-Shell. Mosh-Verbindungen übertragen nicht den rohen Terminal-Bytestrom, den diese Integration benötigt. Wenn Sie tmux, screen oder zellij verwenden, muss diese Zwischenschicht den ZMODEM-Datenverkehr ebenfalls korrekt durchleiten.

Dateien mit rz hochladen

rz bedeutet, dass der entfernte Rechner Dateien empfängt. Aus Sicht Ihres Geräts handelt es sich um einen Upload.

  1. Wechseln Sie im Remote-Terminal in das Zielverzeichnis und prüfen Sie es mit pwd.
  2. Führen Sie rz aus.
  3. NeoServer öffnet sein ZMODEM-Panel. Wählen Sie Choose Files und markieren Sie eine oder mehrere lokale Dateien.
  4. Verfolgen Sie den Fortschritt und warten Sie auf den Abschluss, bevor Sie zur normalen Terminal-Arbeit zurückkehren.
cd ~/uploads
pwd
rz

Das Zielverzeichnis muss bereits existieren und für Ihr SSH-Konto beschreibbar sein. Die Dateien werden an den Empfänger gesendet, der in diesem Verzeichnis läuft. Existiert remote bereits eine Datei mit demselben Namen, bestimmen die Optionen des Remote-Empfängers, wie dieser Konflikt behandelt wird.

NeoServer bereitet lokale Kopien der ausgewählten Upload-Dateien vor und überträgt sie blockweise. Temporäre Upload-Kopien werden bereinigt, wenn die Übertragung abgeschlossen, abgebrochen oder getrennt wird.

Dateien mit sz herunterladen

sz bewirkt, dass der entfernte Rechner Dateien an NeoServer sendet. Übergeben Sie einen oder mehrere entfernte Dateipfade:

sz server.log

Bei mehreren Dateien geben Sie diese gemeinsam an. Setzen Sie Pfade mit Leerzeichen in Anführungszeichen:

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

NeoServer zeigt jede eingehende Datei zur Bestätigung an. Wählen Sie Receive File, um sie zu akzeptieren, oder Skip File, um sie aus der Übertragung auszuschließen. Empfangene Dateien erscheinen im Abschnitt Received Files des Panels; nutzen Sie Save to Files, um die abgeschlossenen Dateien an den gewünschten Ort zu exportieren.

Auf iOS sind abgeschlossene Downloads zusätzlich im ZMODEM-Ordner von NeoServer in der Dateien-App verfügbar. Jede empfangene Datei wird in einem eigenen Verzeichnis gespeichert, sodass sich separate Downloads im lokalen Speicher nicht gegenseitig überschreiben.

CRC-Prüfungen und unvollständige Dateien

ZMODEM fügt seinen Übertragungsframes und Datenblöcken Integritätsprüfungen hinzu. Eine Erklärung auf Protokollebene finden Sie in der ZMODEM-Dokumentation von Tera Term.

NeoServer akzeptiert eingehende Hex-, Binary16- und Binary32-Frames mit CRC16- oder CRC32-Prüfung, wie jeweils passend. Uploads verwenden CRC16. Ein Prüfsummenfehler kann während der aktuellen Übertragungssitzung eine Wiederholung oder eine Neuübertragung ab einem Versatz auslösen.

Downloads werden in eine temporäre .partial-Datei geschrieben. NeoServer verschiebt den Download erst in seinen endgültigen Dateinamen, nachdem die Übertragungsprüfungen bestanden sind – einschließlich der erwarteten Länge, sofern der Sender sie angibt. Abgebrochene, fehlgeschlagene oder getrennte Übertragungen entfernen unvollständige Download-Dateien; bereits abgeschlossene Dateien bleiben verfügbar.

CRC erkennt Übertragungsfehler; es legt nicht fest, wer eine Datei erstellt hat. Wenn Sie eine unabhängige Ende-zu-Ende-Prüfung benötigen, vergleichen Sie einen kryptografischen Hash der Quell- und der empfangenen Datei mit Werkzeugen, die auf beiden Rechnern verfügbar sind.

Abbrechen, Wiederholen und Übertragungslimits

Während einer Übertragung sperrt NeoServer die normale Tastatureingabe im Terminal, um zu verhindern, dass Tastenanschläge mit Protokolldaten vermischt werden. Nutzen Sie Cancel im ZMODEM-Panel, um die Übertragung zu stoppen.

Beachten Sie diese Grenzen:

  • Nur Dateien. Verzeichnisübertragungen werden nicht unterstützt. Packen Sie ein Verzeichnis zuerst ein und senden Sie dann das Archiv als Datei.
  • Größe pro Datei: höchstens 4.294.967.295 Bytes, also 4 GiB minus ein Byte.
  • Wiederholungen gelten nur für die aktuelle Sitzung. NeoServer speichert keinen Fortsetzungszustand über getrennte Verbindungen hinweg. Verbinden Sie sich neu und starten Sie eine neue Übertragung, falls die Verbindung verloren geht.
  • Verwenden Sie SSH. Diese Integration funktioniert nicht über den Mosh-Terminalpfad oder einen 7-Bit-Transport.

Wenn rz oder sz das Übertragungspanel nicht öffnet

Bestätigen Sie zuerst, dass der Befehl auf dem entfernten Rechner existiert und dass Sie die unterstützte NeoServer-Terminal-Edition verwenden. Versuchen Sie dann, denselben Befehl in einer direkten SSH-Shell außerhalb jedes Terminal-Multiplexers auszuführen.

Prüfen Sie bei Uploads das entfernte Zielverzeichnis und die Kontoberechtigungen. Bei Downloads prüfen Sie den Quellpfad und die Leseberechtigung. Beginnt eine Übertragung, kann aber nicht abgeschlossen werden, nutzen Sie die Fehlermeldung des Panels und versuchen Sie es erneut, nachdem Sie Verbindung, Dateigröße und lokalen Speicherplatz geprüft haben.

ZMODEM ist nützlich, wenn Sie Dateien aus dem Verzeichnis verschieben möchten, in dem Sie bereits arbeiten. NeoServers SFTP-Werkzeuge bleiben nützlich, um entfernte Ordner zu durchsuchen und Dateien visuell zu verwalten. Für die anfängliche SSH-Verbindung siehe NeoServer-Kurzanleitung.

NeoServer

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

App Store

Bereit zum Ausprobieren?

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

Kostenlos im App Store