功能說明
准备
- NAS 或服务器已开启对应服务（例如 SMB 文件共享、WebDAV 服务），并有一个能读取音乐文件夹的账号。
- 在家用网络外访问时，需要外网域名、端口转发、VPN 或厂商的远程访问服务。
- 入口：设置 › 音乐源管理（「资料库」分组） › +，在「选择音乐源类型」中选择 NAS 或「协议」下的类型。
地址怎么填
- 「服务器地址」接受域名、IP 或完整网址。端口留空，保存时 Primuse 会自己试出来。
- 地址下方会实时显示 Primuse 的识别结果，例如「公网」「虚拟组网」或「识别为 QuickConnect ID」。识别错了可以点「这其实是内网里的主机名」或「这其实是远程接入标识」纠正。
- 点「添加备用地址」可再填一个「备用地址」，例如内网 IP 加外网域名各一个。地址分为两个位置，都占满后多余的一行会提示「地址位置已经占满，这一行不会被用到」。
- 需要固定端口或加密时，打开「手动设置端口与加密」。
各类型要点
| 类型 | 需要填写 | 可选项与说明 |
|---|---|---|
| Synology | 「连接方式」选地址或 QuickConnect；DSM 账号和密码 | 只需输入 DSM 控制面板中的 QuickConnect ID；Primuse 会自动选择直连、Smart DNS 或中继。 开启两步验证时按提示输入 6 位验证码；可打开「记住设备」 |
| QNAP | 地址、账号、密码 | 支持 QTS / QuTS；同样支持两步验证和「记住设备」 |
| SMB/CIFS | 地址、「共享名称」、用户名和密码 | 支持 SMB2/3；「认证方式」可选「访客」 |
| WebDAV | 完整网址或主机、用户名和密码 | 可填子路径；「认证方式」可选「访客」 |
| FTP | 地址、用户名和密码 | 「加密方式」支持 FTPS/FTPES；可选「访客」（匿名）；「数据连接」默认「自动」 |
| SFTP | 地址、用户名；「认证方式」选密码或「SSH 密钥」 | 粘贴 PEM 格式私钥... |
| NFS | 地址 | 「NFS 版本」可选 v3 或 v4；首次需连接并选好导出路径 |
| S3 | 端点、「存储桶」、「区域」、「访问密钥」、「私密密钥」 | 兼容 AWS S3、MinIO、R2 |
| UPnP/DLNA | 通常无需填写，自动发现 | 需要和服务器在同一局域网 |
FTP 的「数据连接」：「自动」先试 EPSV，服务器不支持再用 PASV；服务器报出的是内网地址时，改连你填的地址。只有服务器只认某一种命令时才需要选「被动（PASV）」或「扩展被动（EPSV）」。「主动（PORT）」给只允许主动模式的服务器用：由服务器反过来连接这台设备，所以只在与服务器同一网络时可用，用蜂窝数据连不上。
选择目录并扫描
- 保存后进入「扫描目录」，勾选放音乐的文件夹。
- 点「完成」，扫描开始。可以离开此页继续使用，扫描会在后台进行
- 以后可以在音乐源那一行点「管理目录」增减目录，或点「扫描」读取新增和变动的文件。
预期结果： 资料库中出现所选目录里的歌曲，封面、歌词在后台陆续补齐。
限制
- 绿联 Ugreen 与 飞牛 fnOS 的专用连接暂未开放，可改用 SMB、WebDAV 等通用协议，飞牛用户也可使用「飞牛音乐」（见媒体服务器文章）。
- 自签名 HTTPS 证书需要在确认属于自己的服务器后再信任，相关列表在 设置 › 受信任的域名（「安全」分组）。
- 内网地址只有连着同一个网络才通，离开家后需要外网地址或 VPN。