shiomax/jrivermc25

JRiver Media Center 25 - Docker镜像

镜像概述

这是社区构建的JRiver Media Center 25 Docker镜像，基于https://github.com/jlesage/docker-baseimage-gui%E3%80%82%E9%80%82%E7%94%A8%E4%BA%8E%E6%90%AD%E5%BB%BA%E6%97%A0%E5%A4%B4%E5%AA%92%E4%BD%93%E6%9C%8D%E5%8A%A1%E5%99%A8%EF%BC%8C%E4%BE%9B%E5%85%B6%E4%BB%96JRiver%E5%AE%9E%E4%BE%8B%E6%B5%81%E5%BC%8F%E4%BC%A0%E8%BE%93%E9%9F%B3%E4%B9%90%E3%80%82%E6%BA%90%E7%A0%81%E6%89%98%E7%AE%A1%E4%BA%8EGitLab%E3%80%82**%E6%96%B0%E5%AE%89%E8%A3%85%E5%BB%BA%E8%AE%AE%E4%BD%BF%E7%94%A8%E6%9B%BF%E4%BB%A3%E9%95%9C%E5%83%8Fshiomax/jrivermc%EF%BC%8C%E6%9C%AC%E9%95%9C%E5%83%8F%E5%B0%86%E5%81%9C%E6%AD%A2%E7%BB%B4%E6%8A%A4%E3%80%82**

核心功能

• 无头服务：作为中央媒体服务器，支持多设备音乐流传输
• 可视化管理：通过Web GUI（5800端口）或VNC（5900端口）访问界面
• 持久化配置：挂载/config目录保存设置、库备份，容器重建不丢失数据
• 音频支持：映射/dev/snd设备实现容器内音频播放
• 灵活网络：支持host/bridge模式，bridge模式需自定义MAC地址避免激活问题
• 权限控制：通过USER_ID/GROUP_ID调整容器内用户权限，解决媒体访问问题

使用场景

• 家庭媒体中心：集中管理音乐库，多设备（手机、平板）流式播放
• 个人音乐服务器：远程访问音乐库，无需本地安装JRiver客户端
• 测试环境：快速部署JRiver实例进行功能验证

配置说明

Docker Compose部署

Host网络模式

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

Bridge网络模式

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

Docker Run部署

Host网络模式

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

Bridge网络模式

sh
docker run -d \
    --name=jrivermc25 \
    --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/jrivermc25

关键配置项

• 卷挂载：/config（保存配置）、/data/music（媒体目录）
• 端口映射：5800（Web GUI）、5900（VNC）、52100/52101/52199（JRiver服务）、1900/udp（DLNA）
• 环境变量：VNC_PASSWORD（VNC访问密码）、USER_ID/GROUP_ID（调整权限）、TZ（时区）
• 音频支持：添加--device /dev/snd（docker run）或devices: ["/dev/snd"]（compose）

激活方法

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

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

防火墙配置（Host网络）

Firewalld（CentOS/Fedora）

创建/etc/firewalld/services/jriver.xml并添加端口，然后重载生效：

xml
<?xml version="1.0" encoding="utf-8"?>
<service>
  <short>jriver</short>
  <description>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>

UFW（Ubuntu/Debian）

创建/etc/ufw/applications.d/jriver并添加端口，然后允许服务：

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

镜像标签

• shiomax/jrivermc25:latest：最新版本
• shiomax/jrivermc25:stable：稳定版本
• 版本标签（如25.0.83-latest-1）：特定历史版本，用于回滚