快捷導(dǎo)航

Python使用pysmb庫訪問Windows共享文件夾的詳細教程

更新時間：2024年12月30日 08:55:57 作者：蠟筆小新星

本教程旨在幫助您使用pysmb庫,通過SMB（Server Message Block）協(xié)議,輕松連接到Windows共享文件夾,并列舉其中的文件與文件夾,此外,我們還將簡要介紹如何下載和上傳文件,以及如何處理可能遇到的連接錯誤,需要的朋友可以參考下

前置條件
步驟一：導(dǎo)入必要的模塊
步驟二：配置連接參數(shù)
步驟三：實例化SMB連接對象并嘗試連接
步驟四：列出共享文件夾中的文件與文件夾
步驟五：下載與上傳文件（可選）
步驟六：處理連接錯誤
錯誤排查指南
結(jié)論

前置條件

安裝pysmb庫：
請確保您的Python環(huán)境中已安裝pysmb庫。若未安裝，可通過pip進行安裝：

pip install pysmb

準備服務(wù)器信息：
您需要知道共享文件夾所在服務(wù)器的IP地址、NetBIOS名稱（或DNS名稱）、共享文件夾名稱以及您的登錄憑據(jù)（用戶名和密碼）。

步驟一：導(dǎo)入必要的模塊

首先，導(dǎo)入SMBConnection類和NotConnectedError異常。

from smb.SMBConnection import SMBConnection
from smb.base import NotConnectedError

步驟二：配置連接參數(shù)

根據(jù)服務(wù)器的實際情況，設(shè)置連接所需的各項參數(shù)。

# 服務(wù)器及共享文件夾信息
server_ip = 'file01.xxtech.com'  # 服務(wù)器IP地址
username = 'your_username'       # 替換為您的用戶名
password = 'your_password'       # 替換為您的密碼
client_machine_name = 'your_client_machine_name'  # 替換為您的客戶端機器名稱
server_name = 'FILE01'  # 替換為服務(wù)器的NetBIOS名稱或DNS名稱
share_name = 'File'     # 共享文件夾名稱

步驟三：實例化SMB連接對象并嘗試連接

使用SMBConnection類創(chuàng)建一個SMB連接對象，并嘗試與服務(wù)器建立連接。

# 創(chuàng)建SMB連接對象
conn = SMBConnection(username, password, client_machine_name, server_name, use_ntlm_v2=True)

try:
    # 連接到服務(wù)器
    conn.connect(server_ip, 445)  # 嘗試通過445端口連接
    print("已成功連接到服務(wù)器。")

步驟四：列出共享文件夾中的文件與文件夾

連接成功后，即可列出共享文件夾中的文件與文件夾。

    # 列出共享文件夾中的文件與文件夾
    files_and_dirs = conn.listPath(share_name, '/')
    for file_or_dir in files_and_dirs:
        print(file_or_dir.filename)

步驟五：下載與上傳文件（可選）

除了瀏覽文件與文件夾外，您還可以下載和上傳文件。以下是相關(guān)示例代碼：

    # 下載文件的函數(shù)
    def download_file(remote_path, local_path):
        with open(local_path, 'wb') as f:
            conn.retrieveFile(share_name, remote_path, f)
    
    # 上傳文件的函數(shù)
    def upload_file(local_path, remote_path):
        with open(local_path, 'rb') as f:
            conn.storeFile(share_name, remote_path, f)

步驟六：處理連接錯誤

在連接過程中，可能會遇到各種錯誤。以下是處理這些錯誤的建議：

ConnectionRefusedError：這通常意味著服務(wù)器拒絕了連接請求。請檢查服務(wù)器是否正在運行、IP地址和端口是否正確、防火墻設(shè)置是否允許連接、SMB服務(wù)是否啟動以及網(wǎng)絡(luò)是否暢通。
NotConnectedError：當(dāng)嘗試在未建立連接的情況下執(zhí)行操作時，會拋出此異常。
其他異常：對于其他可能的異常，請打印錯誤消息并進行相應(yīng)的調(diào)查。

except NotConnectedError:
    print("無法連接到服務(wù)器。請檢查服務(wù)器地址、端口和憑據(jù)。")
except Exception as e:
    print(f"發(fā)生錯誤：{e}")
finally:
    # 斷開連接（如果已連接）
    try:
        conn.close()
    except NotConnectedError:
        # 如果連接從未成功建立，則忽略關(guān)閉錯誤
        pass