PythonでSFTPを利用してファイル転送する方法を現役エンジニアが解説【初心者向け】

初心者向けにPythonでSFTPを利用してファイル転送する方法について現役エンジニアが解説しています。SFTP(Secure FTP)とは、SSHプロトコルを用いてFTPを暗号化する方式です。FTPはファイルを送受信・転送する場合に用いられる方式です。paramikoモジュールを使ってSFTPを実装してみましょう。

TechAcademyマガジンはオンラインのプログラミングスクールTechAcademy [テックアカデミー]が運営。初心者向けに解説した記事が4,000以上あります。現役エンジニアの方はこちらをご覧ください。

PythonでSFTPを利用してファイル転送する方法について、TechAcademyのメンター(現役エンジニア)が実際のコードを使用して、初心者向けに解説します。

Pythonについてそもそもよく分からないという方は、Pythonとは何なのか解説した記事を読むとさらに理解が深まります。

 

なお本記事は、TechAcademyのオンラインブートキャンプ、Python講座の内容をもとに紹介しています。

 

田島悠介

今回は、Pythonに関する内容だね!

大石ゆかり

どういう内容でしょうか?

田島悠介

PythonでSFTPを利用してファイル転送する方法について詳しく説明していくね!

大石ゆかり

お願いします!

 

SFTPとは

SFTP(Secure FTP)は、SSHプロトコルを用いてFTPを暗号化する方式です。SFTPを使用すると、FTPよりも安全にファイルの送受信を行えます。

素となるFTP(File Transfer Protocol)はファイルのダウンロードやアップロードのプロトコルです。FTPは平文で通信するので、認証パスワードや通信内容を盗聴されたり、通信内容を改ざんされたりするおそれがあります。

なのでSFTPを使いセキュリティを強化し送受信を行うのがベターです。

paramikoライブラリについて

paramikoはPythonでSSHを操作するためのモジュールです。SSHクライアントやサーバ、またSSHを利用するSFTPクライアントやサーバを実装できます。

[PR] Pythonで挫折しない学習方法を動画で公開中

paramikoを利用したSFTP通信の方法

以下のように、SFTPセッションを確立します。これ以降、sftp_connectionオブジェクトに対して、各種SFTP操作を行います。

import paramiko
client = paramiko.SSHClient(<接続先情報>)
sftp_connection = client.open_sftp()

 

実際に書いてみよう

paramikoのインストール

pip install paramiko

 

ソースコード

import paramiko

# SFTP接続先の設定
HOST = '10.1.2.3'
PORT = 10022
SFTP_USER = 'sftp'
SFTP_PASSWORD = 'secret'

client = paramiko.SSHClient()
client.set_missing_host_key_policy(paramiko.AutoAddPolicy)
client.connect(HOST, port=PORT, username=SFTP_USER, password=SFTP_PASSWORD)
try:
    # SFTPセッション開始
    sftp_connection = client.open_sftp()

    # ファイル一覧の取得
    entries = sftp_connection.listdir()
    for e in entries:
        print(e)

    # ファイルのダウンロード
    sftp_connection.get('sample.txt', 'sample.txt')
finally:
    client.close()

 

実行結果

ディレクトリ内のファイル一覧が表示されました。また、カレントディレクトリにsample.txtファイルがダウンロードされました。

解説

  1. 既定では未知のホストにはSSH接続できません。これを迂回するため、AutoAddPolicyを指定します
  2. listdir()メソッドで、FTP接続先ディレクトリのファイル一覧を取得します
  3. get()メソッドで、1番目の引数に指定したファイルを、2番目の引数に指定したパスにダウンロードします

まとめ

この記事ではparamikoモジュールを使って、SFTPを操作する方法を紹介しました。

監修してくれたメンター

橋本紘希(はしもとひろき)

システムインテグレータ企業勤務のシステムエンジニア。

開発実績: Javaプログラムを用いた業務用Webアプリケーションや、基幹システム用バッチアプリケーションなどの設計構築試験。

 

大石ゆかり

内容分かりやすくて良かったです!

田島悠介

ゆかりちゃんも分からないことがあったら質問してね!

大石ゆかり

分かりました。ありがとうございます!

 

TechAcademyでは、初心者でも最短4週間で、Pythonを使った人工知能(AI)や機械学習の基礎を習得できる、オンラインブートキャンプを開催しています。

また、現役エンジニアから学べる無料体験も実施しているので、ぜひ参加してみてください。