使用教程

开始前：准备网络与权限

NAS Player 是播放器和媒体服务器之间的客户端。它不会替你创建共享目录，也不会绕过服务器权限。开始前请确认：

• iPhone 或 iPad 能访问服务器所在网络；首次配置局域网服务时，允许应用访问本地网络。
• 服务器已开启对应服务，并准备好共享名、端口、用户名和密码。
• 播放大文件时，优先使用稳定的 Wi-Fi；移动网络访问需要服务器和路由器额外配置公网入口。

1. 添加媒体来源

在首页点击添加来源，选择你的服务类型：

• SMB：适合局域网内的群晖、威联通、Windows 或 macOS 共享文件夹。
• WebDAV：填写 HTTPS 地址、路径、用户名和密码。优先使用 HTTPS。
• Jellyfin：填写 Jellyfin 服务地址和账号，登录后即可浏览媒体库。
• 本地文件：通过「文件」App 或 Wi-Fi 传输把媒体导入 NAS Player。

添加来源后，媒体库列表会显示连接状态。点击来源可以重新编辑地址、路径和账号；删除来源只会移除本应用里的连接配置，不会删除服务器上的文件。

2. 连接 SMB 共享

填写服务器地址、共享名称、用户名和密码。服务器地址只填写主机名或 IP，不要把共享名重复写进地址；如果设备要求端口，请按服务器配置填写。首次连接建议在同一 Wi-Fi 下完成。

如果服务器有多个共享目录，先选择共享，再浏览文件。遇到「无法连接」时，先用系统「文件」App 验证同一账号能否打开该共享，再检查 NAS 的 SMB 版本、访客权限和防火墙。

3. 连接 WebDAV

填写完整的 WebDAV 地址、路径、用户名和密码。优先使用 HTTPS；如果是局域网内的 HTTP 服务，请确认服务器只对可信网络开放，并检查应用的网络安全设置是否允许该连接。

常见问题包括路径多写或少写一层、反向代理没有转发 PROPFIND，以及账号只有网页权限但没有文件读取权限。可以先在浏览器或桌面 WebDAV 客户端验证同一个 URL。

4. 连接 Jellyfin

填写 Jellyfin 服务的地址和端口后登录。地址应指向 Jellyfin 服务根地址，不要填媒体库页面路径。登录后，NAS Player 通过 Jellyfin 提供的媒体列表和播放地址浏览内容；账号是否能看到某个媒体库由 Jellyfin 的用户权限决定。

5. 播放视频和音乐

点按文件即可播放。视频播放页支持音轨、字幕、倍速、画面比例、画面调整、画中画和 AirPlay；音乐支持播放列表、锁屏控制和后台播放。播放进度会保存在本地，重新打开同一媒体可以继续观看或收听。

支持的常见媒体包括 MP4、MKV、AVI、MOV、WMV、FLV、M3U、MP3、FLAC、APE、AAC、M4A、OGG 等。具体编码能力取决于文件封装、音视频编码和设备性能。

6. 导入字幕

把字幕文件放在视频同一目录，或在播放页打开字幕选择器，从 SMB、WebDAV、Jellyfin 或本地文件中选择。支持 SRT、ASS、SSA、SUB、IDX、VTT、SMI 等常见字幕格式。字幕乱码时，优先将文件保存为 UTF-8，并确认字幕时间轴与视频版本一致。

7. 本地文件与 Wi-Fi 传输

本地文件可以通过系统「文件」App 的「打开方式」导入，也可以在应用提供的 Wi-Fi 传输入口中，将电脑与手机连接到同一网络后上传。上传完成后文件保存在本应用空间，不会自动同步回 NAS。

传输过程中请保持应用在前台并避免切换网络；完成后可在本地文件列表中播放、删除或通过系统分享导出。

8. 连接失败时

先确认设备与服务器在同一网络，检查端口、防火墙和共享权限。WebDAV 请确认 URL 以 https:// 开头；Jellyfin 请确认服务器地址包含正确端口。

仍然无法连接？请记录服务类型、服务器软件、iOS 版本、网络环境和可复现步骤，再查看联系开发者页面。请勿在截图或日志中包含密码、访问令牌和完整公网地址。