ezSMB

手机与电脑，轻松传文件。

官网 · 下载 APK · 连接指南 · Privacy

Android 原生局域网 SMB 文件工具。手机直接访问 Windows 共享文件夹、Linux Samba 和 NAS。无需电脑端伴侣程序，无云账户、广告或统计 SDK。

界面截图 · 功能 · 开始使用 · 源码构建 · English

界面截图

文件浏览	传输任务	深色模式

能力

0.3.8 开发版功能，正式安装包见 Releases。

• 自动发现局域网电脑和 NAS，支持 Windows WS-Discovery、mDNS 与手动连接。
• 常用设备去重，只显示可连接的设备；加密记住账号密码，换网络后识别同一台电脑。
• SMB2/SMB3 连接，真实枚举共享文件夹；无法枚举时可手动输入共享路径。
• 目录收藏，从首页直达；子目录逐级返回，到收藏入口直接返回首页。
• 点击文件优先预览，点击下载图标才下载；支持图片、视频、音频、文本及系统查看器。
• 极简内嵌播放器，可拖动进度；视频按需读取，已读取片段留在本地复用。
• 缩略图保留缓存，文件变化时静默更新；首页显示已缓存文件及大小，可查看、删除或补全保存。
• 下载到 Download/ezSMB，系统选择器多文件上传；真实进度、队列、取消、重试与同名处理。
• Material You 动态配色、深色模式；齿轮设置，中文、English 与跟随系统。

开始使用

1. 电脑开启 SMB 共享，为账户授予文件夹权限；手机与电脑处于可互访的局域网。
2. 在 ezSMB 选择设备，使用电脑账户密码连接。
3. 打开共享文件夹，点文件预览，点下载图标保存；点「上传」选择手机文件。
4. 下载完成后可打开文件或所在目录。收藏目录后可从首页直达。

请勿启用 SMB1、关闭系统签名或关闭整个防火墙。更多排错见 Windows / NAS 设置指南。

构建

需要 JDK 17+（验证环境使用 21）、Android SDK Platform 36 / Build Tools 35.0.0。Gradle Wrapper 已包含。将 SDK 路径写入未提交的 local.properties，或设置 ANDROID_HOME。

Linux

安装 JDK 与 Android SDK 命令行工具，接受 SDK licenses 后安装 platforms;android-36、build-tools;35.0.0、platform-tools：

chmod +x gradlew
./gradlew testDebugUnitTest lintDebug assembleDebug
adb install -r app/build/outputs/apk/debug/app-debug.apk

Windows

.\gradlew.bat testDebugUnitTest lintDebug assembleDebug
# 可选：处理 Windows JDK Unix-domain 临时目录兼容性
.\tools\build.ps1

既有版本已通过本地 Windows 与 GitHub Ubuntu CI 的构建、单元测试和 lint；0.3.8 本轮仅编译，播放实测待完成。EndeavourOS 本机尚未实测。脚本不会修改系统代理、防火墙或共享设置。

English

ezSMB is an MIT-licensed native Android SMB2/SMB3 client for local network file browsing and transfer. Discover computers, browse shares, bookmark folders, preview files and stream videos with seek controls. Manage cached files, save to Android Downloads and upload using the system document picker. Built with Kotlin, Jetpack Compose and Material You, with Chinese and English support. No ads, analytics or developer cloud file relay.

This is a public preview, not a universal NAS compatibility guarantee. See the verification report for tested environments and limitations. Bug reports and reproducible server/device compatibility results are welcome.