icebear8/bubbleupnpserver

Bubble UPnP Server Docker镜像文档

镜像概述

Bubble UPnP Server是由BubbleSoft开发的UPnP媒体服务器应用，旨在解决不同网络环境下UPnP设备间的媒体共享与通信问题。该Docker镜像基于官方应用构建，提供容器化部署方案，简化安装流程，适用于家庭及小型网络环境的媒体管理需求。

核心功能与特性

• UPnP设备桥接：实现跨子网、远程网络中UPnP设备的发现与通信
• 媒体流转发：支持本地媒体库内容向远程设备的实时流媒体转发
• 远程访问支持：通过BubbleUPnP Cloud服务提供家庭媒体库的远程访问能力
• 多格式兼容：支持主流音频、视频及图片格式的共享与播放
• 轻量级部署：Docker容器化设计，资源占用低，配置简单

使用场景与适用范围

• 家庭媒体中心：连接智能电视、音响、手机等设备，构建家庭内部媒体共享网络
• 远程媒体访问：外出时通过移动设备访问家中媒体库
• 跨网络媒体共享：解决不同网段或***环境下UPnP设备通信障碍
• 多设备协同：支持多台UPnP兼容设备同步播放媒体内容

部署与使用指南

前提条件

• 已安装Docker Engine（推荐20.10+版本）
• 网络环境需开放必要端口（或配置端口转发）

快速部署命令

Docker Run 示例

bash
docker run -d \
  --name bubbleupnpserver \
  -p 58050:58050 \  # Web管理界面端口
  -p 58052:58052 \  # UPnP通信端口
  -v /本地路径/config:/config \  # 配置文件持久化
  --restart unless-stopped \
  icebear8/bubbleupnpserver:stable

Docker Compose 配置

yaml
version: '3'
services:
  bubbleupnpserver:
    image: icebear8/bubbleupnpserver:stable
    container_name: bubbleupnpserver
    ports:
      - "58050:58050"  # Web管理端口
      - "58052:58052"  # UPnP通信端口
    volumes:
      - ./config:/config  # 本地配置目录挂载
    restart: unless-stopped

配置说明

容器启动后，通过 http://<容器IP>:58050 访问Web管理界面进行详细配置，包括：

• 媒体库路径设置
• 远程访问权限配置
• UPnP设备发现范围调整
• 网络代理与端口转发规则

镜像相关信息

• 项目主页：![Project]([***]
• 稳定版本：![Stable Version]([***]
• Docker拉取量：
• 镜像大小：
• 开发状态：
  • ![Open Issues]([***]
  • ![Last Commit]([***]

镜像获取

Docker Hub地址：https://hub.docker.com/r/icebear8/bubbleupnpserver