リモートのディレクトリにいる状態で、設定ファイルをアップロードしたり、ログを手元のデバイスに持ち帰りたくなることはありませんか?NeoServerのネイティブZMODEM実装なら、SSHターミナルの中でファイルを転送できます。rzでアップロード、szでダウンロードです。転送パネルがファイル選択、進行状況、受信確認、キャンセルをまとめて処理します。
iOSとmacOSの対応状況
以下の手順は、macOS上のiOSベースアプリを含む、NeoServerのiOSターミナルを前提としています。独立したネイティブのmacOSターミナルには、現行実装ではまだこのZMODEM統合が入っていません。Macでコマンドを試す前に、自分が使っているエディションを確認してください。
ここでいうネイティブZMODEMとは、フレーミング、CRC検証、再送を含む転送プロトコルがSwiftで直接実装されているという意味です。ブラウザ拡張もJavaScriptの転送ブリッジも不要です。
リモートサーバーの準備
SSHターミナル接続を使い、リモートマシンにrzとszが揃っていることを確認してください。lrzszプロジェクトが転送プロトコルのコマンドライン実装を提供しています。リモートシェルでコマンドを確認しましょう:
command -v rz
command -v sz
どちらかのコマンドがなければ、サーバーディストリビューションのlrzszパッケージをインストールするか、サーバー管理者に用意を依頼してください。NeoServerはクライアント側を担いますが、リモートマシン側にも対応する送信側・受信側が必要です。
まずは直接のSSHシェルで始めてください。Mosh接続では、この統合が必要な生のターミナルバイトストリームが伝わりません。tmux、screen、zellijを使っている場合は、その中間層もZMODEMのトラフィックを正しく透過させる必要があります。
rzでファイルをアップロードする
rzはリモートマシンがファイルを受信するという意味です。自分のデバイスから見ればアップロードになります。
- リモートターミナルで転送先ディレクトリに移動し、
pwdで確認します。 rzを実行します。- NeoServerのZMODEMパネルが開きます。Choose Filesを選び、ローカルファイルを1つ以上指定します。
- 進行状況を見守り、完了を待ってから通常のターミナル作業に戻ります。
cd ~/uploads
pwd
rz
転送先ディレクトリは事前に存在し、SSHアカウントが書き込める状態でなければなりません。ファイルはそのディレクトリで動いている受信側に送られます。リモート側に同名のファイルが既にある場合の衝突の扱いは、リモートの受信側の設定次第です。
NeoServerは選択されたアップロードファイルのローカルコピーを用意し、チャンク単位でストリーミングします。一時的なアップロードコピーは、転送の完了・キャンセル・切断時にクリーンアップされます。
szでファイルをダウンロードする
szはリモートマシンからNeoServerへファイルを送らせるコマンドです。リモートのファイルパスを1つ以上渡します:
sz server.log
複数のファイルはまとめて列挙します。スペースを含むパスは引用符で囲んでください:
sz server.log report.json "build output.txt"
NeoServerは受信するファイルごとに確認を求めます。Receive Fileで受け入れ、Skip Fileでそのバッチから除外します。受信したファイルはパネルのReceived Filesセクションに現れ、Save to Filesで完成したファイルを任意の場所に書き出せます。
iOSでは、完了したダウンロードは「ファイル」AppのNeoServerのZMODEMフォルダでも利用できます。受信ファイルごとに専用のディレクトリに保存されるため、別々のダウンロードがローカルストレージ上で上書きし合うことはありません。
CRCチェックと未完了ファイル
ZMODEMは転送フレームとデータブロックに整合性チェックを組み込んでいます。プロトコルレベルの解説はTera TermのZMODEMドキュメントを参照してください。
NeoServerは受信フレームとしてHex、Binary16、Binary32を受け付け、それぞれに応じてCRC16またはCRC32で検証します。アップロードにはCRC16を使います。チェックサムエラーが発生すると、現在の転送セッション内で再試行やオフセットからの再送が行われることがあります。
ダウンロードは一時的な.partialファイルに書き込まれます。NeoServerは、送信側が期待長を通知している場合はそれを含め、転送チェックが通って初めてダウンロードを最終的なファイル名に移動します。キャンセル、失敗、切断された転送の未完了ファイルは削除され、完了済みのファイルはそのまま利用できます。
**CRCは転送中の破損を検出するものであり、ファイルの作成者を保証するものではありません。**独立したエンドツーエンドの検証が必要なら、両方のマシンで使えるツールで送信元と受信ファイルの暗号学的ハッシュを比較してください。
キャンセル、再試行、転送の制限
転送中、NeoServerはキーストロークがプロトコルデータと混ざるのを防ぐため、通常のターミナルへのキーボード入力をブロックします。転送を止めるにはZMODEMパネルのCancelを使ってください。
次の制限に注意してください:
- **ファイルのみ対応。**ディレクトリの転送には対応していません。ディレクトリは先にアーカイブし、そのアーカイブを1つのファイルとして送ってください。
- **1ファイルのサイズ上限:**最大4,294,967,295バイト、つまり4 GiBマイナス1バイトです。
- **再試行は現在のセッション内のみ。**NeoServerは切断をまたいでレジューム状態を保存しません。接続が切れたら、再接続して新しい転送を開始してください。
- **SSHを使うこと。**この統合はMoshのターミナル経路や7ビットトランスポートでは動作しません。
rzやszで転送パネルが開かないとき
まず、リモートマシンにコマンドが存在すること、対応するNeoServerターミナルのエディションを使っていることを確認してください。次に、ターミナルマルチプレクサの外で、直接のSSHシェルで同じコマンドを試してみます。
アップロードでは、リモートの転送先ディレクトリとアカウントの権限を確認してください。ダウンロードでは、ソースパスと読み取り権限を確認してください。転送が始まっても完了しない場合は、パネルのエラーメッセージを確認し、接続、ファイルサイズ、ローカルの空き容量をチェックしてから再試行してください。
今いるディレクトリからそのままファイルを移動したい場面ではZMODEMが便利です。リモートフォルダの閲覧やファイルの視覚的な管理には、NeoServerのSFTPツールが引き続き役立ちます。SSH接続の初期設定については、NeoServerクイックスタートを参照してください。
試してみませんか?
NeoServer · SSH, Mosh, Docker & SFTP client for iPhone, iPad and Mac
App Store で無料