连接教程
从本地文件、电脑共享或 NAS 开始，也可以连接已有的媒体服务器。以下按 0.80 的连接方式说明；按钮名称会随平台和语言略有差异。示例地址都需要换成你自己的地址，FolioLume 不提供电影片源。
内容核对日期 ·先选一种连接方式
第一次使用，应该选哪种方式？
文件就在当前设备上，选本地导入；影片在家里的电脑或 NAS 上，通常先用 SMB；已有 HTTPS WebDAV 服务，就选 WebDAV；已有 FolioSpace Library、Emby、Jellyfin 或 Plex 片库，则连接对应服务。先在同一局域网用一部小视频测试，再尝试高码率或蓝光内容。
怎样导入本地影片？Apple TV 也能这样导入吗？
iPhone、iPad、Mac 和 Vision Pro 可通过系统文件选择器导入兼容影片或文件夹。Apple TV 版没有这一文件导入入口，请使用网络来源。
- 把影片保存在设备可读取的位置；云盘文件先确认已经下载或可被系统文件选择器读取。
- 在片库中选择导入影片或文件夹按钮，授予所选位置的访问权限。Mac 也可将本地文件或文件夹拖入片库。
- 选择影片开始播放。若移动、删除原文件或断开外置存储导致失效，重新选择可访问的位置。
SMB：共享 Mac、Windows 或 NAS 上的影片
怎样把 Mac 设为 SMB 影片来源？
macOS 自带文件共享，不必另装媒体服务器。只共享影片文件夹，并给播放账户读取权限即可。
- 打开系统设置 → 通用 → 共享，开启文件共享。
- 进入文件共享详情，添加影片文件夹；为准备使用的账户设置“只读”。
- 在选项中启用 SMB，并允许对应账户通过 SMB 访问；记下共享名和 Mac 的局域网地址。
- 让 Mac 保持在线，再按下面的 App 填写步骤连接。
怎样共享 Windows 电脑上的影片？
在可信的家庭网络中启用文件共享，使用有密码的指定账户访问。无需关闭密码保护或把整个磁盘设为所有人可写。
- 将家庭网络设为专用网络，并在高级共享设置中启用网络发现、文件和打印机共享。
- 在资源管理器中右键影片文件夹，选择显示更多选项 → 授予访问权限 → 特定用户；选择账户并保留读取权限。
- 记下电脑的局域网 IP 和实际共享名；使用该账户的登录密码，而不是 Windows Hello PIN。
- 在 FolioLume 中以 smb://电脑IP/共享名 连接。
SMB 在 FolioLume 里具体填什么？
进入“来源”中的连接或添加媒体来源，选择发现的设备，或选“手动添加”。连接方式选 SMB。密码独立填写，不要放进 URL。
- 名称可自定，例如“家中电影”；服务器地址填 smb://192.168.1.20/Movies。
- 填写共享账户的用户名和密码。也可只填 smb://192.168.1.20，再点“浏览共享目录”并选择实际共享。
- 点“连接并添加”。验证成功后浏览文件，按需加入片库。
- 若浏览共享目录没有结果，手动填写完整共享路径；仍需确认账户有该目录的读取权限。
WebDAV：通过 HTTP(S) 读取文件
怎样在 NAS 上部署 WebDAV 并连接？
需要真正的 WebDAV 文件服务地址，NAS 登录页或普通分享网页不能代替。建议使用 HTTPS、有效证书及专用读取账户。
- 以群晖为例，在套件中心安装 WebDAV Server，在套件中启用 HTTPS 并记下端口；默认 HTTPS 端口为 5006，实际以你的配置为准。
- 允许所用账户访问 WebDAV 服务及影片共享目录，并为服务配置与访问域名匹配、设备信任的证书。
- 在 FolioLume 添加来源，选择 WebDAV，填名称、文件服务地址、用户名和密码。例如 https://nas.example.com:5006/Movies/，请替换域名、端口和路径。
- 连接并添加，确认能列出目录，再测试播放和拖动进度。
WebDAV 能打开网页，为什么 App 仍然连接失败？
浏览器显示网页并不代表服务器支持 WebDAV 目录读取和视频分段读取。登录跳转、错误路径、证书问题或代理规则都可能影响连接。
- 确认填写的是 WebDAV 端点及共享目录，不是管理后台或网页登录地址。
- 检查域名与证书匹配、证书受设备信任；不要用关闭证书验证来解决。
- 让服务管理员确认允许目录查询（PROPFIND）和文件读取；播放与拖动还需要正确处理 HTTP Range 请求。
- 401 通常需要重新核对账户；403 检查目录权限；404 检查路径。代理若跳到另一个域名，可能触发凭据保护。
连接已有的媒体库服务
已有 FolioSpace Library，怎样连接？
FolioLume 是客户端。先在已有 FolioSpace Library 中添加视频目录并完成扫描，再使用该服务的根地址与访问令牌连接；安装播放器不会自动部署服务器。
- 向服务管理员确认可访问的 Library 根地址及令牌；如果部署在反向代理子路径下，需要保留该子路径。
- 添加来源，选择 FolioSpace，填写名称、服务根地址和访问令牌。不要把网页路由或 /api/client/videos 手工追加到地址末尾。
- 连接并添加后浏览视频目录；看不到影片时，先检查服务器扫描结果及视频访问权限。
怎样部署并连接 Emby 或 Jellyfin？
在电脑或 NAS 上按服务器官方指南安装，添加影片目录并完成扫描。FolioLume 的“Emby / Jellyfin”连接使用 API 密钥，不使用网页登录密码；兼容情况取决于服务器版本和 API。
- 安装并启动服务器，在网页设置向导中创建管理员和媒体库，先确认网页能看到影片。
- 由管理员在控制台的 API 密钥页面创建一个专供 FolioLume 使用的密钥；菜单位置随服务器版本不同。
- 在 App 添加来源并选 Emby / Jellyfin。填写服务器基础地址，例如局域网 http://192.168.1.20:8096；若服务有子路径则保留子路径，不要包含 /web、index.html 或网页参数。
- 将 API 密钥填入密钥／访问令牌字段，连接并添加。FolioLume 读取可访问的原始影片，不使用服务器转码；观看进度保存在当前设备。
Plex 需要填什么？可以直接用 Plex 账号登录吗？
当前连接需要 Plex Media Server 的基础地址与该服务器的 X-Plex-Token，不是 Plex 账号密码。当前浏览 Plex 电影库，账户需有原始影片访问权限。
- 按 Plex 官方向导安装 Media Server，创建电影库并完成扫描。
- 参照 Plex 官方说明，在 Plex Web 中从影片信息的 XML 链接取得 X-Plex-Token；将令牌当作密码保管，不要截图公开。
- 在 FolioLume 选择 Plex，填服务器基础地址，例如局域网 http://192.168.1.20:32400。不要填 app.plex.tv、/web 页面或带 token 的 URL。
- 将 token 单独填入访问令牌字段，再连接并添加。播放读取原文件；不承诺使用 Plex 转码或同步 Plex 观看进度。
发现、排查与外出访问
为什么局域网扫描找不到服务器？
自动发现只能找到同一局域网内广播相应服务的设备；发现失败并不等于无法连接。0.80 支持发现广播的 SMB、WebDAV，以及支持条件下的 Jellyfin、Plex。
- 确认设备与服务器在可互通的网络，避开访客 Wi-Fi、客户端隔离或不同 VLAN。
- 允许 FolioLume 使用本地网络。在 iPhone / iPad 可检查设置 → 隐私与安全性 → 本地网络。
- 确认服务器已启动且允许服务发现，然后重新扫描；容器或防火墙可能只允许播放端口而不转发发现广播。
- 选择手动添加并填写已知地址。远程 VPN 环境通常也应手动填写，不依赖自动发现。
在外面怎样访问家中的片库？
先在家中连通，再通过自己管理的 VPN 或正确配置的 HTTPS 服务远程访问。FolioLume 不会自动替你开启公网访问。
- 优先使用能让设备访问家庭服务器的 VPN，并向管理者确认所用设备可用的客户端与路由。
- 在 App 手动填写 VPN 可达地址；不要把 SMB 的 445 端口直接转发到公网。
- 若使用 HTTPS 反向代理，配置可信证书、身份验证、正确的服务子路径及视频分段读取；外网地址和令牌应分别填写。
- 实测家庭网络上传速度；远程高码率播放还取决于两端网络。