SMB 共享 NAS 接入——通过 Samba 把 NAS 里的音乐加进曲库
SMB 是什么
SMB（Server Message Block）是 Windows 共享、macOS 文件共享、Linux Samba 共享以及主流 NAS（群晖、威联通、极空间等）通用的文件共享协议。Symfonium 支持 SMB v2 和 SMB v3 两个版本。
连接步骤
- 设置 → Manage media providers → Add media provider → SMB / Samba
- 填写：
- 服务器地址：NAS 的内网 IP（比如
192.168.1.10） - 共享名：NAS 上暴露出来的那个共享目录名
- 用户名 / 密码：如果共享是需要密码的，填 NAS 上的账号密码；匿名共享留空
- 选择要索引的子目录（也可以留空直接扫整个共享）
- 测试连接通过后完成
SMB v2 vs v3
- SMB v3：性能更好、支持加密、适合现代 NAS 和路由器；Symfonium 自动优先 v3
- SMB v2：兼容性更好，老设备或老 NAS 只开 v2 时用
Symfonium 会自动协商版本，通常不用手动选。
权限与安全注意点
- SMB 密码通常是 NAS 上的本地账号密码或域账号密码；不要用你夸克 / Google / OneDrive 这些云服务的账号密码
- NAS 上建议专门建一个只给 Symfonium 用的账号，权限设成只读——这样即使手机丢了，对方也只能播放音乐，改不了 NAS 上的任何东西
- 不建议把 SMB 直接暴露到公网；远程访问用 VPN 或 Tailscale 更稳
和 WebDAV 的差异
| 对比项 | SMB | WebDAV |
|---|---|---|
| 典型场景 | Windows/macOS/Linux/NAS 局域网共享 | 跨平台 HTTP 文件访问 |
| 部署门槛 | 几乎所有 NAS 自带 | 可能需要自己搭 WebDAV 服务 |
| 性能 | 局域网内通常更快 | 稍慢但能走 HTTPS 加密 |
| 远程访问 | 不行（需 VPN） | 可以（走公网 HTTPS） |
| Symfonium 投屏时 | Chromecast / UPnP 用不到 SMB | 需要 Symfonium 代理流 |
局域网内优先 SMB，需要跨公网访问时优先 WebDAV。
常见问题
- 扫出来文件数偏少：检查 NAS 上那个共享目录的权限，确认 Symfonium 登录的账号能看到所有子目录
- 连接超时：确认 Symfonium 和 NAS 在同一网段；如果是跨网段，确认路由器没做 AP 隔离
- 中文字符乱码：少数老 NAS 的 Samba 配置没开 UTF-8 编码，需要在 NAS 那边调