Navidrome：自建音乐库的又一选择

Navidrome 的界面虽然采用的是 Ma­te­r­ial De­sign 设计，但就显示效果来看并不符合我个人的审美需求；网页端虽然全平台通用，但在移动设备上还是需要有一个 App 方便即开即用；即使兼容 Sub­sonic/​Mad­sonic/​Air­sonic 等一系列音乐流媒体协议，但市面上的大部分支持这些协议的播放器都是英文，几乎没有汉化，用着也十分不趁手；更别说直到本文发布的现在，Navidrome 还是不支持外挂 LRC 歌词

……

如此这番批判下，想必你也能理解我为何没有及时安利 Navidrome 了。可现在水文推荐的原因又是什么呢？这两天水群的时候，看到群友推荐了一款国人开发的音乐播放器程序「音流」，界面符合国人审美，设计简洁，功能实用，间接性地解决了 Navidrome 不好看也不好用的痛点。因此，Navidrome 也就值得推荐给大家一试了。

安装

推荐使用 Docker Com­pose 安装 Navidrome。创建 docker-compose.yml 文件，填入以下内容：

version: "3"
services:
  navidrome:
    image: deluan/navidrome:latest
    container_name: navidrome
    user: 1026:100 #用户id，详细解释见后文
    ports:
      - 4533:4533 #左侧端口如有冲突，可随意修改
    volumes:
      - ./navidrome:/data #数据路径
      - /volume1/media/music:/music:ro #音乐路径
    environment:
      #程序默认语言
      - ND_DEFAULTLANGUAGE=zh-Hans
      #启用GRAVATAR头像
      - ND_ENABLEGRAVATAR=true
      #关闭转码，如需要转码请设置为true
      - ND_ENABLETRANSCODINGCONFIG=false
      #SPOTIFY相关
      # - ND_SPOTIFY_ID=
      # - ND_SPOTIFY_SECRET=
      #LAST.FM相关
      # - ND_LASTFM_LANGUAGE=zh
      # - ND_LASTFM_APIKEY=
      # - ND_LASTFM_SECRET=
      #PROXY相关
      # - HTTP_PROXY=http://proxy:port
      # - HTTPS_PROXY=http://proxy:port
    restart: unless-stopped

关于 user 部分，Navidrome 不建议使用 root 用户运行。群晖用户一般是 1026:100 ，可以登录 SSH 终端后输入 id username 查询。例如我的群晖用户名是 mikusa ：

$ id mikusa
uid=1026(mikusa) gid=100(users) groups=100(users),101(administrators),65537(docker)

如果实在是无法确定或者懒得查，那就填写 1000:1000。

在 volumes 文件夹挂载部分，官方建议为音乐文件夹设置只读 :ro 标记以保证不修改音乐文件。群晖用户同时需要注意预创建 navidrome 数据文件夹。

而环境变量的部分，虽然官方文档有数十条可供选择的环境变量，但实际上用到的配置不多，除了固定语言、关闭转码以外，都是些不影响使用的功能。

如果你想让 Navidrome 显示歌手头像，那么需要配置 Spotify 相关的部分。你需要先创建一个 Spo­tify 账户，随后在 https://developer.spotify.com/dashboard/applications 中 Cre­ate app 创建一个应用。

只需填写 App name、App description 以及 Redirect URI 这三处，Redi­rect URI 需要填写 http://localhost/ ，即可保存。

随后返回控制台，点击应用，进入应用设置，即可获取 Client ID 和 Client secret。对应填入环境变量中的 ND_SPOTIFY_ID 和 ND_SPOTIFY_SECRET 。

如果你想让 Navidrome 显示歌手简介、热门歌曲等相关信息，就需要在环境变量中配置 Last.fm。同样先创建一个 Last.fm 帐户，前往 https://www.last.fm/zh/api/account/create 创建 API 帐户，只用填写应用名称。提交后在 API 应用程序 页面复制粘贴 Key 和 Se­cret 到环境变量即可。

上述两项外部功能，视个人网络状况而定，如果无法使用，你可能还需要配置 proxy 项。

如果你有增减环境变量的需求，请参考官方文档。

如果你需要使用域名访问 Navidrome，这里提供一个简单的 Ng­inx 反向代理配置：

server {
    listen 80;
    server_name navidrome.you.domain;
    return 301 https://navidrome.you.domain$request_uri;
}

server {
    listen 443 ssl http2;
    server_name navidrome.you.domain;
    #SSL配置省略
    location / {
        proxy_pass http://navidrome:4533;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header X-Forwarded-Protocol $scheme;
        proxy_set_header X-Forwarded-Host $http_host;
        proxy_buffering off;
    }
    access_log /home/wwwlogs/navidrome.log;
}

使用

启动容器后，Navidrome 便可以直接使用了，几乎不需要其他额外的设置。

初次访问 IP:4533，Navidrome 会要求你先创建管理员账户。

因为环境变量中已经配置了默认语言，所以不用再修改用户语言，直接就是中文。

虽然 Navidrome 没有像 Plex 那样严格从 Mu­sicBrainz 中获取音乐数据，但你仍可以参考《MusicTagWeb：一款非常顺手的音乐刮削软件》为音乐在线添加 ID3­Tags 信息。

总之，只要你准备好音乐，Navidrome 就可以做到开箱即用。

这是专辑页

在安装 Navidrome 时配置的 Spo­tify 和 Last.fm，最终会让艺术家页可以显示头像和简介等相关信息。

即使你不配置 Last.fm 相关的环境变量，也可以在个性化设置中勾选「启用 Last.fm 的喜好记录」，通过 Last.fm 记录你听过的音乐。

在跳转的授权页面登录 Last.fm 账户，允许访问即可。Navidrome 中，每个用户都可以配置自己的 Last.fm。

只要网络没问题，几乎可以实时查看正在播放的音乐。

忘了介绍，这是 Navidrome 显示歌词的样子。目前只能显示内嵌歌词。

移动设备上是这样的。

音流

为了能让 Navidrome 变得稍微好用一点点，我的建议是使用第三方客户端。Navidrome 目前支持 Sub­sonic/​Mad­sonic/​Air­sonic 协议，市面上已经有许多 Sub­sonic/​Mad­sonic/​Air­sonic 的客户端，但它们都没有中文。而「音流」的出现，让中文用户多了一种选择。

「音流」是一款国人开发的音乐播放器，支持 Sub­sonic/​Navidrome/​Jel­lyfin/​Emby/​Au­dio­Sta­tion，现已登录 An­droid、iOS，未来可能支持 Win­dows 和 tvOS 平台。音流采用 Flut­ter 开发，界面简洁美观，整体以透明和高斯模糊为主，布局类似于网易云音乐，上手基本没有门槛。你可以在音流官网获取 An­droid 安装包，或直接在 iOS App Store 搜索「音流」下载。

这里不过多介绍音流的使用方法（真没什么好说的地方）。我们只要填入 Navidrome 地址、用户名和密码登录后，就可以进入音流首页。

如果你的音乐很多，那音流可能需要先扫描一会儿。

接着，你应该注意到了首页「主线路」这三个字。这是音流中最让我感到惊喜的功能，它支持主备线路切换

。也就是说，你可以主线路填内网地址，备用线路填外网地址。这样当你出门的时候，音流可以自动切换到外网地址上，而当你回到家中，又自动切换回内网。由于流媒体有缓存，切换网络的过程播放音乐不会中断。

音流的各方面都很像网易云。首页按最新专辑、每日推荐、最近播放、最常播放和随机专辑依次排列。其中，每日推荐是随机的五十首音乐。若是觉得这五十首不合现在的心情，还可以立刻刷新换一批，是个不错的功能。

歌词

群友告诉我说有一款开源的歌词 / 封面 API 程序「LrcApi」，可以直接用在音流上。

根据官方介绍，Lr­cApi 为音流量身打造。支持酷狗 / 聚合 API 获取 LRC 歌词，支持获取音乐 / 专辑 / 艺术家封面。安装倒也很简单，Com­pose 一把梭：

version: "3.9"
services:

  lyricapi:
    image: hisatri/lyricapi:latest
    container_name: lyricapi
    ports:
      - 28883:28883
    environment:
      - TZ=Asia/Shanghai
      # - API_AUTH=自定义一个鉴权key
    volumes:
      - /volume1/media/music:/music:ro #和Navidrome一致的音乐路径
    restart: unless-stopped

关于 volumes 挂载部分，如果你正在使用 Navidrome，可以将 Navidrome 的音乐路径映射到容器中，这样 Lr­cApi 可以直接使用你本地已存在的的 LRC 歌词。直接解决了 Navidrome 不能使用本地歌词的问题。

关于环境变量中 API_AUTH 的部分，如果你公开创建了 Lr­cApi 但是不想让别人白嫖，那么就可以填写这个环境变量，为 Lr­cApi 加上一个密码（header 鉴权），只有密码正确才能在音流中使用。

接着再配合 Ng­inx 反向代理。你可以把 Lr­cApi 放在 Navidrome 同一个 Ng­inx 配置里：

location /jsonapi {
    proxy_pass http://lyricapi:28883/jsonapi;
    proxy_http_version 1.1;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header Host $http_host;
}

这样，就可以直接通过你的 Navidrome 的链接加上 /jsonapi 来访问这个 API。

或者，你不喜欢用 /jsonapi 访问，只要将 location /jsonapi 中的 /jsonapi 改成你喜欢的就行了。比如改成 /lrc 。你就可以在音流中填写 https://navidrome.you.domain/lrc 来使用 Lr­cApi。

不过， Lr­cApi 目前还不支持获取带译文的歌词，希望后续能支持使用网易云音乐的歌词源。所以，有使用 Navidrome 的朋友，并且本地保存了不少 LRC 歌词的话，还是自建一个 Lr­cApi 效果会比较好。

就到这了，其余的功能就请诸位自行发现和体验吧！

参考

• Navidrome 官网

• 「音流」作者的博客

• Github 上的 LrcApi

---

1. 官方 Github 有个两年前的关于「支持外挂 LRC」的 issue，现在还打开着…… ↩

2. 音流线路自动切换在正式版中为付费功能。 ↩