Navidrome云音乐教程题图:云端音乐串流

免费搭建自己的云音乐平台:Navidrome 完整教程

什么是Navidrome

Navidrome是一款开源的云音乐服务器,可以让你在任何设备上搭建专属的云音乐平台。它支持标准的Subsonic API,意味着你可以使用各种音乐播放器和移动应用来访问你的音乐库。

Navidrome的主要特色:

  • 🔒 开源免费:基于开源许可发布,个人自用无需支付软件许可费
  • 📺 Web管理界面:直接通过浏览器管理音乐库
  • 🎙️ 多种格式支持:MP3、FLAC、OGG、AAC等
  • 📱 移动端支持:支持iOS、Android、Web多端
  • ⏱️ 自动转码:可根据网络带宽自动调整串流码率
  • 💾 安全存储:支持数据库连接和文件存储
云音乐平台网页界面示意

安装准备

在开始之前,请确保你已经准备好了以下环境:

  • ✅ VPS服务器(建议2GB RAM以上)
  • ✅ Ubuntu 22.04/24.04 或 Debian 12 系统(CentOS 7/8 已停止维护,不再建议使用)
  • ✅ 有效的域名或IP地址
  • ✅ 已经安装了Nginx或Apache
  • ✅ 已经配置好SSL证书

第一步:更新系统

首先更新系统并安装必要的软件包:

# Ubuntu/Debian
sudo apt update && sudo apt upgrade -y
sudo apt install curl wget unzip -y

# Rocky Linux/AlmaLinux
sudo dnf update -y
sudo dnf install curl wget unzip -y

第二步:下载Navidrome

我们将使用Docker方式来安装Navidrome,这是最简单和安全的方法。

# 安装Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker $USER

# 新版Docker已内置Compose插件,验证版本
docker compose version
服务器上安装软件的终端界面示意

Navidrome配置

创建配置文件

首先创建一个专门用于存放Navidrome相关文件的目录:

mkdir -p ~/navidrome/data
mkdir -p ~/navidrome/music
mkdir -p ~/navidrome/config

# 创建docker-compose.yml文件
cat > ~/navidrome/docker-compose.yml << 'EOF'
version: '3'
services:
  navidrome:
    image: deluan/navidrome:latest
    container_name: navidrome
    user: 1000:1000
    ports:
      - "4533:4533"
    environment:
      - ND_SCANSCHEDULE=1h
      - ND_LOGLEVEL=info
      - ND_SESSIONTIMEOUT=24h
      - ND_BASEURL=""
    volumes:
      - "./data:/data"
      - "./music:/music:ro"
    restart: unless-stopped
EOF

放入音乐文件

将你的音乐文件放置到music目录中:

# 下载测试音乐文件(选填)
cd ~/navidrome/music
wget -O sample.mp3 "https://www.soundhelix.com/examples/mp3/SoundHelix-Song-1.mp3"

# 或者拷贝你自己的音乐文件到该目录
# cp /path/to/your/music/* ~/navidrome/music/

# 设置正确的权限
chmod -R 755 ~/navidrome/music
chown -R 1000:1000 ~/navidrome/music

启动Navidrome

使用Docker Compose启动Navidrome服务:

cd ~/navidrome
docker compose up -d

# 查看服务状态
docker compose ps

# 查看日志
docker compose logs -f

开始初始化:

# 浏览器访问 http://your-domain.com:4533 或 http://your-ip:4533
# Navidrome没有默认账号:首次打开页面时按提示创建第一个用户,该用户即为管理员
# 创建完成后妥善保管密码,不要使用弱口令
服务器端配置代码界面示意

设置Nginx反向代理

为了提高安全性和便捷性,我们建议使用Nginx作为反向代理,并配置SSL证书。

编辑Nginx配置

sudo nano /etc/nginx/sites-available/navidrome

添加以下配置

server {
    listen 80;
    server_name your-domain.com;

    location / {
        proxy_pass http://localhost: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_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

启用配置

sudo ln -s /etc/nginx/sites-available/navidrome /etc/nginx/sites-enabled/
sudo nginx -t  # 测试配置
sudo systemctl reload nginx  # 重启Nginx

添加SSL证书

# 使用Certbot添加SSL
sudo certbot --nginx -d your-domain.com

# 或者手动配置SSL证书
sudo nano /etc/nginx/sites-available/navidrome

移动端连接

Navidrome支持Subsonic API,所以你可以使用任何支持Subsonic的播放器来连接。

iOS移动端

  • Substreamer:App Store免费,界面美观
  • iSub:支持Subsonic,免费
  • Play:Sub:高级版本,但功能强大

Android移动端

  • DSub:开源免费,功能完整
  • Symfonium:新型播放器,支持Subsonic
  • Ultrasonic:免费开源,界面简洁

连接步骤

  1. 打开音乐应用
  2. 点击"添加服务"或"设置"
  3. 填写服务器地址:https://your-domain.com
  4. 填写用户名和密码
  5. 点击"连接"测试
  6. 成功后就可以开始享受专属的云音乐了!
手机端音乐播放界面示意

总结

通过本教程,你已经成功搭建了自己的云音乐平台Navidrome。这个平台可以让你:

  • 💾 安全存储音乐:无需依赖第三方云盘
  • 📱 随时随地访问:只要有网络就可以听音乐
  • ⏱️ 串流播放:可根据网络带宽自动调整码率
  • 🖥️ 管理方便:Web界面直接操作
  • 🎙️ 音质保持:支持高清音频格式

记住,定期备份你的音乐文件,并且在使用过程中多测试不同的播放器,找到最适合你的那个。音乐文件请只放自己拥有版权的曲目。

如果在配置过程中遇到问题,可以检查:Docker服务状态、网络连接、权限设置、SSL证书配置等。

相关推荐:服务器配置完全手册:新手必学的10个基础设置,帮助你更好地管理服务器环境。

Scroll to Top