AfuseKt 通过 SMB 访问 NAS 网络共享文件夹
SMB 是什么
SMB（Server Message Block）是微软开发的网络文件共享协议，Windows 局域网共享、NAS 文件共享都用这个协议。如果你家里有 NAS 或 Windows 共享文件夹，通过 WiFi 让手机 / 盒子访问 NAS 上的视频文件是最直接的方式。
添加 SMB 资源库
- 侧栏 → 资源库 → 添加资源库 → SMB
- AfuseKt 会自动扫描局域网内的 SMB 共享，列出可连接的主机
- 也可以手动填写：
- 主机 IP（如
192.168.1.100）或 NAS 主机名 - 用户名 / 密码（NAS 或 Windows 的登录凭证）
- 共享路径（如
\\NAS-IP\Videos）
- 验证成功后选择要挂载的目录 → 扫描 → 刮削
SMB 播放核心选择
注意：官方旧版说明 SMB 资源"只能用 VLC 播放"。v3.x 更新后三大播放核心都能播放 SMB 资源，但实测表现：
| 核心 | SMB 支持度 | 备注 |
|---|---|---|
| VLC | ⭐⭐⭐⭐⭐ | 最稳，格式兼容性最好，官方推荐 |
| MPV | ⭐⭐⭐⭐ | v3.x 支持，部分老 NAS 可能有兼容问题 |
| EXO | ⭐⭐⭐ | v3.x 支持，简单文件没问题 |
建议 SMB 资源优先用 VLC 核心播放，遇到格式不兼容或字幕问题时再切 MPV。
NAS SMB 设置要点
确保 NAS 侧 SMB 设置正确，否则 AfuseKt 扫不到或连不上：
| NAS 类型 | 设置路径 | 关键项 |
|---|---|---|
| 群晖 | 控制面板 → 文件服务 → SMB | 启用 SMB 服务；SMB 版本建议 2.0 或 3.0（1.0 已不安全） |
| 威联通 | 控制台 → 网络与虚拟交换机 → 服务 → 网络文件服务 → SMB | 启用；创建共享文件夹并设置读写权限 |
| 极空间 | 极空间 App → 存储 → 共享文件夹 → SMB | 开启 SMB 访问 |
| Windows | 设置 → 网络和 Internet → 高级网络设置 → 高级共享设置 | 启用网络发现 + 文件和打印机共享 |
SMB vs 其他协议
| 对比 | SMB | WebDAV | Emby 直连 |
|---|---|---|---|
| 范围 | 仅局域网 | 公网+局域网 | 局域网+公网（需内网穿透） |
| 复杂度 | 低（直接共享） | 中（需开 WebDAV 服务） | 高（需搭 Emby Server） |
| 元数据 | 无（文件名依赖刮削） | 无（同 SMB） | Emby Server 提供完整元数据 |
| 适合 | 直接访问 NAS 原始文件 | 需要远程访问 NAS | 希望用 Emby Server 的元数据管理 |
如果你的 NAS 已经在跑 Emby / Jellyfin Server，建议直接用 Emby 直连模式，元数据更丰富。SMB 适合不想搭媒体服务器、只想直接读文件的场景。
常见问题
| 问题 | 解决 |
|---|---|
| 扫描不到任何 SMB 主机 | 确认手机和 NAS 在同一 WiFi；关闭 VPN；NAS SMB 服务已开启 |
| 连接时提示"用户名或密码错误" | 确认 NAS / Windows 的登录账号密码；Windows 注意区分本地账号和微软账号 |
| 播放卡顿 | 切换 VLC 核心；确认 NAS 和手机都在 5GHz WiFi |
| 能看到目录但打不开文件 | 共享文件夹权限设置为只读或读写；NAS 防火墙未拦截 |
| Windows 10/11 SMB 1.0 相关报错 | Windows 默认已禁用 SMB 1.0，改用 SMB 2.0+ 连接；不要强制开启 1.0（有安全风险） |