[TOC] SMB 服務操作 Ⅰ SMB簡介 SMB(全稱是Server Message Block)是一個協議名，它能被用於Web連接和客戶端與伺服器之間的信息溝通。SMB協議作為一種區域網文件共用傳輸協議，常被用來作為共用文件安全傳輸研究的平臺。 Windows操作系統都包括了客戶機和服 ...

SMB 服務操作

SMB 服務操作

Ⅰ SMB簡介

SMB(全稱是Server Message Block)是一個協議名，它能被用於Web連接和客戶端與伺服器之間的信息溝通。SMB協議作為一種區域網文件共用傳輸協議，常被用來作為共用文件安全傳輸研究的平臺。
Windows操作系統都包括了客戶機和伺服器 SMB協議支持。Microsoft 為 Internet 提供了SMB的開源版本，即通用Internet文件系統CIFS。與現有 Internet 應用程式如文件傳輸協議FTP相比， CIFS 靈活性更大。對於UNIX系統，可使用一種稱為Samba的共用軟體。

Ⅱ SMB配置

2.1 Windows SMB

2.1.1 配置服務

在本地機上以Windows10舉例：在控制面板 -->程式-->程式和功能-->啟用或關閉Windows功能-->SMB 1.0/cifs file sharing support勾選SMB 1.0/CIFS Client和SMB 1.0/CIFS Server

01_01

2.1.2 驗證服務

開啟之後來驗證一下SMB是否正確開啟：在DOS命令視窗用PowerShell命令進入程式輸入Get-SmbServerConfiguration | Select EnableSMB1Protocol, EnableSMB2Protocol查看服務狀態，如圖所示：

01_02

2.1.3 共用文件

在D盤新建一個測試文件D:\Test\SmbTest\GoalTest，右鍵菜單-->授予訪問許可權-->特定用戶選擇一個用戶進行授權，如圖所示：

授權給用戶之後會提示你的文件夾已共用，在DOS視窗輸入彈窗提示的共用連接\\DESKTOP-D5DVINV\Test即可進入共用文件夾，右擊共用文件夾還可以設置訪問密碼，更改訪問用戶等等。

01_04

Ⅲ 添加SMB依賴

在pom.xml中添加SMB服務相關的依賴：

<!-- 引用SmbFile類的jar包  -->
<dependency>
       <groupId>jcifs</groupId>
       <artifactId>jcifs</artifactId>
       <version>1.3.17</version>
</dependency>

Ⅳ 路徑格式

在Java中SMB路徑請求格式有如下三種情況：

如果是無需密碼的共用，格式類似：smb://ip/sharefolder(例如:smb://192.168.0.77/test)
如果需要用戶名和密碼，格式類似：smb://username:password@ip/sharefolder(例:smb://chb:[email protected]/test)
如果用戶名密碼和功能變數名稱，格式類似：smb:功能變數名稱;用戶名:密碼@目的IP/文件夾/文件名.xxx(例:smb://orcl;wangjp:[email protected]/Test)

Ⅴ 操作共用

以上步驟之後，就完成了在Windows上建立了一個SMB文件伺服器和必要準備工作，接下來就是簡單的代碼環節，上傳和下載的邏輯也比較簡單，對SMB共用文件的操作其實就是處理SmbFile對象。

import jcifs.smb.SmbFile;
import jcifs.smb.SmbFileInputStream;
import jcifs.smb.SmbFileOutputStream;
import org.springframework.util.FileCopyUtils;
import java.io.*;
/**
 * @author: Create By WangJP
 * @description: SMB服務操作相關
 * @date: 2020/1/1
 */
public class Demo {

    private static final String SMB_SHARE_FOLDER = "smb://username:[email protected]/Test/";
    private static final String SHARE_FOLDER_PATH = "SmbTest\\GoalTest";
    private static final String FILE_NAME = "test.txt";
    private static final String LOCAL_DIR = "D:\\LocalTest";

    public static void main(String[] args) {
        downloadSmbFile(SMB_SHARE_FOLDER, SHARE_FOLDER_PATH, FILE_NAME, LOCAL_DIR);
        uploadFile(SMB_SHARE_FOLDER, SHARE_FOLDER_PATH, FILE_NAME, LOCAL_DIR);
    }

    /**
     * 從SMB共用文件夾下載文件到本地
     * @param remoteUrl       SMB請求路徑Url
     * @param shareFolderPath 共用文件夾中SMB目標文件存放的完整路徑
     * @param fileName        文件名
     * @param localDir        本地文件夾
     */
    public static void downloadSmbFile(String remoteUrl, String shareFolderPath, String fileName, String localDir) {
        InputStream in = null;
        OutputStream out = null;
        try {
            SmbFile smbfile = new SmbFile(remoteUrl + shareFolderPath + File.separator + fileName);
            File localFile = new File(localDir + File.separator + fileName);
            in = new BufferedInputStream(new SmbFileInputStream(smbfile));
            out = new BufferedOutputStream(new FileOutputStream(localFile));
            FileCopyUtils.copy(in, out);
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            closeStreanm(in, out);
        }
    }

    /**
     * 將本地文件夾中的文件上傳到SMB共用文件夾（與下載類似）
     * @param remoteUrl       SMB請求路徑Url
     * @param shareFolderPath 共用文件夾中SMB目標文件存放的完整路徑
     * @param fileName        文件名
     * @param localDir        本地文件夾
     */
    private static void uploadFile(String remoteUrl, String shareFolderPath, String fileName, String localDir) {
        InputStream in = null;
        OutputStream out = null;
        try {
            SmbFile smbfile = new SmbFile(remoteUrl + shareFolderPath + File.separator + fileName);
            File localFile = new File(localDir + File.separator + fileName);
            in = new BufferedInputStream(new FileInputStream(localFile));
            out = new BufferedOutputStream(new SmbFileOutputStream(smbfile));
            FileCopyUtils.copy(in, out);
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            closeStreanm(in, out);
        }
    }

    private static void closeStreanm(InputStream in, OutputStream out) {
        try {
            if (in != null) {
                in.close();
            }
            if (out != null) {
                out.close();
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

自己工作中有一個業務需求是要檢測SMB共用目錄中的某個文件是否存在，通過下載上傳的例子，學習到獲取 SmbFile 對象需要特定的的屬性（url canon等等）構建，處理方法上有很多和File對象類似，代碼示例如下：

 /**
     * 檢驗SMB共用文件是否存在
     * @param remoteUrl       SMB請求路徑Url
     * @param shareFolderPath 共用文件夾中SMB目標文件存放的完整路徑
     * @param fileName        文件名
     * @return true:存在 false:不存在
     */
    public static boolean checkSmbFile(String remoteUrl, String shareFolderPath, String fileName) {
        boolean result = false;
        try {
            SmbFile smbfile = new SmbFile(remoteUrl + shareFolderPath + File.separator + fileName);
            result = smbfile.exists();
        } catch (Exception e) {
            e.printStackTrace();
        }
        return result;
    }

Ⅵ 登錄驗證

SMB的登錄驗證主要是為解決賬號密碼中存在特殊字元的問題（比如轉義字元，鏈接里的特定字元），存在特殊字元的賬號密碼往往會報出下列異常：

Connected to the target VM, address: '127.0.0.1:54593', transport: 'socket'
jcifs.smb.SmbAuthException: Logon failure: unknown user name or bad password.

這時為了構建合法的SmbFile對象，我們就需要先進行登錄驗證，再去嘗試構建該對象：

private static String domainip = "192.168.170.13";
private static String username = "username";
private static String password = "password";
private static String remoteurl = "smb://192.168.170.13/share";
//進行賬號IP地址登錄驗證
NtlmPasswordAuthentication auth = new NtlmPasswordAuthentication(domainip, username, password);  
SmbFile smbfile = new SmbFile(remoteurl+"//"+folderpath,auth);

Java中SMB的相關應用