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

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

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

 

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

 

 

SFTPとは

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

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

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

paramikoライブラリについて

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

[PR] 未経験からWebエンジニアを目指す方法とは

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では、初心者でも、Pythonを使った人工知能（AI）や機械学習の基礎を習得できる、オンラインブートキャンプを開催しています。

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