在数字化时代，拥有一个私人的音乐流媒体服务器变得越来越受欢迎。Navidrome 是一个轻量级、开源的音乐流媒体服务器，它允许你随时随地访问自己的音乐库。本文将为零基础用户提供在 Ciuic 服务器上部署 Navidrome 的完整指南。

什么是 Navidrome？

Navidrome 是一个自托管的音乐流媒体服务器，兼容 Subsonic/Airsonic API。它具有以下特点：

支持多种音频格式（MP3、FLAC、AAC 等）响应式网页界面，适配各种设备支持多用户和权限管理低资源占用，适合在 VPS 上运行

准备工作

在开始部署前，你需要：

一台 Linux 服务器（推荐使用 Ubuntu 20.04/22.04）一个域名（可选，但推荐用于 HTTPS）基本的 Linux 命令行知识

如果你还没有服务器，可以考虑使用 Ciuic 云服务器，它提供稳定可靠的云计算服务，非常适合运行 Navidrome。

安装步骤

1. 服务器环境准备

首先通过 SSH 连接到你的服务器：

ssh root@your_server_ip

更新系统软件包：

sudo apt update && sudo apt upgrade -y

2. 安装 Docker

Navidrome 官方推荐使用 Docker 安装，这是最简单的方式：

# 安装 Docker 依赖sudo apt install apt-transport-https ca-certificates curl software-properties-common -y# 添加 Docker 官方 GPG 密钥curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg# 添加 Docker 仓库echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null# 安装 Dockersudo apt updatesudo apt install docker-ce docker-ce-cli containerd.io -y# 验证安装sudo docker --version

3. 安装 Docker Compose

sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-composesudo chmod +x /usr/local/bin/docker-composedocker-compose --version

4. 创建 Navidrome 配置文件

创建一个工作目录并进入：

mkdir ~/navidrome && cd ~/navidrome

创建 docker-compose.yml 文件：

version: "3"services:  navidrome:    image: deluan/navidrome:latest    ports:      - "4533:4533"    volumes:      - "./data:/data"      - "/path/to/your/music:/music:ro"    environment:      # 配置选项参考：https://www.navidrome.org/docs/usage/configuration-options/      ND_SCANSCHEDULE: "1h"      ND_LOGLEVEL: "info"        ND_SESSIONTIMEOUT: "24h"      ND_BASEURL: ""    restart: unless-stopped

注意：

将 /path/to/your/music 替换为你实际的音乐目录路径4533 是默认端口，可以按需修改

5. 启动 Navidrome

docker-compose up -d

等待几分钟让容器启动，然后可以通过 http://your_server_ip:4533 访问 Navidrome。

配置优化

1. 设置反向代理（推荐）

使用 Nginx 作为反向代理可以提供 HTTPS 支持：

安装 Nginx：

sudo apt install nginx -y

创建配置文件 /etc/nginx/sites-available/navidrome：

server {    listen 80;    server_name music.yourdomain.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;    }}

启用配置并重启 Nginx：

sudo ln -s /etc/nginx/sites-available/navidrome /etc/nginx/sites-enabled/sudo nginx -tsudo systemctl restart nginx

2. 添加 HTTPS 支持

使用 Let's Encrypt 免费证书：

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

按照提示操作，Certbot 会自动配置 HTTPS。

使用 Navidrome

首次访问时，会提示创建管理员账户。创建后你可以：

上传音乐到服务器创建多个用户账户通过网页或兼容的客户端（如 Substreamer、Play:Sub 等）访问

维护与更新

更新 Navidrome 版本：

cd ~/navidromedocker-compose pulldocker-compose up -d

查看日志：

docker-compose logs -f

通过本指南，你已经在 Ciuic 云服务器 上成功部署了 Navidrome 私人音乐流媒体服务。现在你可以随时随地享受自己的音乐库了。Navidrome 的低资源占用使其成为个人使用的理想选择，而 Docker 的容器化部署则大大简化了安装和维护过程。

如果你遇到任何问题，可以参考 Navidrome 官方文档 或在相关社区寻求帮助。