快速入门

Tune 是一款多房间音乐服务器。它会为你的音乐（本地文件、网络磁盘）和流媒体服务建立索引，然后把音乐送到你的各种设备：接在电脑上的 DAC、DLNA/UPnP 渲染器、AirPlay 音箱、Chromecast、Squeezebox 播放器等。你可以在本地网络中任意设备的网页浏览器里控制它。

选择安装方式

你拥有……	安装
一台专用机器（x86-64 迷你主机、Raspberry Pi 5）	Tune OS，开箱即用的完整系统
一台 Windows 电脑	Windows 安装程序（`…-windows-x86_64-setup.exe`）
一台 Mac	macOS 磁盘映像（`.dmg`）或 Homebrew
一台运行 Debian、Ubuntu 或 Raspberry Pi OS 的电脑	`.deb` 软件包
运行 Docker 的 NAS 或服务器	`renesenses/tune` Docker 镜像

所有文件都在下载页面。

Windows

运行 tune-server-v…-windows-x86_64-setup.exe。它安装在你的用户配置文件中（%LOCALAPPDATA%\Programs\Tune Server），不需要管理员权限。
从桌面或开始菜单打开 Tune Server。会出现一个控制台窗口（那就是服务器：请保持打开），随后浏览器会在 http://localhost:8888 显示 Tune。
如果 Windows 防火墙询问，请允许 Tune 在专用网络上通信。否则，其他设备和网络渲染器将无法访问 Tune。

Tune 不会安装为 Windows 服务，也不会随登录自动启动：请通过 Tune Server 快捷方式再次启动。也提供 .zip 压缩包。

macOS

打开 tune-server-v…-macos-….dmg 磁盘映像，把 Tune Server 拖到“应用程序”中（需要 macOS 13 或更高版本）。
启动 Tune Server。它不会在 Dock 中显示图标：它会启动服务器，并在浏览器中打开 http://localhost:8888。

使用 Homebrew：

brew tap renesenses/tap
brew install tune-server
brew services start tune-server

Linux（Debian、Ubuntu、Raspberry Pi OS）

.deb 软件包（amd64 或 arm64）需要 Debian 12、Ubuntu 22.04、Raspberry Pi OS bookworm 或更高版本。

sudo apt install ./tune-server_<version>_<arch>.deb

tune-server 服务会立即启动，此后每次开机也会自动启动。然后打开 http://<machine-address>:8888。

sudo systemctl status tune-server     # service status
sudo systemctl restart tune-server    # restart
journalctl -u tune-server -f          # follow the log

该服务以系统用户 tune 运行（属于 audio 组，因此可以访问 USB DAC）。该用户必须能够读取你的音乐文件夹。其他发行版也提供 .tar.gz 压缩包，它们不会安装 systemd 服务。

Docker

services:
  tune:
    image: renesenses/tune:latest
    container_name: tune
    network_mode: host
    restart: unless-stopped
    volumes:
      - /path/to/music:/music:ro
      - tune-data:/data
    environment:
      - TUNE_MUSIC_DIRS=["/music"]
      - TUNE_AUTO_SCAN=true

volumes:
  tune-data:

请把 /path/to/music 换成本机上存放音乐的文件夹：Tune 以只读方式 (:ro) 读取。/data 请保留命名卷 tune-data：Tune 以 tune 用户 (uid 1000) 在此写入数据库。由 Docker 自动创建的主机文件夹（例如 ./data:/data）属于 root，Tune 无法写入，容器会不断重启。在 Synology 或 QNAP NAS 上，请按照下载页面上的步骤操作。

Tune 需要 network_mode: host 才能发现网络上的设备（DLNA、AirPlay、Chromecast）。Docker 镜像无法向本机的声卡或 DAC 播放，它只为网络设备提供服务。它不会自动更新：请拉取新镜像（docker compose pull）并重新创建容器。

Tune OS

Tune OS 是一个完整的系统，可以把一台机器变成专用的 Tune 服务器。提供三种镜像：

x86-64 安装程序（ISO）：把它复制到 U 盘（Rufus、balenaEtcher），然后从 U 盘启动机器。它会擦除目标磁盘，并且只能安装到空磁盘上。你需要一台关闭了 Secure Boot 的 UEFI 电脑、4 GB 内存，以及首次启动时使用的有线以太网连接。
x86-64 可直接刷写的镜像（.raw.xz）：直接写入机器的磁盘（balenaEtcher，或使用 Rufus 的“DD Image”模式）。
Raspberry Pi 5（.raw.xz）：写入 Pi 的存储卡或硬盘。

首次启动不会提出任何问题。它需要 15 到 30 分钟，机器会自行重启两次：请等待它完成，即使它已经可以通过 SSH 响应。然后打开 http://tune-XXXX.local（XXXX 是 MAC 地址的最后四个字符）或 http://<IP-address>。机器的屏幕上也会显示地址和 IP。

控制台和 SSH 使用的账户是 tune，密码为 tune。请用 passwd 命令修改密码。USB 驱动器会自动挂载到 /media 下。Tune OS 可在 Tune 内更新（见配置）。

首次启动

只要音乐库是空的，Tune 就会打开欢迎使用 Tune Server向导：

开始使用。如果你是从另一台机器迁移过来的，从另一台机器迁移？可以让你导入备份。
音乐媒体库：输入音乐文件夹的路径（以运行 Tune 的机器的视角，例如 /mnt/nas/Music 或 D:\Music），然后点击添加。
流媒体服务：现在或以后连接你的账户（见流媒体服务）。
扫描媒体库：开始扫描。扫描会在后台继续进行，因此你可以不必等待，直接点击完成设置。

你也可以跳过向导（跳过设置），稍后在设置（侧边栏顶部的齿轮图标）中进行所有设置。

播放第一首曲目

Tune 会为发现的每个设备自动创建一个区域。区域是一个收听目的地，拥有自己的播放队列和音量。
在底部的播放栏中，点击区域名称（切换区域），选择收听的位置。若要在显示 Tune 的这台设备上收听，请选择此浏览器。
在侧边栏中打开音乐库，选择一张专辑，然后点击播放。

熟悉界面

侧边栏：首页、搜索、正在播放、播放队列、历史记录、音乐库、Oxygen、流媒体、直播电台、播客。然后是精选组（收藏集、播放列表、稍后收听、标签、收藏、已屏蔽的曲目），最底部是支持。
播放栏：播放控制、当前区域、音量、信号路径和发烧友模式（见播放与区域）。
界面级别：在账户菜单（右上角的头像）的“界面”部分，选择基础、高级或专家。这只会显示或隐藏菜单和设置，与你的套餐无关。Tune 默认从专家开始，显示全部内容。如果本指南中提到的某个菜单找不到，请检查这个级别。

在其他设备上使用 Tune

同一本地网络中的任何设备都可以在浏览器中打开 http://<server-address>:8888（在 Tune OS 上可以省略端口）。

另请参阅

音乐库管理：文件夹、网络共享、元数据
播放与区域：输出设备、DSD、Bit-Perfect
故障排除：常见问题