萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Python ftplib 實現 FTP 客戶端:連線、登入、列目錄與檔案傳輸

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')

文字模式傳輸 (ASCII)

# 上傳文字檔 (自動換行轉換)
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}')

進階:TLS/SSL 加密連線 (FTPS)

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 加密傳輸。
copyright © 萬盛學電腦網 all rights reserved