如何通过编程方式从本地网络驱动器下载文件,目标协议为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
相关产品推荐
相关产品推荐

