AfuseKt SMB 协议连接常见问题排查
SMB 连接的五种典型问题
| 问题 | 表现 | 排查方向 |
|---|---|---|
| 扫不到 SMB 主机 | 资源库添加时列表为空 | 同网段？SMB 服务开了？ |
| 认证失败 | 输入账号密码后提示错误 | 账号密码对？SMB 权限对？ |
| 能看到主机但进不去 | 弹出认证窗口后卡住 | 共享文件夹权限没给 |
| 播放卡顿 | 能放但隔几秒卡一次 | WiFi 信号？SMB 版本？切 VLC |
| 能播放但字幕不加载 | 视频能播同目录字幕找不到 | SMB 路径格式问题 |
问题一：扫描不到任何 SMB 主机
可能原因
| 原因 | 检查 |
|---|---|
| 手机和 NAS 不在同一局域网 | 两者连的 WiFi 是否同一个（2.4G / 5G 可以不同但必须同网段） |
| NAS SMB 服务没开 | NAS 后台 → 文件服务 → SMB → 确认已启用 |
| Windows 防火墙拦截 | Windows 设置 → 更新和安全 → Windows 安全中心 → 防火墙 → 允许文件和打印机共享 |
| Android 禁止局域网发现 | 设置 → 应用和通知 → AfuseKt → 权限 → 位置权限（SMB 扫描需要） |
| 路由器访客网络隔离 | 路由器"AP 隔离" / "访客网络隔离"是否关闭 |
快速验证
用手机浏览器访问 \\NAS-IP（如 \\192.168.1.100）看能不能打开。如果不行就是 SMB 服务本身没起来，和 AfuseKt 无关。
问题二：用户名或密码错误
SMB 认证失败的表现：提示"认证失败"或一直弹窗要密码。
可能原因
| 原因 | 说明 |
|---|---|
| NAS 账号密码不对 | 确认是 NAS 后台登录的那个账号密码 |
| Windows 微软账号 vs 本地账号 | Windows 10/11 有两种账号，SMB 用的是本地账号的密码（微软在线账号密码可能不一样） |
| 共享文件夹没开读写权限 | NAS 后台 → 共享文件夹 → 权限设置 → 给你的账号至少"读"权限 |
| SMB 版本冲突 | 手机用 SMB 2.1 / 3.0，NAS 只开了 SMB 1.0 |
检查步骤
- Windows：控制面板 → 程序和功能 → 启用或关闭 Windows 功能 → SMB 1.0 / CIFS 文件共享支持（确保开了）
- 群晖：控制面板 → 文件服务 → SMB → 最高 SMB 协议版本设为 SMB 3.0 / 最低设为 SMB 2.0
- 确认密码：用这个账号密码在电脑上打开
\\NAS-IP看看能不能进，能进说明密码对
问题三：播放卡顿
SMB 播放卡顿通常是 WiFi 或 SMB 协议的问题：
WiFi 相关
| 原因 | 解决 |
|---|---|
| 手机在 2.4GHz WiFi，NAS 也在 2.4G | 两者都换到 5GHz（带宽大得多） |
| 距离路由器远，信号弱 | 靠近或加中继 |
| 太多设备占带宽 | 关闭其他下载设备 |
SMB 协议相关
| 原因 | 解决 |
|---|---|
| SMB 1.0 / 2.0 速度慢 | NAS 升到 SMB 3.0+ |
| 手机端缓存太小 | 设置 → 播放 → 缓存大小 → 加大到 2MB+ |
| 格式需要软解 | 换 VLC / 开启 FFmpeg |
为什么 SMB 不如 WebDAV 快
SMB 协议设计用于局域网文件共享，不是流媒体传输。它的开销比 WebDAV 大很多。
如果你只需要让 NAS 上的视频能在 AfuseKt 播放，建议直接开 WebDAV 而不是 SMB：
- 群晖：控制面板 → WebDAV → 启用
- AfuseKt 侧选择 WebDAV 资源库 → 填写 WebDAV 地址
- 速度更稳、设置更简单
问题四：播放时字幕找不到
SMB 资源里的外挂字幕（和视频同目录的 .srt 文件）在 AfuseKt 里有时加载不出来。
可能原因
| 原因 | 说明 |
|---|---|
| SMB 不支持快速目录遍历 | AfuseKt 扫描同目录字幕时 SMB 没返回文件列表 |
| 字幕编码问题 | 中文 GBK 编码字幕在某些核心上乱码 |
解决
- 先用 VLC 播放（VLC 对 SMB 字幕支持最好）
- 如果 VLC 也找不到字幕 → 换 WebDAV 接入（WebDAV 协议更现代）
- 如果是乱码 → 设置 → 字幕 → 编码 → 切换 GBK / UTF-8 / 自动
SMB vs WebDAV vs Emby 直连（再一次比较）
| 对比 | SMB | WebDAV | Emby 直连 |
|---|---|---|---|
| 设置难度 | 低 | 中 | 高 |
| 局域网速度 | 快（但协议开销大） | 快 | 取决于 Emby Server |
| 公网访问 | ❌ 需内网穿透 | ✅ 端口映射即可 | ✅ 同上 + Plex Relay |
| 元数据 | 无（靠刮削） | 无 | 完整（Emby 提供） |
| 字幕支持 | 可能有问题 | 好 | 好 |
| 推荐指数 | 3/5 | 5/5 | 4/5（如果你会搭 Emby） |
简单说：能用 WebDAV 就别用 SMB。