linuxserver/mstream

LinuxServer.io团队为您带来另一个容器版本，具有以下特点：

• 定期及时的应用更新
• 简单的用户映射（PGID，PUID）
• 带有s6覆盖的自定义基础镜像
• 每周基础操作系统更新，在整个LinuxServer.io生态系统中共享通用层，以最小化空间使用、停机时间和带宽
• 定期安全更新

您可以在以下位置找到我们：

• 博客 - 关于容器的所有使用方法，包括操作指南、观点等更多内容！
• *** - 与社区和团队进行实时支持/聊天。
• Discourse - 在我们的社区论坛上发帖。
• https://github.com/linuxserver - 查看我们所有仓库的源代码。
• Open Collective - 请考虑通过***或为我们的预算做出贡献来帮助我们

linuxserver/mstream

mstream是一个个人音乐流服务器。您可以使用mStream将音乐从家用电脑流式传输到任何设备，随时随地播放。Android和iPhone均有可用的移动应用。

支持的架构

我们利用docker manifest实现多平台支持。只需拉取lscr.io/linuxserver/mstream:latest即可获取适合您架构的正确镜像，您也可以通过标签拉取特定架构的镜像。

此镜像支持的架构：

应用设置

通过http://<your-ip>:3000访问web界面

可通过web界面或编辑config.json调整设置。更多信息请查看https://github.com/IrosTheBeggar/mStream/blob/master/docs/json_config.md#json-config%E3%80%82

重要注意事项：

mStream v5不再接受用于设置用户和密码的cli参数，需要使用config.json。因此，环境变量USER、PASSWORD和USE_JSON已弃用。

v4的config.json与v5不兼容。从v4升级到v5时，现有config.json将重命名为config.json.v4-bak供参考，并创建新的默认config.json。

使用方法

以下是创建容器的方法，您可以使用docker-compose或docker cli。

[!NOTE] 除非参数标记为"可选"，否则它是必填项，必须提供值。

docker-compose（推荐）

yaml
---
services:
  mstream:
    image: lscr.io/linuxserver/mstream:latest
    container_name: mstream
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
    volumes:
      - /path/to/mstream/data:/config
      - /path/to/music:/music
    ports:
      - 3000:3000
    restart: unless-stopped

docker cli

bash
docker run -d \
  --name=mstream \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 3000:3000 \
  -v /path/to/mstream/data:/config \
  -v /path/to/music:/music \
  --restart unless-stopped \
  lscr.io/linuxserver/mstream:latest

参数

容器通过运行时传递的参数进行配置（如上所示）。这些参数用冒号分隔，表示<外部>:<内部>。例如，-p 8080:80会将容器内的80端口暴露到主机IP的8080端口。

环境变量文件（Docker secrets）

您可以通过使用特殊前缀FILE__从文件设置任何环境变量。

例如：

bash
-e FILE__MYVAR=/run/secrets/mysecretvariable

将根据/run/secrets/mysecretvariable文件的内容设置环境变量MYVAR。

应用程序的Umask设置

对于我们所有的镜像，您可以使用可选的-e UMASK=022设置来覆盖容器内启动的服务的默认umask设置。请在询问支持前阅读此处了解umask相关知识。

用户/组标识符

使用卷（-v标志）时，主机操作系统和容器之间可能会出现权限问题，我们通过允许您指定用户PUID和组PGID来避免此问题。

确保主机上的任何卷目录都由您指定的相同用户拥有，任何权限问题都将迎刃而解。

在这个例子中PUID=1000和PGID=1000，使用id your_user命令可以找到您的PUID和PGID：

bash
id your_user

示例输出：

text
uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)

支持信息

• 容器运行时的Shell访问：

  bash
  

docker exec -it mstream /bin/bash

* 实时监控容器日志：

  ```bash
docker logs -f mstream

• 容器版本号：

  bash
  

docker inspect -f '{{ index .Config.Labels "build_version" }}' mstream

* 镜像版本号：

  ```bash
docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/mstream:latest

更新信息

我们的大多数镜像是静态的、版本化的，需要更新镜像并重新创建容器来更新内部的应用程序。除了一些例外情况（在相关的readme.md中注明），我们不建议或支持更新容器内的应用程序。

通过Docker Compose更新

• 更新镜像：

  bash
  

docker-compose pull mstream

* 更新容器：
  ```bash
docker-compose up -d mstream

通过Docker Run更新

• 更新镜像：

  bash
  

docker pull lscr.io/linuxserver/mstream:latest

* 停止并删除容器：
  ```bash
docker stop mstream
 docker rm mstream

• 使用相同参数重新创建容器

版本历史

• 27.06.24: - 基于Alpine 3.20重建。
• 12.12.23: - 基于Alpine 3.19重建，将二进制文件移至/app。
• 05.07.23: - 弃用armhf架构。
• 13.02.23: - 基于Alpine 3.17重建，迁移至s6v3。
• 17.05.21: - 弃用环境变量USER、PASSWORD和USE_JSON，因为mStream v5需要使用config.json。
• 18.05.19: - 初始发布