PassNAT LogoPassNAT

自建私人音乐库随时随地听,Go轻量级音乐服务器Euterpe,NAS一键部署内网穿透

作者

小编

发布时间

Curving abstract shapes with an orange and blue gradient

项目介绍

Euterpe 是一款功能强大的自托管音乐流媒体服务,让你可以随时随地畅享自己的音乐库。相比传统的网络挂载方式,Euterpe 提供了一个优雅的解决方案——只需一个浏览器就能访问你的音乐收藏,就像拥有自己的私人 Spotify 一样。

这是一个轻量级的音乐服务器,采用 Go 语言开发,打包为单一二进制文件,无需复杂的依赖配置。它支持 MP3、FLAC、OGG、WAV、M4A 等多种常见音频格式,提供了简洁美观的 Web 界面,还能自动下载专辑封面和艺术家图片。无论你在家还是在外,都能通过浏览器轻松访问和播放你的音乐。

点我跳转

项目地址:

部署安装

若要在外网也能访问你的音乐库,建议配置内网穿透服务。推荐使用 帕斯内网穿透,先注册账号备用。具体的操作步骤可以参考 这份详细攻略,一步步轻松上手。

使用 Docker 快速部署

打开你的 NAS 设备(飞牛 NAS 或其他品牌均可)。

在本地镜像管理中,选择「添加镜像」→「从 URL 添加」,输入以下镜像地址:

1ironsmile/euterpe:latest

等待镜像下载完成后,点击启动按钮启动容器。

勾选「开机自动启动」确保服务持久运行,然后进入下一步。

端口设置

容器内部运行在 9996 端口。建议将其映射到主机的 8080 端口(或其他未被占用的端口),这样你就能通过 http://你的IP:8080 访问音乐服务。如果遇到端口冲突,可以自由修改宿主机端口,但容器内端口需保持为 9996

存储位置配置

你需要创建一个文件夹用来存放音乐库。建议在 NAS 上创建一个专用目录(如 /mnt/music),然后将其映射到容器内的 /root/Music 路径。这样 Euterpe 就能扫描并播放这个目录中的所有音乐文件。

环境变量设置

此项目的 Docker 镜像无需特殊的环境变量配置,所有设置都会在首次启动时自动生成。如有高级需求,可后续编辑配置文件进行调整。

点击启动,容器创建成功后,打开浏览器访问 http://你的NAS_IP:8080,即可看到 Euterpe 的音乐播放界面。

到这里,部署就完成了!

功能特性速览

简洁高效:单一二进制文件,响应速度快

格式支持丰富:MP3、FLAC、OGG、WAV、M4A、Opus 等

智能封面管理:自动从 Cover Art Archive 下载专辑封面

艺术家信息:从 Discogs 自动获取艺术家图片

强大搜索:支持按歌曲名、艺术家、专辑搜索

批量下载:一键下载整张专辑为 ZIP 文件

用户认证:支持 HTTP Basic、Token 等多种认证方式

开放 API:提供 RESTful API,支持第三方客户端接入

跨平台客户端:iOS/Android 移动应用、GTK 桌面客户端等

本篇教程结束