Python 標準庫 ftplib 提供完整 FTP 協議客戶端功能,本文示範連線登入、列出目錄、上傳下載檔案、錯誤處理與上下文管理器用法。
from ftplib import FTP
with FTP('ftp.example.com') as ftp:
ftp.login('username', 'password')
print('Welcome:', ftp.getwelcome())
# 列出目錄 (回呼函數接收每一行)
files = []
ftp.dir(files.append)
for line in files:
print(line)
with FTP('ftp.example.com') as ftp:
ftp.login('user', 'pass')
ftp.cwd('/upload/path')
with open('local_file.bin', 'rb') as f:
ftp.storbinary('STOR remote_file.bin', f)
print('Upload complete')
with FTP('ftp.example.com') as ftp:
ftp.login('user', 'pass')
with open('local_copy.bin', 'wb') as f:
ftp.retrbinary('RETR remote_file.bin', f.write)
print('Download complete')
# 上傳文字檔 (自動換行轉換)
with open('readme.txt', 'r') as f:
ftp.storlines('STOR readme.txt', f)
# 下載文字檔
with open('readme_copy.txt', 'w') as f:
ftp.retrlines('RETR readme.txt', f.write)
ftp.mkd('new_dir') # 建立目錄
ftp.rmd('old_dir') # 刪除空目錄
ftp.cwd('subdir') # 切換目錄
ftp.pwd() # 顯示當前目錄
ftp.size('file.txt') # 取得檔案大小 (位元組)
ftp.delete('file.txt') # 刪除檔案
ftp.rename('old', 'new')# 重命名
from ftplib import FTP, error_perm, error_temp
try:
with FTP('ftp.example.com', timeout=30) as ftp:
ftp.login('user', 'pass')
ftp.set_pasv(True) # 被動模式 (預設 True),穿越防火牆/NAT
# ...操作...
except error_perm as e:
print(f'永久錯誤 (5xx): {e}')
except error_temp as e:
print(f'暫時錯誤 (4xx): {e}')
except Exception as e:
print(f'連線失敗: {e}')
from ftplib import FTP_TLS
with FTP_TLS('ftps.example.com') as ftp:
ftp.login('user', 'pass')
ftp.prot_p() # 切換到加密資料連線
# 後續操作同 FTP
ftp.dir()
with 區塊確保連線正確關閉。storbinary/retrbinary,文字檔用 storlines/retrlines。set_pasv(True) 並使用 FTP_TLS 加密傳輸。