私人云音乐平台 Navidrome 入门

本文最后更新于：2025年5月17日晚上

这是一个类似于 Spotify / Apple Music 的一款音乐播放软件，同时也能让你更简单的与朋友 / 家人分享你的歌曲和歌单, 本文介绍使用方法。

简介

私有化云音乐平台,有如下特点:

完全私有化部署，没有云服务参与，所有歌曲 / 歌单 / 播放历史都存在你本地。
完全的 Web 界面，你不需要下载任何客户端只需打开网页即可畅听你的音乐库。
完全开源免费，你可以在Navidrome GitHub 项目仓库看到所有源代码。
开放 API，支持自有协议和 Subsonic API，社区有许多精美的客户端可选择，比如 Windows 上就有能把各大厂商软件按在地上吊打的 feishin。

gtihub 链接: https://github.com/navidrome/navidrome/
官方 demo 链接: https://demo.navidrome.org/app/#/login

安装使用

官方文档: https://www.navidrome.org/docs/installation/

这里直接使用 docker 安装:

docker 安装文档: https://www.navidrome.org/docs/installation/docker/

Docker Compose 部署

示例 Compose 配置如下：

services:
  navidrome:
    image: deluan/navidrome:latest
    user: 1000:1000  # 运行用户UID:GID，你需要根据你的音乐库权限进行调整
    ports:
      - 4533:4533    # Web / API 访问端口
    restart: unless-stopped
    environment:
      # Navidrome 配置项，如何设置请参照末尾“拓展章节”里的“Navidrome 配置选项”
      - ND_LOGLEVEL=info
    volumes:
      - "/path/to/data:/data"  # Navidrome 数据保存路径
      - "/path/to/your/music/folder:/music:ro"  # 音乐库路径

如果你不想关心也不想配置 Navidrome 可用配置项，则可以直接参照我的 Docker Compose 按需调整：

services:
  navidrome:
    environment:
      - TZ=Asia/Shanghai
      - ND_LOGLEVEL=info
      - ND_DEFAULTLANGUAGE=zh-Hans       # 默认语言改为中文
      - ND_ENABLECOVERANIMATION=true    # 禁用 Web 界面播放音乐时的封面旋转动画，没什么必要
      - ND_ENABLEDOWNLOADS=true         # 禁用 Web 界面下载音乐的功能
      - ND_ENABLEEXTERNALSERVICES=false  # 禁用外部集成，即使启用你也需要魔法才能用
      - ND_ENABLEGRAVATAR=false    # 禁用 Gravatar 头像集成
      - ND_ENABLEREPLAYGAIN=false  # 禁用 Web 界面调整回放增益的功能
      - ND_ENABLESHARING=false     # 禁用分享功能，如果你需要分享给别人可以打开
      - ND_ENABLESTARRATING=false  # 禁用 Web 界面的五星评级歌曲功能
      - ND_ENABLETRANSCODINGCONFIG=false  # 禁用从 Web 界面调整转码配置的功能
      - ND_ENABLEUSEREDITING=false        # 禁止普通用户更改自身信息与登录凭据，安全考量
      - ND_LASTFM_ENABLED=false           # 禁用 Last.fm 集成
      - ND_LISTENBRAINZ_ENABLED=false     # 禁用 ListenBrainZ 元数据库集成
      - ND_MAXSIDEBARPLAYLISTS=300        # 调整侧边最多显示的播放列表数为 300（默认 100）
      - ND_PASSWORDENCRYPTIONKEY=USE_YOUR_OWN_KEY  # 加密密钥，自己随机按一串字符串来用，一定要换成你自己的！！！
      - ND_SCANNER_GROUPALBUMRELEASES=true         # 禁用按照日期区分专辑，防止 Navidrome 错误的按照日期从专辑中拆分单曲
    image: deluan/navidrome:latest
    container_name: navidrome
    ports:
      - 4533:4533
    restart: unless-stopped
    volumes:
      - /opt/nfs/navidrome/data:/data
      - /opt/nfs/music/MitsuhaYuki:/music:ro  # 注意音乐文件夹是ro即只读的，Navidrome 不需要也不会对你的音乐库实际文件进行任何修改操作

之后进行 nginx 反向代理

server {
    listen       6666 ssl;
    listen  [::]:6666 ssl;
    # server_name localhost;

    ssl_certificate     /etc/nginx/certificates/cert-jkmvn8zoe6xrg5dz/fullchain.cer;
    ssl_certificate_key /etc/nginx/certificates/cert-jkmvn8zoe6xrg5dz/cert.key;


    location / {
                    proxy_set_header    X-FORWARDED-FOR $remote_addr;
                    proxy_set_header    X-FORWARDED-PROTO $scheme;
                    proxy_set_header    Host   $http_host;
                    proxy_pass          http://192.168.65.41:4533;
    }
}