SMB、FTP、WebDAV一网打尽:用mpvRx浏览NAS网络存储的实用清单
SMB、FTP、WebDAV一网打尽:用mpvRx浏览NAS网络存储的实用清单
mpvRx 是一款基于 libmpv 的 Android 强力媒体播放器,内置 SMB、FTP、SFTP、WebDAV 四种网络协议客户端,让手机直接浏览并播放 NAS 上的影音库,无需额外装文件管理器。这篇实用清单带你 5 分钟把 NAS 接入 mpvRx,附安全设置与排障技巧。
📡 四种网络协议,默认端口一次记牢
mpvRx 在浏览器主界面提供独立的 Network(网络) 入口,其中的 Local Network(本地网络) 标签页专门用于 NAS 浏览,与在线媒体、Syncplay 标签并列(入口见 NetworkStreamingScreen.kt)。支持的协议与默认端口如下(定义见 NetworkConnection.kt):
| 协议 | 默认端口 | 典型用途 | 加密 |
|---|---|---|---|
| SMB | 445 | Synology、QNAP、Windows 共享等 NAS | ❌ |
| FTP | 21 | 传统文件服务器 | ❌ |
| SFTP | 22 | SSH 加密文件访问 | ✅ |
| WebDAV | 80 / 443 | HTTP 存储,可启用 HTTPS | 可选 |
💡 新手建议:家用 NAS(群晖、威联通)首选 SMB;云服务器上的媒体目录选 SFTP 或 HTTPS WebDAV。
🔍 一键发现:局域网自动扫描 NAS
不知道 NAS 的 IP?mpvRx 内置基于 DNS-SD 的局域网扫描,约 12 秒内自动发现 SMB / FTP / SFTP / WebDAV 服务,直接列出设备名、协议、端口,点击即可尝试连接(实现见 LocalServerDiscovery.kt)。
✅ 清单第 1 步:确保手机与 NAS 连在同一局域网(Wi-Fi 或网线)。
➕ 添加连接:4 步完成
打开 Network 入口,点击 Add Connection(添加连接),在弹出的编辑面板(ConnectionEditorSheet.kt)中填写:
- Name:给连接起个名字,如“我的群晖”
- Protocol:选择 SMB / FTP / SFTP / WebDAV
- Host + Port:填 NAS 的 IP 或主机名;⚠️ 只填地址,不要把浏览器网页 URL 粘进去
- Path:起始路径,SMB 可填
/Share名/文件夹直达媒体目录
随后按需填写用户名/密码(支持 域\用户名 格式),勾选 Anonymous/Guest Access 可匿名访问;WebDAV 可勾选 HTTPS。保存后连接会持久化到本地数据库,支持自动连接,下次打开直接进入。
📁 SMB 使用技巧清单
- ✅ 只填主机名:如
192.168.1.10,路径栏再指定共享文件夹,播放时按路径自动解析共享(见 NetworkAddress.kt) - ✅ UNC 路径也认:直接粘贴
\\NAS\Videos也能被正确解析 - ✅ 域账户:Windows Server/域环境下用户名填
DOMAIN\user即可 - ✅ 固定常用目录:把电影、剧集文件夹加入书签,配合专辑视图/树形视图双模式快速定位
🔒 安全设置清单(新手必看)
- ✅ 公共网络或不信任网络下,优先 SFTP 或 HTTPS WebDAV,别用明文 FTP
- ✅ 永远不要把 SMB / FTP 端口直接暴露到公网
- ✅ 在 NAS 上建最小权限的专用媒体账户,只读即可
- ✅ 提交 Issue 时不要泄露服务器地址与凭据
🛠️ 连不上?按顺序排查这 4 点
- 网络互通:手机与 NAS 能否互相 ping 通?Wi-Fi 隔离(AP 隔离)会拦截
- 端口开放:NAS 防火墙是否放行 445 / 21 / 22 / 80 端口
- 账户权限:该账户是否有权限列出目标目录
- VPN / 私有 DNS:拦截了局域网流量,暂时关闭试试
另外,WebDAV 文件名带空格或特殊字符时,请用应用内浏览进入,不要手动拼 URL。更多细节可参考官方文档 local-and-network.mdx。
🎬 接入后的进阶玩法
- 逐集追番:NAS 剧集目录可直接展开播放列表,边看边切集,章节导航一目了然
- 投屏到大屏:局域网服务器可临时暴露给 Chromecast,把 NAS 影片投到电视
- 自动续播:播放进度自动记录,下次回到上次位置
✅ 总结
用 mpvRx 浏览 NAS 只需记住这条主线:同一局域网 → 自动发现或手动添加 SMB/FTP/WebDAV 连接 → 指定媒体目录 → 播放。配合安全清单与排障四步,手机秒变 NAS 影音遥控器,全家共享的媒体库从此触手可及。


