SFTPコンテナからファイルをダウンロードする

SFTPコンテナから  ファイルをダウンロードする  2025/6/18  golang.tokyo#39  ディップ株式会社  村松彩   

自己紹介  村松彩    🏢 ディップ株式会社  💻 新卒3年目バックエンドエンジニア  🔧 バイトル認証基盤・社内ツールの保守運用など 
📝 Go言語 

💡 SFTPサーバーをAPIサーバーと接続し  ローカルにファイルをダウンロードする 

アジェンダ  ➢ 開発するサービス  ➢ サービス構成  ➢ 実装内容  ➢ まとめ  ❏
イメージ、パッケージ  ❏ SFTP接続  ❏ ファイルダウンロード処理  ❏ ZIP化処理  ❏ 今回のユースケース

サーバ上にあるバナー等のサイト画像を  GUIで置き換える社内ツール  ➢ サーバにあるファイルをユーザのローカルにダウンロードしたい  ➢ SFTPでアップロード先サーバとコンテナを接続する  ➢ ローカル環境では、SFTPコンテナを立て、APIコンテナと接続し  ダウンロードする  開発するサービス 

サービス構成  （一部抜粋） 

💡 APIのレスポンスとして  ファイルを返却する 

処理の流れ  ➢ SSH接続の確立  ➢ SFTPクライアントを作成  ➢ ファイルダウンロード   ➢ 分岐処理 
◦ 1件のファイルを返却  ◦ 複数件のファイルをZIP化して返却 

使用するイメージ・パッケージ  ➢ Dockerイメージ  ◦ atmoz/sftp  ➢ GoのSFTPパッケージ  ◦ github.com/pkg/sftp  ➢
GoのSSH接続パッケージ  ◦ golang.org/x/crypto 

SFTP接続  ➢ SSHキーの準備  ➢ SFTPサーバーのホスト名、ポート番号、ユーザー名を指定  ➢ SSH接続の確立  ➢ SFTPクライアントの初期化  ➢
作成したクライアントを使用して、ファイル操作を実行  ➢ 処理が終了したら接続を閉じる 

SFTPクライアントの機能  ➢ ファイルダウンロード機能  ➢ ファイルのZIP化機能 

💡 ファイルダウンロード処理の実装 

ファイルダウンロード処理  ➢ リモートファイルの読み込み  ➢ バッファにコピーしインメモリで処理する 

💡 ZIP化処理の実装 

ZIP化処理    ➢ ZIP内のパスを構築  ➢ 元のディレクトリ構造を維持  ➢ ZIP内にファイルを作成  ➢ バッファに保存したファイルの内容をZIPにコピー 

ユースケース  1. 単一ファイルをダウンロードしてレスポンスとして返却する  2. 複数ファイルをダウンロードした後、  ZIP化してレスポンスとして返却する 

ユースケース1：単一ファイルの場合  1. SFTP経由でのファイルダウンロード  ➢ SFTPサーバからファイルを取得してバッファに保存  2. ダウンロードしたファイル情報をスライスに保存  3. ファイル名の取得  4.
MIMEタイプの判定  5. ヘッダー設定  6. ファイルをレスポンスボディにコピー 

ユースケース2：複数ファイルの場合  1. ダウンロードしたいファイルごとに処理  2. SFTP経由でのファイルダウンロード  3. ダウンロードしたファイル情報をスライスに保存  4. ZIPファイル名の生成  5.
ZIPファイルの作成  6. 各ファイルのZIP追加  7. ZIPファイルの送信 

処理の流れのまとめ  ➢ SSH接続の確立  ➢ SFTPクライアントを作成  ➢ ファイルダウンロード  ◦ リモートからファイルをダウンロードし、バッファに保存  ➢
分岐処理  ◦ 単一ファイルの場合：  MIMEタイプごとにヘッダーを設定し、バッファに保存したファイルをレスポンスに書き込み   ◦ 複数ファイルの場合：  レスポンスにZIPファイルを作成し、バッファに保存したファイルを書き込む   （このとき元ファイルのディレクトリ構造を維持する） 

まとめ  ポイント  ZIP化の方法  ➢ 一時ファイルを使用する方法と、インメモリで処理する方法  ユースケースごとにヘッダー設定を変更する必要がある  ➢ ヘッダーを設定する順序によっては、反映されない場合がある 

まとめ  メリット  効率的なファイル処理の実装  ➢ 大きなファイルでも対応可能な設計  ➢ インメモリでファイルのやり取りを行い、メモリ効率の良い実装  ユーザー体験の向上  ➢ 複数ファイルをZIP圧縮で一括ダウンロード可能 
➢ 元のディレクトリ構造を維持することで、ファイルの関連性を保持   

ご清聴ありがとうございました 

SFTPコンテナからファイルをダウンロードする

SFTPコンテナからファイルをダウンロードする

ディップ株式会社

More Decks by ディップ株式会社

Other Decks in Technology

Featured

Transcript