BubbleUPnP Server Docker镜像 (基于Eclipse OpenJ9)

镜像概述

本镜像为BubbleUPnP Server的***Docker镜像，支持amd64和arm64架构，基于Eclipse OpenJ9 Java运行时构建。相比常规OpenJDK，OpenJ9运行时平均内存占用减少约40%，虽可能略慢但不影响BubbleUPnP Server这类软件的使用，特别推荐用于内存受限设备及Synology NAS（可避免OpenJDK镜像可能出现的崩溃问题）。

镜像基于openSUSE Tumbleweed，内置Java 17和FFmpeg，包含运行BubbleUPnP Server所需的全部依赖，确保软件以最佳状态运行。

核心功能与特性

低内存占用

• 基于Eclipse OpenJ9 Java运行时，内存占用比常规OpenJDK降低约40%，适合内存资源有限的设备。

完整依赖支持

• 内置Java 17运行时和FFmpeg，无需额外安装依赖，开箱即可运行BubbleUPnP Server。

多架构支持

• 提供amd64（x86_64）和arm64架构镜像，适配不同硬件平台。

轻量化选项

• 针对amd64架构，提供nogpu标签镜像（bubblesoftapps/bubbleupnpserver-openj9:nogpu），移除Chromecast GPU转码功能，镜像体积显著减小（适用于无需GPU转码的场景）。

GPU转码支持

• 支持Intel QSV、VA-API（含AMD GPU）及NVIDIA GPU转码（需参考***文档配置设备权限，如--group-add参数）。

使用场景与适用范围

• 内存受限设备：如树莓派、低配置服务器等内存资源有限的环境。
• Synology NAS：避免常规OpenJDK镜像可能出现的崩溃问题。
• 家庭媒体中心：需运行BubbleUPnP Server实现UPnP/DLNA媒体流转发、转码的场景。
• 无GPU转码需求的amd64设备：选择nogpu版本以减少镜像体积和资源占用。

使用方法与配置说明

前置要求

• 运行前请务必参考***文档，其中包含GPU支持（如NVIDIA、Intel、AMD设备）的重要配置说明。

镜像拉取

标准版本（含GPU转码支持，amd64/arm64）

bash
docker pull bubblesoftapps/bubbleupnpserver-openj9

轻量化版本（无GPU转码，仅amd64）

bash
docker pull bubblesoftapps/bubbleupnpserver-openj9:nogpu

数据持久化

自2024年2月12日版本起，支持将配置文件、日志文件及缓存文件存储在主机文件夹，实现数据持久化（避免容器更新/重建后数据丢失）。配置方法详见***文档。

自定义JVM参数

通过USER_JVM_ARGS环境变量可自定义JVM参数（如限制内存使用），示例：

bash
docker run -e USER_JVM_ARGS="-Xmx256m" ... bubblesoftapps/bubbleupnpserver-openj9

（-Xmx256m表示限制最大堆内存为256MB）

GPU权限配置

对于NVIDIA GPU，需在运行容器时添加--group-add参数以确保容器有权限访问GPU设备，具体配置参考***文档中NVIDIA相关章节。

更新日志

2025年1月17日

• 修复amd64镜像中AMD GPU的VA-API功能异常问题（用于Chromecast视频转码）

2025年1月3日

• 更新至openSUSE Tumbleweed 20250101快照
• 升级Java至OpenJDK v17.0.12（搭配OpenJ9 0.46.0 VM）
• 升级x86_64架构的FFmpeg至v7.1，基于更新依赖及VA-API 1.22.0编译
• 更新文档，新增NVIDIA设备需使用--group-add参数（及docker-compose.yml对应配置）以确保容器访问GPU设备权限

2024年2月12日

• 重写***文档，包含重要更新说明
• 新增可配置的docker-compose.yml，支持Docker Compose部署（详见文档）
• 支持将数据文件（配置文件、日志、缓存）存储在主机文件夹，便于访问及跨容器持久化（配置方法见文档）
• 移除ffmpeg setuid root配置，改为通过--group-add Docker选项允许容器访问GPU设备（详见文档）
• 在amd64镜像中添加libmfx-gen1_2包，支持Intel Tiger Lake及以上处理器的QSV功能
• 更新ffmpeg以使用libvpl替代已弃用的libmfx，确保Intel Tiger Lake及以上处理器的QSV支持
• 修复因缺少awk导致的健康检查失败问题
• 升级至openSUSE Tumbleweed 20240112快照

2023年12月20日

• 升级至openSUSE Tumbleweed 20231217快照，包含Eclipse OpenJ9 v0.41（Java v17.0.9）及VA-API v1.20
• 升级FFmpeg至v6.1（仅amd64），基于最新VA-API（libva）v1.20及依赖编译；VA-API v1.20支持主机libva版本 up to 1.20，适配主流及前沿发行版
• 在amd64镜像中，ffmpeg以setuid root权限运行，确保可访问/dev/dri设备（用于Intel QSV、VA-API的Chromecast GPU转码），解决部分发行版中设备访问权限限制问题（BubbleUPnP Server Java进程仍以非特权用户运行）

2022年8月18日

• 升级至openSUSE Tumbleweed 20220817快照，包含OpenJDK 11.0.16（搭配OpenJ9 VM 0.33.0）及VA-API v1.15
• 升级FFmpeg至v5.0（仅amd64），基于VA-API v1.15编译
• 新增USER_JVM_ARGS环境变量，支持自定义JVM参数（如docker run -e USER_JVM_ARGS="-Xmx256m"限制最大内存为256MB）
• 修复使用-webContextPath命令行选项时健康检查失效问题
• 文档新增说明：如何禁用容器周期性磁盘写入（适用于Docker存储在机械硬盘的场景，避免阻止硬盘休眠）

2022年2月12日

• 升级至OpenJDK 11.0.13（搭配OpenJ9 0.29.0 VM）
• 升级FFmpeg至v5.0
• 修复健康检查在配置非默认HTTP端口（58050）时的失效问题
• 更新文档中关于编辑configuration.xml的正确说明

2021年8月17日

• 修复VA-API功能异常问题（影响Chromecast转码）

2021年6月25日

• 初始发布