什么是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:免费开源,界面简洁
连接步骤
- 打开音乐应用
- 点击"添加服务"或"设置"
- 填写服务器地址:https://your-domain.com
- 填写用户名和密码
- 点击"连接"测试
- 成功后就可以开始享受专属的云音乐了!

总结
通过本教程,你已经成功搭建了自己的云音乐平台Navidrome。这个平台可以让你:
- 💾 安全存储音乐:无需依赖第三方云盘
- 📱 随时随地访问:只要有网络就可以听音乐
- ⏱️ 串流播放:可根据网络带宽自动调整码率
- 🖥️ 管理方便:Web界面直接操作
- 🎙️ 音质保持:支持高清音频格式
记住,定期备份你的音乐文件,并且在使用过程中多测试不同的播放器,找到最适合你的那个。音乐文件请只放自己拥有版权的曲目。
如果在配置过程中遇到问题,可以检查:Docker服务状态、网络连接、权限设置、SSL证书配置等。
相关推荐:服务器配置完全手册:新手必学的10个基础设置,帮助你更好地管理服务器环境。

