什么是 Euphony？
Euphony 是一款专为高保真（Hi-Fi）音频爱好者打造的轻量级 Linux 系统，主要用于搭建数字音频播放器（数播）。它支持多种音频协议（如 UPnP/DLNA、Roon Ready、AirPlay 等），可运行在树莓派、x86 主机等多种硬件平台上，提供稳定、低延迟、高音质的音乐播放体验。
准备工作
- 一台兼容的设备（如树莓派 3B+/4B、Intel NUC、老旧笔记本等）
- 一张容量 ≥ 16GB 的 microSD 卡（树莓派）或 USB 启动盘（x86）
- 稳定的网络连接（有线优先）
- 电脑用于写入系统镜像
- 音箱或功放 + DAC（数字模拟转换器）
安装步骤
- 访问 Euphony 7LONGWEN 下载最新镜像文件（.img）
- 使用 BalenaEtcher 或 Raspberry Pi Imager 将镜像写入 SD 卡/USB 盘
- 将存储设备插入目标主机，接通电源和网络
- 等待约 2–5 分钟，系统首次启动会自动完成初始化
- 在浏览器中访问
http://euphony.local 或通过路由器查找 IP 地址进入管理界面
提示：首次启动建议使用有线网络，避免 Wi-Fi 配置问题。若无法访问 euphony.local，请登录路由器查看分配的 IP。
基础设置
进入 Web 管理界面后，您可以进行以下操作：
- 语言与时区：在“System”中设置为中文（简体）和本地时区
- 音频输出：在“Audio”中选择正确的声卡和采样率（建议设为“Auto”或根据 DAC 支持情况手动指定）
- 网络共享：在“Storage”中挂载 NAS 或本地音乐文件夹（支持 SMB/NFS/USB）
- 服务启用：开启 UPnP/DLNA、Roon Bridge、AirPlay 等服务以适配不同播放软件
常用播放方式
配置完成后，可通过以下方式播放音乐：
- UPnP 控制器：使用 BubbleUPnP（安卓）、mconnect（iOS）等 App 控制播放
- Roon：若已部署 Roon Core，Euphony 可作为 Roon Ready 设备无缝接入
- AirPlay：苹果设备可直接通过 AirPlay 推送音频至 Euphony
- 网页播放器：部分版本内置简易 Web 播放器，可直接上传或选择本地曲目
常见问题
Q：没有声音怎么办？
A：检查音频输出设备是否选对，DAC 是否供电正常，音量是否被静音。
Q：无法访问 euphony.local？
A：尝试使用 IP 地址访问，或检查 mDNS 服务（如 Avahi）是否运行正常。
Q：音乐卡顿或跳音？
A：优先使用有线网络；关闭不必要的后台服务；确保电源适配器功率充足。