shiomax/jrivermc26

!!!
现在有一个新镜像 https://hub.docker.com/r/shiomax/jrivermc 可替代此镜像。新安装建议直接使用新镜像，此镜像最终将停止维护/构建。
!!!

JRiver Media Center - Docker

这是社区构建的 JRiver Media Center Docker镜像，基于 https://github.com/jlesage/docker-baseimage-gui%EF%BC%8C%E6%BA%90%E4%BB%A3%E7%A0%81%E4%BD%8D%E4%BA%8E gitlab.com。
该镜像旨在作为中央“无头”JRiver服务器，供其他JRiver实例流式传输音乐，也可配置直接播放（依赖主机alsa服务）。

Dockerhub版本列表

截图

!JRiver界面

使用方法

网络模式说明

推荐使用host网络（简化配置），若用bridge网络需注意：

1. 自定义MAC地址（避免许可证频繁激活）；
2. 网络发现功能可能失效。

Docker Compose配置

Bridge网络（默认）

yml
version: '3'  
services:  
  jrivermc26:  
    image: shiomax/jrivermc26  
    restart: always  
    container_name: jrivermc26  
    mac_address: ed:e8:60:2d:65:c1  
    ports:  
      - "5800:5800" # Web GUI  
      - "5900:5900" # VNC  
      - "52100:52100" # JRiver服务  
      - "52101:52101" # JRiver服务  
      - "52199:52199" # JRiver服务  
      - "1900:1900/udp" # DLNA  
    environment:  
      - VNC_PASSWORD=12345  
    volumes:  
      - /path/to/config:/config:rw # 持久化配置  
      - /path/to/music:/data/music:rw # 音乐目录  

Host网络

yml
version: '3'  
services:  
  jrivermc26:  
    image: shiomax/jrivermc26  
    restart: always  
    container_name: jrivermc26  
    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

直接运行（无Compose）

Bridge网络

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

Host网络

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

镜像 tags说明

• latest：默认标签，对应JRiver最新版本；
• stable：对应JRiver稳定版本；
• 26.x.x-latest-1：版本快照（用于回滚）。

核心配置

卷挂载

• /config：必须挂载，保存JRiver配置和库数据；
• /data/music：音乐目录（可自定义路径）。

端口映射

• Web GUI：5800；
• VNC：5900；
• JRiver服务：52100/52101/52199；
• DLNA：1900/udp。

声音配置

添加--device /dev/snd（docker run）或devices: ["/dev/snd"]（Compose）以启用容器内播放。

GUI访问

• Web：http://<主机IP>:5800；
• VNC：<主机IP>:5900（需输入VNC_PASSWORD）。

激活JRiver

1. 从 JRiver恢复页面 下载.mjr文件；
2. 将文件放入/config目录；
3. 进入容器执行激活：

sh
docker exec -it jrivermc26 /bin/bash  
export HOME=/config  
mediacenter26 /RestoreFromFile /config/<mjr文件名>  

注意：激活前需阻止MC启动（设置BLOCK_MC_STARTUP=1或touch /tmp/BLOCK_MC_STARTUP）。

权限调整

若媒体文件无法访问，修改USER_ID/GROUP_ID（对应主机用户ID）：

yml
environment:  
  - USER_ID=1001  
  - GROUP_ID=1001  

防火墙配置（Host网络）

firewalld（CentOS/Fedora）

创建/etc/firewalld/services/jriver.xml：

xml
<?xml version="1.0" encoding="utf-8"?>  
<service>  
  <short>jriver</short>  
  <port protocol="tcp" port="5800"/>  
  <port protocol="tcp" port="5900"/>  
  <port protocol="tcp" port="52100"/>  
  <port protocol="tcp" port="52101"/>  
  <port protocol="tcp" port="52199"/>  
  <port protocol="udp" port="1900"/>  
</service>  

执行：firewall-cmd --add-service=jriver --permanent && firewall-cmd --reload

ufw（Ubuntu/Debian）

创建/etc/ufw/applications.d/jriver：

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

执行：ufw app update jriver && ufw allow jriver

环境变量

镜像特定变量

基础镜像变量

包括USER_ID、TZ、SECURE_CONNECTION等（详见基础镜像文档）。

更新日志

版本18

• 添加MC30镜像；

版本17

• 添加MC29镜像；

版本16

• 修复apt问题；
• 新增BLOCK_MC_STARTUP选项；

版本15

• 更新baseimage到v3.5.8；

版本14

• 安装ffmpeg支持视频导入；

...（更多版本日志请参考原仓库）

以上为JRiver Media Center 26 Docker镜像的完整配置指南。 ===END===