Tune by Mozaiklabs

故障排除

最常见的问题以及你可以采取的措施。如果都不奏效，请从 Tune 发送报告：它包含诊断所需的一切信息。

界面无法打开

  • 检查 Tune 是否正在运行：在 Windows 上看控制台窗口，运行 sudo systemctl status tune-server（.deb 软件包），在 Tune OS 上运行 sudo systemctl status tune。
  • 地址是 http://<server-address>:8888；在 Tune OS 上是 http://tune-XXXX.local 或 http://<IP-address>。
  • 刚安装的 Tune OS：首次启动需要 15 到 30 分钟，并会自动重启两次。已经能通过 SSH 响应的机器未必已经完成。进度会写入 /var/log/tune-os-firstboot.log。
  • Windows，其他设备无法访问：Windows 防火墙在“专用网络”配置文件上阻止了 Tune。请在 Windows 防火墙中允许 tune-server.exe 在专用网络上通信。同样的拦截也会阻止 DLNA 发现。
  • 端口已被占用：用 TUNE_PORT 选择另一个端口（见配置）。在 Windows 上，自 1.0.0-rc2 起，Tune 已在运行时再从快捷方式启动，只会在浏览器中打开正在运行的实例。
  • Docker：容器不断重启（在 NAS 上表现为意外停止）：挂载到 /data 的文件夹对 tune 用户 (uid 1000) 不可写。由 Docker 自动创建的文件夹（例如 ./data）就是这种情况。请改用命名卷 tune-data:/data（参见快速入门），或将该文件夹的所有者改为 uid 1000：sudo chown -R 1000:1000 ./data。然后重新运行 docker compose up -d。

设备没有出现

  • 设备和服务器必须在同一网络中（同一子网、同一 VLAN）。发现使用多播：SSDP（UDP 1900）和 mDNS（UDP 5353）。
  • 使用 Docker 时，请使用 network_mode: host。
  • 查看设置 › 音频 › 已忽略的设备：该设备可能被隐藏了。
  • 如果机器有多块网卡（或 VPN），请用 TUNE_ADVERTISED_IP 告诉 Tune 应该公布哪个地址。
  • 同一台机器上的 LMS 占用了 3483 端口，因此 Squeezebox 播放器看不到 Tune。

没有声音

本地输出

  • 检查设置 › 音频 › 本地音频输出中的音频后端。在 Windows 上，ASIO 需要 DAC 厂商提供的驱动程序。
  • 可能有其他应用程序以独占模式占用了 DAC：请将其关闭。
  • Linux（.deb 软件包）：该服务以 tune 用户运行，该用户必须属于 audio 组。
  • Linux：在 1.0.0-rc1 中，卡住的 ALSA/PipeWire 扫描可能会让 Tune 失去响应，只能手动重启。自 1.0.0-rc2 起，这种卡顿不再会让服务器失去响应。如果音频输出仍然丢失，请从 Tune 发送报告。
  • 只有一个处理器的机器：自 1.0.0-rc2 起，Tune 始终保留至少 4 个工作线程，以避免曾经打断本地播放、长达数秒的卡顿。

网络设备

  • 设置 › 音频 › 音频诊断（专家级别）和播放栏中的信号路径会显示发送给设备的内容。
  • 检查设备是否接受正在发送的格式。对于 DSD，请在设置 › 设备 › 每区域设置中尝试自动或 PCM（转换）。
  • 向渲染器输出 DSD 256/512 时出现断音：请在设置 › 音频 › DSD 播放（网络渲染器）中选择连续流式传输选项。更新到 1.0 之后，请检查该选项是否仍是你所选择的那一项。

Windows：启动时 ASIO 回退到 WASAPI

现象：已选择 ASIO，但 Tune 启动时只出现 WASAPI 输出（例如“扬声器”），或者播放卡住。1.0.0-rc2 修复了导致这种回退的两个已知原因：Tune 现在会等 ASIO 驱动搜索结束后，才回退到 WASAPI。如果仍然回退了，只要本地输出上没有播放，它会在下一次设备扫描时自动切回 ASIO。

  • 检查设置 › 音频 › 本地音频输出 › 音频后端是否设为 ASIO，以及厂商的 ASIO 驱动程序是否已安装。
  • 重启 Tune。
  • 如果 Tune 显示ASIO 扫描在崩溃后已暂停，说明它已关闭 ASIO 驱动扫描，以避免陷入崩溃循环。请点击重新启用 ASIO 扫描，然后重启 Tune。
  • 如果问题依旧，请从 Tune 发送报告，并注明你的 DAC 及其驱动程序。

Tune OS：1.0.0-rc1 中封面和艺术家照片消失

在 1.0.0-rc1 中，Tune OS 在 /opt/tune/data/artwork_cache 中查找封面缓存，而早期版本把它存放在 /opt/tune/artwork_cache，因此几乎所有封面和艺术家照片看起来都丢失了。1.0.0-rc2 修复了这个问题。启动时，Tune 会重新使用原来的缓存，并把 rc1 存放在别处的内容复制进去，不会覆盖或删除任何文件。所以只需更新 Tune 即可。如果你已经手动复制过这些图片，也无需撤销。

音乐库

  • 添加的文件夹没有出现：该路径必须存在于运行 Tune 的机器上，并且可被运行 Tune 的账户读取。首次启动之后，修改 TUNE_MUSIC_DIRS 不再有任何效果：请使用设置 › 音乐库 › 位置。
  • 网络共享上的更改没有被发现：Tune 每 15 分钟检查一次共享。要加快速度，请再次运行扫描音乐库。
  • ReplayGain 进度条回到 0 %：在 1.0.0-rc1 中，更新或重启后会出现这种情况。自 1.0.0-rc2 起，它显示的是整个音乐库中已分析的曲目数。
  • 启动时网络共享尚未就绪：自 1.0.0-rc2 起，对于由 Tune 自己挂载的 SMB 共享，Tune 会先等待第一次挂载尝试，再分析音乐库，之后在后台继续重试约 5 分钟。共享缺失期间，封面不再被删除。
  • 更新后封面变了：自 1.0.0-rc2 起，文件夹中的图片（例如 cover.jpg 或 folder.jpg）优先于文件内嵌的封面。对于每张碟一个文件夹的套装，使用套装根文件夹中的图片。你上传的封面永远不会被替换。
  • 后台分析占用了过多的机器资源：请调低设置 › 音频 › 后台分析速度，或在服务器状态中暂停它们。

流媒体服务

  • Deezer：“Deezer 拒绝了 ARL”或会话丢失：打开 deezer.com，获取新的 arl cookie，并把它粘贴到设置 › 访问与令牌 › 流媒体服务中。
  • TIDAL、Qobuz：在同一位置断开并重新连接该服务。
  • YouTube：如果没有启用 YouTube 播放，搜索可以使用，但播放会失败。
  • Spotify：在 1.0 中可以浏览曲库，但无法播放。要连接账户，需要你自己的 Spotify 应用的 Client ID（见流媒体服务）。
  • Bandcamp：几天后从播放队列、历史记录或收藏中重新播放的曲目可能无法播放，因为它的地址已过期。自 1.0.0-rc2 起，这一失败会写入日志，Chromecast 区域会停止并报告错误，而不是保持无声。请从专辑页面重新播放该曲目。

从 Tune 发送报告

打开侧边栏底部的支持。

报告错误（诊断标签页）

对所有人开放，无需许可证。描述发生了什么，必要时添加屏幕截图，然后点击发送到论坛。你的文字、诊断信息和服务器最近的日志会发送到论坛中一个经过审核的帖子。报告中的个人路径会被移除，查看附带的报告会在发送前向你展示它。

如果 Tune 回复了发送次数限制的提示（有时甚至在第一次尝试时就出现，这是已知问题，已经上报），请使用复制报告，把它粘贴到论坛的新主题中，或稍后再试。

联系支持（工单标签页）

此表单在注册了 Tune Premium 许可证时显示。它包含主题、类别、相关区域（可选）、您的留言和附件（最多 5 个文件）。请保持勾选附上日志与系统信息：没有它们，诊断往往需要来回好几轮。可在工单标签页中跟进你的请求。

日志

  • 设置 › 系统 › 服务器状态（高级级别）：下载日志，或下载诊断信息（一个 ZIP 文件，包含日志、诊断信息和配置，凭据已被屏蔽）。日志级别也在同一处设置。
  • 文件：见配置中的“数据存放位置”表格。

另请参阅