Navidrome 搭建教程（小白向）

Navidrome 是一款轻量级、开源的音乐服务器，支持通过浏览器或第三方客户端（如 Substreamer、Symfonium）在任何设备上播放你的音乐库。本教程适合零基础用户，跟着一步步来即可完成搭建。

前置准备

在开始之前，你需要准备以下东西：

一台 Linux 服务器
服务器的 root 或 sudo 权限
已上传到服务器的音乐文件（或知道音乐文件夹路径）
基础的 SSH 连接能力（会用终端连服务器即可）

使用 Docker 安装（推荐新手）

Docker 是目前最简单的部署方式，不用担心环境依赖问题。

第一步：安装 Docker

# 更新软件包列表
sudo apt update

# 安装 Docker
bash <(curl -sL 'https://get.docker.com')

# 验证安装是否成功
docker --version

第二步：创建必要的文件夹

# 创建 Navidrome 的配置目录和音乐目录
mkdir -p ~/navidrome/data
mkdir -p ~/music

📁 把你的音乐文件上传到 ~/music 目录下，支持 MP3、FLAC、AAC 等常见格式。

第三步：运行 Navidrome 容器

docker run -d \
  --name navidrome \
  --restart=unless-stopped \
  -v ~/music:/music \
  -v ~/navidrome/data:/data \
  -p 4533:4533 \
  deluan/navidrome:latest

参数说明：

参数	说明
`-d`	后台运行容器
`--restart=unless-stopped`	服务器重启后自动启动
`-v ~/music:/music`	将本地音乐目录挂载到容器内
`-v ~/navidrome/data:/data`	持久化配置和数据库
`-p 4533:4533`	将容器的 4533 端口映射到主机

第四步：访问 Navidrome

打开浏览器，访问：

http://你的服务器IP:4533

首次访问会提示你创建管理员账号，填写用户名和密码后即可进入。

开放防火墙端口（重要）

如果你的服务器有防火墙，需要开放 4533 端口：

# 使用 ufw 防火墙
sudo ufw allow 4533/tcp
sudo ufw reload

如果你用的是云服务器（阿里云、腾讯云、Vultr 等），还需要在控制台的安全组 / 防火墙规则中手动添加入站规则，放行 TCP 4533 端口。

配置反向代理（可选，推荐）

直接用 IP+端口访问不够优雅，可以用 Nginx 配置域名访问。

安装 Nginx

sudo apt install -y nginx

配置站点

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

粘贴以下内容（将 music.yourdomain.com 替换为你的域名）：

server {
    listen 80;
    server_name music.yourdomain.com;

    location / {
        proxy_pass         http://127.0.0.1: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;
    }
}

启用配置

sudo ln -s /etc/nginx/sites-available/navidrome /etc/nginx/sites-enabled/
sudo nginx -t        # 检查配置是否正确
sudo systemctl reload nginx

之后就可以通过 http://music.yourdomain.com 访问了。

申请 HTTPS 证书（可选，强烈推荐）

使用 Certbot 免费申请 SSL 证书，让访问更安全：

sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d music.yourdomain.com

按提示输入邮箱，同意条款，Certbot 会自动完成 HTTPS 配置。

客户端推荐

搭建完成后，可以用以下客户端连接（均支持 Subsonic API）：

平台	推荐客户端
iOS	Substreamer、Amperfy
Android	音流
网页端	直接访问 Navidrome 自带 Web UI

连接时填写：

服务器地址：http://你的IP:4533 或域名
用户名 / 密码：你创建的账号

常见问题

Q：音乐不显示怎么办？
A：进入 Web UI 后，点击右上角头像 → 扫描媒体库，等待扫描完成即可。

Q：Docker 容器挂了怎么重启？

docker restart navidrome

Q：怎么查看 Docker 日志排查问题？

docker logs navidrome

Q：忘记管理员密码怎么办？

# Docker 版本
docker exec -it navidrome navidrome --configfile /data/navidrome.toml --debug resetpassword 用户名

总结

步骤	完成了吗？
安装 Docker 或下载二进制	☐
上传音乐文件到服务器	☐
启动 Navidrome 服务	☐
开放防火墙端口 4533	☐
浏览器访问并创建账号	☐
（可选）配置域名和 HTTPS	☐

按照本教程操作，你就拥有了一个完全属于自己的私人音乐流媒体服务器。享受你的音乐吧！🎵