Loading... ### 使用 Docker 在 Linux 上搭建 Navidrome 音乐库 Navidrome 是一款轻量级的、自托管的音乐服务器,兼容 Subsonic API,可以通过网页或移动端应用访问和播放音乐。在 Linux 环境下,使用 Docker 部署 Navidrome 是一种简单而有效的方式。本文将详细介绍如何使用 Docker 在 Linux 上搭建 Navidrome 音乐库。 #### 一、准备工作 在开始之前,请确保您的系统已经安装了 Docker。如果没有安装 Docker,可以通过以下步骤进行安装: ##### 1. 更新系统包列表 ```bash sudo apt update ``` - **解释**:更新系统包列表,确保可以获取最新的软件包版本。 ##### 2. 安装 Docker ```bash sudo apt install docker.io -y ``` - **解释**:安装 Docker 社区版。 ##### 3. 启动并启用 Docker 服务 ```bash sudo systemctl start docker sudo systemctl enable docker ``` - **解释**:启动 Docker 服务并设置为开机自启。 #### 二、拉取 Navidrome Docker 镜像 使用 Docker 拉取最新的 Navidrome 镜像: ```bash sudo docker pull deluan/navidrome:latest ``` - **解释**:拉取 Navidrome 的官方 Docker 镜像,这个镜像包含了 Navidrome 运行所需的所有依赖。 #### 三、设置音乐库目录 在运行 Navidrome 容器之前,首先需要设置一个目录来存放音乐文件。假设我们将音乐库存放在 `/home/user/music` 目录中。 ```bash mkdir -p /home/user/music ``` - **解释**:创建存放音乐文件的目录。 #### 四、运行 Navidrome 容器 使用以下命令运行 Navidrome 容器: ```bash sudo docker run -d \ --name=navidrome \ -p 4533:4533 \ -v /home/user/music:/music:ro \ -v /home/user/navidrome:/data \ deluan/navidrome ``` - **解释**: - `-d`:在后台运行容器。 - `--name=navidrome`:指定容器名称为 `navidrome`。 - `-p 4533:4533`:将主机的 4533 端口映射到容器的 4533 端口,这个端口用于访问 Navidrome 的 Web 界面。 - `-v /home/user/music:/music:ro`:将主机上的音乐库目录 `/home/user/music` 挂载到容器的 `/music` 目录,并设置为只读模式。 - `-v /home/user/navidrome:/data`:将主机上的 `/home/user/navidrome` 目录挂载到容器的 `/data` 目录,用于存储 Navidrome 的数据库和配置文件。 - `deluan/navidrome`:指定使用的 Docker 镜像。 #### 五、配置与访问 Navidrome Navidrome 容器启动后,您可以通过浏览器访问 `http://<你的服务器IP>:4533` 来使用 Navidrome 的 Web 界面。在首次访问时,您需要设置一个管理员账户并配置相关选项。 ##### 1. 配置音乐库路径 在 Web 界面中,导航至设置页面,确认音乐库路径是否正确(应该指向 `/music` 目录)。Navidrome 会自动扫描该目录下的音乐文件并将其添加到音乐库中。 ##### 2. 设置自动扫描 在设置页面,您可以配置 Navidrome 自动扫描音乐库的频率,确保每次添加新音乐文件后,Navidrome 都能及时更新库内容。 #### 六、管理和维护 Navidrome ##### 1. 查看运行状态 使用以下命令查看 Navidrome 容器的运行状态: ```bash sudo docker ps -f name=navidrome ``` - **解释**:过滤显示名为 `navidrome` 的容器状态。 ##### 2. 停止和启动容器 如果需要停止或重新启动 Navidrome 容器,可以使用以下命令: ```bash sudo docker stop navidrome sudo docker start navidrome ``` - **解释**: - `stop`:停止正在运行的容器。 - `start`:启动已停止的容器。 ##### 3. 更新 Navidrome 要更新 Navidrome,只需拉取最新的 Docker 镜像并重新运行容器: ```bash sudo docker pull deluan/navidrome:latest sudo docker stop navidrome sudo docker rm navidrome sudo docker run -d \ --name=navidrome \ -p 4533:4533 \ -v /home/user/music:/music:ro \ -v /home/user/navidrome:/data \ deluan/navidrome ``` - **解释**: - `rm navidrome`:删除旧的 Navidrome 容器。 - 然后重新运行新的容器实例。 #### 七、常见问题与解决 1. **端口冲突**:如果 4533 端口被占用,可以修改 `-p` 参数来映射到其他可用端口,例如 `-p 8080:4533`。 2. **权限问题**:确保 Docker 容器有权访问挂载的目录。如果出现权限问题,可以通过修改目录权限或使用 `sudo` 运行 Docker 命令来解决。 3. **音乐库未加载**:如果 Navidrome 没有加载音乐库,检查挂载路径是否正确,并确保音乐文件格式受支持。 #### 原理解释表 | 步骤 | 解释 | | ---------------- | --------------------------------------------------- | | 拉取 Docker 镜像 | 从 Docker Hub 拉取 Navidrome 镜像 | | 创建音乐库目录 | 在主机上设置存放音乐文件的目录 | | 运行容器 | 启动 Navidrome 容器,挂载音乐库目录 | | 访问和配置 | 通过浏览器访问 Navidrome,进行初始配置 | | 管理和更新 | 通过 Docker 命令管理 Navidrome 容器的运行状态和更新 | ### 结论 通过本文的指导,您可以在 Linux 系统上使用 Docker 容器轻松搭建和管理 Navidrome 音乐库。通过这种方式,您不仅能灵活管理音乐文件,还能随时更新和扩展音乐库服务。合理配置和维护 Docker 容器,将确保 Navidrome 的高效稳定运行,为用户提供流畅的音乐体验。 最后修改:2024 年 09 月 04 日 © 允许规范转载 打赏 赞赏作者 支付宝微信 赞 如果觉得我的文章对你有用,请随意赞赏