You need to enable JavaScript to run this app. 如何通过编程方式从本地网络驱动器下载文件,目标协议为SMBv1
优惠活动
大模型
产品
解决方案
定价
更多

如何通过编程方式从本地网络驱动器下载文件,目标协议为SMBv1

适配SMBv1协议的网络驱动器文件访问方案

直接使用映射盘符访问(完全贴合需求写法)

如果你的程序运行在已经完成Z盘SMB映射的Windows设备上,完全可以直接使用你提到的val file = File("/z/folder/")写法访问,不需要额外引入SMB协议处理库,系统已经完成了SMBv1的协议封装和权限校验,访问逻辑和本地磁盘完全一致。
Kotlin 示例代码:

import java.io.File

fun main() {
    // 两种路径写法都支持,JVM会自动适配系统格式
    val targetFolder = File("Z:\\folder\\")
    // val targetFolder = File("/z/folder/")
    
    if (targetFolder.exists() && targetFolder.isDirectory) {
        // 遍历、读写操作都和本地文件无差异
        targetFolder.listFiles()?.forEach { file ->
            println("找到文件:${file.name}")
        }
    }
}

注意事项:

  • 确保运行程序的用户身份拥有Z盘的SMB共享访问权限,若程序以系统服务形式运行,需要将服务的运行账户修改为有访问权限的域账户/本地账户,不要使用默认的SYSTEM账户,否则会出现路径不存在的报错。
  • 必须提前开启设备的SMBv1客户端功能:Windows系统可进入「控制面板-程序和功能-启用或关闭Windows功能」,勾选「SMB 1.0/CIFS 客户端」选项,重启设备后生效。

无盘符映射的直接SMBv1访问方案

如果你不想依赖系统提前映射盘符,可以引入SMB客户端库直接通过协议访问,Java/Kotlin生态推荐使用jcifs-ng的1.x版本(原生支持SMBv1,高版本已移除SMBv1支持),示例代码:

import jcifs.smb.NtlmPasswordAuthentication
import jcifs.smb.SmbFile
import java.io.FileOutputStream

fun main() {
    // 配置SMB访问凭证,无域名可填空字符串
    val auth = NtlmPasswordAuthentication("你的域名", "访问用户名", "访问密码")
    // 路径格式为 smb://<SMB主机地址>/<共享名>/<子路径>
    val smbFolder = SmbFile("smb://192.168.x.xxx/shared_name/folder/", auth)
    
    if (smbFolder.exists() && smbFolder.isDirectory) {
        smbFolder.listFiles()?.forEach { item ->
            println("找到文件:${item.name}")
            // 下载文件到本地示例
            if (!item.isDirectory) {
                item.inputStream.use { input ->
                    FileOutputStream("C:\\本地保存路径\\${item.name}").use { output ->
                        input.copyTo(output)
                    }
                }
            }
        }
    }
}

注意事项:

  • 不需要提前在系统映射盘符,只要网络连通、账户权限正确即可访问。
  • 只能使用jcifs-ng 1.x版本,2.x及以上版本不再支持SMBv1协议。

常见问题排查

  • 路径不存在报错:先检查SMBv1客户端是否开启,再确认运行程序的账户有共享目录访问权限,最后检查路径拼写是否正确。
  • 权限拒绝报错:检查SMB共享目录的共享权限、目录本地NTFS权限是否都给对应账户开放了读取权限。

内容的提问来源于stack exchange,提问作者dbuzin

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.08 12:48:00