三分钟上手 MusicArk

一、快速开始（通用流程）

• 打开 MusicArk，进入设置页面。
• 找到"音乐源/音源管理"（或类似入口），点击"添加"。
• 选择音源类型（Jellyfin/Emby/Plex/Subsonic/Navidrome/WebDAV/道理鱼/本地）。
• 填写服务器地址、账号等信息并保存。
• 回到库页面刷新，即可浏览歌曲、专辑、艺术家与播放列表。

二、连接 Jellyfin

• 地址示例：http://192.168.1.10:8096 或 https://example.com
• 若使用反向代理，确认路径与转发规则正确。
• 账号需拥有访问音乐库权限。

三、连接 Emby

• 地址示例：http://192.168.1.10:8096 或 https://example.com
• Emby 与 Jellyfin 配置方式类似，填写服务器地址和账号即可。
• 账号需拥有访问音乐库权限。

四、连接 Plex

• 确保服务器可从设备网络访问（同网段 / 已做公网映射）。
• 如存在"找不到艺术家/专辑封面"等提示，通常不影响播放，可稍后刷新或检查服务器元数据。

五、连接 Subsonic / Navidrome

我们强烈推荐使用轻量级、开源且专为音乐设计的 Navidrome 作为服务端（兼容 Subsonic API）。

• 地址示例：http://192.168.1.10:4533 (Navidrome 默认端口)
• 确认服务器开启 Subsonic 兼容接口（Navidrome 默认开启）。

六、连接 WebDAV (含 AList)

通过 WebDAV，你可以直接连接 NAS、坚果云，或使用 AList 挂载阿里云盘/夸克/123云盘等。

• 地址示例：https://your-alist.com/dav/ 或 https://dav.jianguoyun.com/dav/
• 若访问慢，优先检查 DNS、证书、以及服务器的限速策略。
• 文件路径层级较深时，首次索引可能需要一点时间。

七、连接道理鱼 (DaoLiYu)

道理鱼是一款面向 NAS 用户的自托管音乐管理与播放平台，MusicArk 全面支持道理鱼音乐库。

• 地址示例：http://192.168.1.10:5173 或 https://your-daoliyu.com
• 在音源设置中选择"道理鱼"类型，填写服务器地址、邮箱和密码。
• 连接成功后即可浏览和播放道理鱼音乐库中的所有内容。

八、本地音乐

• 授予媒体读写权限后，应用会扫描设备音乐文件并建立索引。
• 建议将音乐整理到固定目录，减少重复扫描与重复条目。

九、已缓存功能

侧边菜单新增「已缓存」入口，快速查看当前音乐库中已下载到本地的歌曲，方便在网络不佳时离线播放。

• 支持所有网络音乐库（Subsonic, Navidrome, Plex, Jellyfin, Emby, WebDAV, 道理鱼）。
• 通过 URI、streamUrl、playKey 等多种方式智能识别歌曲的缓存状态。
• 在侧边菜单选择「已缓存」即可查看所有已下载的歌曲。

十、发现页模式

发现页支持两种显示模式，可在「界面设置」中切换：

• 浮层模式 - 点击后弹出浮层，快速预览，下拉关闭。
• 独立页面模式 - 作为独立页面显示，沉浸式浏览体验。

十一、体验拉满的小技巧

• 开启智能取色主题：让界面随封面自动换色。
• 打开点光源效果：播放页氛围更强。
• 启用智感握姿：单手操作更顺手。
• 添加桌面小组件：桌面/锁屏快速播控与歌词展示。

十二、常见问题排查

连接失败 / 无法拉取列表

• 确认 URL 是否包含正确协议（http/https）与端口。
• 确认手机与服务器网络互通（同 Wi-Fi 或已做公网访问）。
• 确认反向代理路径是否正确（含子路径时特别容易出错）。
• 确认账号权限足够（尤其是 Plex/Jellyfin/Emby 的库权限）。

封面/歌词偶尔缺失

• 多数情况下是服务器元数据未完整或缓存未命中，刷新后会逐步补齐。
• 如果你是 WebDAV，本地文件是否包含标准标签（标题/艺术家/专辑）也会影响匹配。

想反馈问题

你可以通过邮箱或反馈表单联系我们： wuyouziyuan@qq.com 复制邮箱