mStream多平台部署实战：Docker、树莓派、云服务器完整教程

mStream多平台部署实战：Docker、树莓派、云服务器完整教程

【免费下载链接】mStreamThe easiest music streaming server available项目地址: https://gitcode.com/gh_mirrors/ms/mStream

mStream是一款简单易用的个人音乐流媒体服务器，让你能够将家中电脑的音乐库流式传输到任何设备，随时随地享受音乐。本教程将详细介绍如何在Docker、树莓派和云服务器上部署mStream，帮助你快速搭建属于自己的音乐流媒体服务。

mStream简介：打造你的私人音乐云

mStream作为一款轻量级音乐流媒体服务器，具有安装简单、资源占用低、跨平台支持等特点。通过mStream，你可以轻松管理和访问自己的音乐收藏，支持多种设备同时连接，提供流畅的音乐播放体验。

图：mStream支持在电脑、平板和手机等多种设备上同步播放音乐，实现无缝的音乐体验。

准备工作：部署前的必要准备

在开始部署mStream之前，需要确保你的系统满足以下要求：

• NodeJS和NPM环境
• Git版本控制工具
• 至少100MB的可用存储空间
• 稳定的网络连接

对于不同的部署平台，可能还需要额外的依赖项，我们将在后续章节中详细介绍。

Docker快速部署：最简单的安装方式

Docker是部署mStream的推荐方式，它可以让你在任何支持Docker的系统上快速安装和运行mStream，无需担心依赖问题。

Docker安装步骤

1. 首先，确保你的系统已经安装了Docker。如果没有安装，可以参考Docker官方文档进行安装。

2. 使用以下命令拉取mStream的Docker镜像：

docker pull linuxserver/mstream

3. 创建并运行mStream容器：

docker run -d \ --name=mstream \ -p 3000:3000 \ -v /path/to/your/music:/music \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Europe/London \ --restart unless-stopped \ linuxserver/mstream

注意：将/path/to/your/music替换为你本地音乐文件夹的路径。

4. 容器启动后，你可以通过访问http://localhost:3000来打开mStream的Web界面。

Docker部署优势

• 安装简单，无需手动解决依赖问题
• 容器化运行，不会影响系统其他组件
• 易于升级和维护
• 跨平台支持，在Windows、macOS和Linux上都能运行

树莓派部署：打造低功耗音乐服务器

树莓派是部署mStream的理想选择，它体积小、功耗低，可以24小时不间断运行，非常适合作为家庭音乐服务器。

树莓派系统准备

1. 确保你的树莓派已经安装了Raspbian操作系统。
2. 更新系统并安装必要的依赖：

sudo apt update sudo apt upgrade -y sudo apt install -y nodejs npm git

在树莓派上安装mStream

1. 克隆mStream仓库：

git clone https://gitcode.com/gh_mirrors/ms/mStream

2. 进入mStream目录并安装依赖：

cd mStream npm install --only=prod

3. 运行mStream安装向导：

npm run-script wizard

4. 按照向导提示进行配置，包括设置管理员账户、添加音乐文件夹等。

配置树莓派自动启动mStream

为了让mStream在树莓派启动时自动运行，我们可以使用PM2进程管理工具：

1. 安装PM2：

sudo npm install -g pm2

2. 使用PM2启动mStream：

pm2 start cli-boot-wrapper.js --name mStream

3. 设置PM2开机自启：

pm2 startup pm2 save

现在，即使树莓派重启，mStream也会自动启动。

云服务器部署：实现远程访问

将mStream部署在云服务器上，可以让你随时随地访问自己的音乐库，不受家庭网络的限制。

云服务器环境准备

以Ubuntu系统为例，首先需要安装必要的依赖：

sudo apt update sudo apt install -y nodejs npm git

安装mStream

1. 克隆mStream仓库：

git clone https://gitcode.com/gh_mirrors/ms/mStream

2. 进入mStream目录并安装依赖：

cd mStream npm install --only=prod

3. 运行mStream安装向导：

npm run-script wizard

配置SSL加密

为了保证数据传输的安全，建议为云服务器上的mStream配置SSL加密。mStream内置了SSL支持，你只需要准备好SSL证书并在配置文件中进行设置：

1. 编辑配置文件save/conf/default.conf：

{ "ssl": { "key": "/path/to/your/key.pem", "cert": "/path/to/your/cert.pem" } }

2. 重启mStream使配置生效：

pm2 restart mStream

配置防火墙

为了允许外部访问mStream，需要在云服务器的防火墙上开放3000端口（或你在配置中设置的其他端口）。

以Ubuntu的ufw防火墙为例：

sudo ufw allow 3000/tcp sudo ufw reload

mStream配置详解：打造个性化音乐服务

mStream提供了丰富的配置选项，可以根据你的需求进行个性化设置。主要的配置文件位于save/conf/default.conf，你也可以通过-j参数指定自定义的配置文件：

mstream -j /path/to/your/config.json

主要配置选项

1. 端口设置：默认端口为3000，你可以根据需要修改：

{ "port": 8080 }

2. 音乐文件夹设置：添加多个音乐文件夹并为其命名：

{ "folders": { "rock": { "root": "/media/music/rock" }, "jazz": { "root": "/media/music/jazz" } } }

3. 用户管理：设置多个用户并分配不同的音乐文件夹访问权限：

{ "users": { "alice": { "password": "hashed_password", "salt": "your_salt", "vpaths": ["rock", "jazz"] }, "bob": { "password": "hashed_password", "salt": "your_salt", "vpaths": ["jazz"] } } }

4. 转码设置：配置音频转码参数，以适应不同的网络环境：

{ "transcode": { "enabled": true, "defaultCodec": "opus", "defaultBitrate": "128k" } }

图：mStream的管理界面，可以方便地配置扫描设置、管理共享播放列表等。

mStream使用指南：开始你的音乐之旅

部署完成后，通过浏览器访问mStream的Web界面，你就可以开始使用这个强大的音乐流媒体服务了。

主要功能介绍

1. 音乐库管理：mStream会自动扫描并整理你的音乐文件，按艺术家、专辑、歌曲等分类展示。

2. 播放列表：创建和管理个性化播放列表，支持导入和导出M3U格式的播放列表。

3. 共享功能：生成共享链接，让朋友可以访问你的音乐库。

4. 转码播放：根据网络状况自动调整音频质量，确保流畅播放。

图：mStream的主界面，展示了文件浏览器和当前播放列表，界面简洁直观。

移动设备访问

mStream没有专门的移动应用，但你可以通过移动设备的浏览器访问mStream的Web界面，同样可以获得良好的使用体验。界面会自动适应移动设备的屏幕尺寸，提供触控友好的操作方式。

常见问题解决：部署和使用中的技巧

如何更新mStream？

使用Git可以轻松更新mStream到最新版本：

cd mStream git pull npm install --only=prod pm2 restart mStream

如何迁移mStream数据？

mStream的所有数据（包括数据库、配置文件等）都保存在save目录下。要迁移数据，只需将整个save目录复制到新的安装位置即可。

如何解决音乐文件无法扫描的问题？

如果mStream无法扫描某些音乐文件，可能是由于文件权限问题。确保mStream进程有权限访问你的音乐文件夹：

chmod -R 755 /path/to/your/music

总结：打造属于你的音乐流媒体服务

通过本教程，你已经了解了如何在Docker、树莓派和云服务器上部署mStream。无论你是想在家中搭建一个低功耗的音乐服务器，还是希望随时随地访问自己的音乐库，mStream都是一个简单而强大的选择。

现在，你可以开始整理自己的音乐收藏，享受mStream带来的便捷音乐体验了！如果你在使用过程中遇到任何问题，可以查阅官方文档或在社区寻求帮助。

官方文档：docs/ 配置文件示例：docs/json_config.md

【免费下载链接】mStreamThe easiest music streaming server available项目地址: https://gitcode.com/gh_mirrors/ms/mStream