NAS一键部署免费开源音乐播放器Solara

对于NAS用户而言，音乐、影视和相册管理无疑是三大核心娱乐需求。

本次我们将介绍一款基于免费API构建的音乐播放器：Solara（光域）。

本文所涉及的项目是在原版Solara（项目GIF取自原版）基础上进行修改的版本，支持通过Docker一键部署，兼容X86与ARM架构设备。该项目仅供学习交流之用，请务必支持正版音乐！

项目介绍

原项目： akudamatata/Solara，在GitHub上搜索即可找到。本文所用镜像： exus/solara-music。

⚠️ 重要声明： 原项目作者明确禁止任何商业化行为，并要求任何衍生项目必须保留原项目地址并以相同协议开源。因此，大家可以放心使用。

以下主要特性直接引自原项目说明：

🎨 主题美学： 内置亮色/暗色模式与玻璃拟态（Glassmorphism）界面，能够根据当前播放曲目的封面自动提取主色调，渲染出沉浸式的动态背景，提供出色的视觉体验。

📱 竖屏移动端： 专为移动设备设计了全新的竖屏布局，完美适配手机屏幕比例与触控手势，按钮、列表及歌词显示均针对单手操作进行了优化。

🔍 跨站曲库检索： 支持一键切换不同的音乐数据源，提供分页浏览功能，并可将搜索结果批量导入播放队列。

📻 灵活的队列管理： 支持对播放队列进行新增、删除、清空等操作，所有更改即时生效，并能自动将状态持久化保存到浏览器的 localStorage 中。

❤️ 收藏列表： 无论是搜索到的歌曲还是正在播放的列表，均可一键添加至收藏。收藏列表拥有独立的播放进度记忆、播放模式设置以及批量操作面板。

🔁 丰富的播放模式： 支持列表循环、单曲循环与随机播放等多种模式，并可记忆用户上一次使用的偏好设置。

📝 动态歌词视图： 提供逐行滚动并高亮显示歌词的功能，当前播放行会自动聚焦于视图中央。用户手动滚动歌词后，视图会暂时锁定以便阅读。

🔄 列表导入与导出： 支持将当前的播放队列与收藏列表统一导出为文件，或从文件导入，便于一键迁移收藏歌曲或从备份中恢复，并可同步至播放队列。

📥 多码率下载： 允许用户选择128Kbps、192Kbps、320Kbps乃至无损FLAC等多种音质格式，并直接获取对应的音频文件。

☁️ 轻量后端代理： 通过Cloudflare Pages Functions构建统一的后端服务，聚合各个音乐数据源，并处理音频流的跨域访问问题。

🔒 锁屏播放控制： 在手机锁屏界面会自动显示专辑封面与基础的播放控制控件（播放/暂停、上一曲/下一曲），无需解锁手机即可进行操作。

🛠️ 调试控制台： 在Web界面按下 Ctrl + D 组合键可呼出实时日志面板，方便开发者或高级用户排查接口请求或交互过程中的异常情况。

不过，这里可能存在一个令部分NAS用户感到不便的点：虽然服务部署在NAS上，但音乐下载的保存路径默认无法直接绑定到NAS的共享文件夹中。除了这一点，Solara的整体服务体验相当出色。

最后需要提醒的是，此类依赖于第三方API的服务需要保持更新。如果某天发现无法正常播放或下载音乐，很可能是因为API源发生了变动。此时，通常只需重新拉取（pull）最新的Docker镜像并重新部署容器即可解决问题。

部署流程

我们以威联通（QNAP）NAS为例，演示如何使用Docker Compose的方式部署Solara。

以下是部署所需的Compose配置代码。如果复制后格式出现问题，建议借助文本编辑器或AI工具进行重新排版：

services:
  solara-music:
    image: aexus/solara-music:latest
    container_name: solara-music
    restart: unless-stopped
    ports:
      - "5841:3001"
    environment:
      - NODE_ENV=production
      - PORT=3001
      - SOLARA_PASSWORD=qnap1234 # 请务必修改为你自己的访问密码
      - SESSION_SECRET=KLmlKDruIBRYjrT5ct7B3xqG25ZF2p59 # 请修改为32位随机字符串，可使用`openssl rand -base64 24`命令生成
    volumes:
      - /share/Container/solara/logs:/app/logs

配置中的卷（volumes）映射主要用于存储应用日志，如果不需要保留日志，删除此行即可。

在威联通NAS上，打开Container Station（容器工作站），选择“创建” -> “创建应用程序”，将上述代码粘贴到编辑框中。

使用简介

部署完成后，在浏览器地址栏输入 你的NAS内网IP:5841 即可访问Solara的Web界面。

登录后显示的主界面。

首先，个人认为其中的“音乐雷达”功能颇为实用，它类似于一个智能推荐电台，能够根据喜好播放随机音乐。

音乐搜索结果的展示页面。

音乐播放界面。界面虽简洁，但功能齐全，背景色会随专辑封面主题动态变化。

在播放界面点击“download”按钮下载当前歌曲。

在歌曲列表内也可以进行批量下载操作。

下载任务完成后的提示。

诸如单曲循环、列表循环、随机播放等基础功能均得到良好支持。此外，如前文所述，播放列表的导入与导出等进阶功能也一应俱全，在此不再赘述。

如果你希望偶尔在外网访问家中NAS上的Solara服务，也完全可行。只需在路由器或NAS上设置好反向代理（反代），将服务端口暴露到公网（请注意安全设置）。Solara对手机浏览器的适配做得相当不错（下图取自原项目）。

结语

总的来说，Solara是一款体验良好、功能全面的自建音乐流媒体解决方案。如果你正在为NAS寻找一个免费开源的音乐播放器，不妨尝试部署它。