shiomax/jrivermc30

JRiver Media Center - Docker

重要提示
现有新镜像https://hub.docker.com/r/shiomax/jrivermc%E5%8F%AF%E6%9C%89%E6%95%88%E6%9B%BF%E4%BB%A3%E6%9C%AC%E9%95%9C%E5%83%8F%E3%80%82%E6%96%B0%E5%AE%89%E8%A3%85%E5%BB%BA%E8%AE%AE%E7%AB%8B%E5%8D%B3%E4%BD%BF%E7%94%A8%E6%96%B0%E9%95%9C%E5%83%8F%EF%BC%8C%E6%9C%AC%E9%95%9C%E5%83%8F%E6%9C%80%E7%BB%88%E5%8F%AF%E8%83%BD%E5%81%9C%E6%AD%A2%E7%BB%B4%E6%8A%A4/%E6%9E%84%E5%BB%BA%E3%80%82

镜像概述和主要用途

这是JRiver Media Center的社区构建Docker镜像，基于https://github.com/jlesage/docker-baseimage-gui%E3%80%82%E6%BA%90%E4%BB%A3%E7%A0%81%E6%89%98%E7%AE%A1%E4%BA%8EGitLab%E3%80%82
主要用途是作为中央“无头”JRiver服务器，供其他JRiver实例流媒体播放音乐。容器内直接音乐播放需主机运行alsa（详见“声音”部分）。

Dockerhub仓库信息

截图

!screenshot

使用方法

网络模式说明

推荐使用host网络，除非需要修改端口映射（部分端口可能被主机占用）。若使用bridge网络，需注意：

• 必须定义自定义MAC地址，否则JRiver许可证可能因MAC地址变化频繁激活；
• 网络发现功能可能异常，其他JRiver实例可能无法发现此容器作为播放区域。

Docker Compose

推荐使用docker-compose管理容器，配置文件docker-compose.yml便于容器重建时保持配置一致。

Bridge网络（默认）

yml
version: '3'
services:
  jrivermc28:
    image: shiomax/jrivermc28
    restart: always
    container_name: jrivermc28
    mac_address: ed:e8:60:2d:65:c1
    ports:
      - "5800:5800"
      - "5900:5900"
      - "52100:52100"
      - "52101:52101"
      - "52199:52199"
      - "1900:1900/udp"
    environment:
      - VNC_PASSWORD=12345
    volumes:
        - /path/to/config:/config:rw
        - /path/to/music:/data/music:rw

Host网络

yml
version: '3'
services:
  jrivermc28:
    image: shiomax/jrivermc28
    restart: always
    container_name: jrivermc28
    network_mode: host
    environment:
      - VNC_PASSWORD=12345
    volumes:
        - /path/to/config:/config:rw
        - /path/to/music:/data/music:rw

运行容器：docker-compose up -d

更新容器：

• docker-compose pull 拉取最新镜像；
• docker-compose down 停止并删除容器（配置卷挂载时数据不会丢失）；
• docker-compose up -d 重建并后台运行容器；
• docker image prune 清理未使用镜像。

不使用Docker Compose

Bridge网络（默认）

sh
docker run -d \
    --name=jrivermc28 \
    --net=bridge \
    --restart=always \
    --mac-address=ed:e8:60:2d:65:c1 \
    -p 5800:5800 \
    -p 5900:5900 \
    -p 52199:52199 \
    -p 52101:52101 \
    -p 52100:52100 \
    -p 1900:1900/udp \
    -v config:/config:rw \
    -v /path/to/music:/data/music:rw \
    -e VNC_PASSWORD=12345 \
    shiomax/jrivermc28

Host网络

sh
docker run -d \
    --name=jrivermc28 \
    --net=host \
    --restart=always \
    -v config:/config:rw \
    -v /path/to/music:/data/music:rw \
    -e VNC_PASSWORD=12345 \
    shiomax/jrivermc28

更新容器：

• docker pull shiomax/jrivermc28:latest 拉取最新镜像；
• docker rm -f jrivermc28 停止并删除容器；
• 重新执行上述docker run命令重建容器；
• docker image prune 清理未使用镜像。

镜像标签

• shiomax/jrivermc28:latest：使用“latest”仓库的JRiver版本（不指定标签时默认此版本）；
• shiomax/jrivermc25:stable：使用“stable”仓库的JRiver版本，功能与latest一致；
• 特定版本标签（如25.0.83-latest-1、25.0.50-stable-1）：包含JRiver版本（25.0.83）、仓库（latest）和镜像版本（1），用于版本回滚，推送后不再更新。

卷（绑定挂载）

• /config：容器的主目录，必须挂载到外部目录以持久化设置、库备份等。删除容器时，只要此目录存在，JRiver可恢复原有状态；
• /data/music：音乐文件挂载目录，也可使用其他目录，建议默认使用此路径。

端口映射

• JRiver使用端口：52100（TCP）、52101（TCP）、52199（TCP）、1900（UDP）；
• Web GUI端口：5800（TCP）；
• VNC访问端口：5900（TCP，仅使用Web GUI时可忽略）。

声音配置

通过映射主机alsa声音设备/dev/snd实现容器内声音播放：

• Docker run命令：添加--device /dev/snd选项；
• Docker Compose：在配置中添加：

  yml
  devices:
    - "/dev/snd"
  

注意：版本7之前不支持此功能。

访问GUI

可通过Web浏览器或VNC客户端访问GUI（假设未修改端口）：

• Web UI：http://<主机IP>:5800
• Web UI（启用SECURE_CONNECTION）：https://<主机IP>:5800
• VNC：<主机IP>:5900
• VNC（启用SECURE_CONNECTION）：<主机IP>:5900（需支持SSL加密的VNC客户端，如SSVNC）

使用.mjr文件激活JRiver

若密钥激活失败，可从[***]

1. 将.mjr文件放入/config目录；
2. 进入容器：docker exec -it <容器名> /bin/bash；
3. 激活JRiver（需先设置HOME环境变量）：

   sh
   export HOME=/config 
   mediacenter28 /RestoreFromFile /config/<mjr文件名>
   

4. 激活后可删除.mjr文件。

注意：激活时需停止MC。镜像版本16及以上可通过设置BLOCK_MC_STARTUP=1（创建容器时）或touch /tmp/BLOCK_MC_STARTUP（运行中容器）阻止MC启动，激活后删除文件恢复启动。

权限问题

若容器无法访问媒体文件，可通过调整USER_ID和GROUP_ID环境变量（数值型，默认1000）匹配媒体文件所属用户/组：

1. 查看媒体目录权限：ls -la /path/to/music；
2. 获取用户ID：id <用户名>；
3. 配置容器：

Docker CLI：

sh
docker run -d \
    --name=jrivermc28 \
    --net=host \
    --restart=always \
    -v config:/config:rw \
    -v /path/to/music:/data/music:rw \
    -e USER_ID=1234 \
    -e GROUP_ID=1234 \
    -e VNC_PASSWORD=12345 \
    shiomax/jrivermc28

Docker Compose：

yml
version: '3'
services:
  jrivermc28:
    image: shiomax/jrivermc28
    restart: always
    container_name: jrivermc28
    network_mode: host
    environment:
      - VNC_PASSWORD=12345
      - USER_ID=1234
      - GROUP_ID=1234
    volumes:
        - /path/to/config:/config:rw
        - /path/to/music:/data/music:rw

防火墙配置（仅host网络）

firewalld（CentOS、Fedora、RHEL）

1. 以root身份创建文件/etc/firewalld/services/jriver.xml：

   xml
   <?xml version="1.0" encoding="utf-8"?>
   <service>
     <short>jriver</short>
     <description>Ports required by JRiver MediaCenter.</description>
     <port protocol="tcp" port="5800"></port>
     <port protocol="tcp" port="52199"></port>
     <port protocol="tcp" port="52100"></port>
     <port protocol="tcp" port="52101"></port>
     <port protocol="tcp" port="5900"></port>
     <port protocol="udp" port="1900"></port>
   </service>
   

2. 重载firewalld：firewall-cmd --reload；
3. 临时应用配置：firewall-cmd --add-service=jriver --zone=public；
4. 测试访问后永久生效：firewall-cmd --add-service=jriver --zone=public --permanent，再次重载。

ufw（Ubuntu、Debian）

1. 以root身份创建文件/etc/ufw/applications.d/jriver：

   [jriver]
   title=jriver
   description=Ports required by JRiver MediaCenter
   ports=5800,52199,52100,52101,5900/tcp|1900/udp
   

2. 更新应用配置：ufw app update jriver，验证：ufw app info jriver；
3. 允许访问：ufw allow jriver。

运行自定义初始化任务（高级用户）

通过挂载脚本到/etc/cont-init.d实现启动时自定义逻辑（如安装包、修复问题）。脚本按文件名前缀数字排序执行（建议使用100+前缀确保在其他初始化后运行）。示例脚本：

sh
#!/usr/bin/with-contenv sh

set -e
set -u

log() {
    echo "[cont-init.d] $(basename $0): $*"
}

# 自定义逻辑
log "Running custom initialization..."

环境变量

镜像特定变量

继承自基础镜像的变量（部分默认值已修改）

更新日志

版本18

• 添加MC30镜像

版本17

• 添加MC29镜像
• 所有初始化脚本重命名为10-...（执行顺序无关）

版本16

• 修复apt无法使用问题（“unknown system group 'messagebus'”）
• 添加apt和ENABLE_CJK_FONT测试
• 新增阻止MC启动选项，便于.mjr文件激活

版本15

• 基础镜像更新至v3.5.8

版本14

• 安装ffmpeg以支持视频导入

版本13

• 基础镜像更新至v3.5.7
• 支持JRiverMC 28构建

版本12

• 添加beta版本构建目标
• 修复ENABLE_CJK_FONT字体安装问题

版本11

• 安装libgbm1以修复JRiverMC27浏览器功能

版本10

• 修复startapp.sh中仓库信息过时问题
• 添加JRiverMC27镜像

版本9

• 基础镜像更新至jlesage/baseimage-gui:debian-10-v3.5.6

版本8

• 添加openbox依赖xpropspy
• 仓库迁移至GitLab
• 确保启动时窗口可见
• 使用`--deb