aixpand/hyfy_lms

Hyperfy Light Media Server 镜像文档

镜像概述

Hyperfy Light Media Server 是一款专为低资源环境设计的轻量级媒体服务器，旨在提供高效、稳定的媒体流传输与分发能力。该镜像采用精简架构，资源占用低，部署配置简单，支持多种主流媒体协议与格式，适用于从小型媒体服务到边缘计算节点的各类媒体服务场景。

核心功能与特性

• 轻量级设计：优化资源占用，最低仅需512MB内存即可稳定运行，适合嵌入式设备与低配置服务器。
• 多协议支持：兼容HTTP、RTSP、HLS、RTMP等主流媒体传输协议，满足不同场景下的流媒体需求。
• 媒体处理能力：支持基础媒体转码（如格式转换、分辨率调整），适配不同客户端播放需求。
• 低延迟传输：针对实时流媒体场景优化，端到端延迟可低至几百毫秒，适合监控、直播等实时应用。
• 简易配置：通过环境变量或简单配置文件即可完成部署，无需复杂依赖，快速启动服务。
• 跨平台兼容：支持Linux、Windows、macOS等主流操作系统，可在容器化环境中无缝部署。

使用场景与适用范围

• 小型媒体服务部署：适用于家庭媒体中心、小型企业内部媒体分发，无需高性能服务器即可提供稳定服务。
• 监控视频流传输：支持RTSP协议，可对接监控摄像头，实现监控视频的实时传输与存储。
• 低资源边缘节点：在边缘计算环境中，作为轻量级媒体处理节点，处理本地媒体数据并上传至云端。
• 教育/培训内容分发：用于小型教育机构的视频课程分发，支持HLS协议实现自适应码率播放。
• 开发测试环境：作为媒体服务开发测试的本地服务器，快速验证流媒体功能。

使用方法与配置说明

基本部署（Docker Run）

通过以下命令快速启动Hyperfy Light Media Server：

bash
docker run -d \
  --name hyperfy-media-server \
  -p 8080:8080 \  # HTTP服务端口
  -p 554:554 \    # RTSP服务端口
  -v /path/to/media:/media \  # 挂载本地媒体文件目录
  -e MEDIA_PATH=/media \  # 指定媒体文件根目录
  -e PORT=8080 \   # HTTP服务端口（默认8080）
  hyperfy/light-media-server

Docker Compose配置

创建docker-compose.yml文件简化部署：

yaml
version: '3'
services:
  media-server:
    image: hyperfy/light-media-server
    container_name: hyperfy-media-server
    ports:
      - "8080:8080"
      - "554:554"
    volumes:
      - ./media:/media
    environment:
      - MEDIA_PATH=/media
      - PORT=8080
      - LOG_LEVEL=info  # 日志级别：debug/info/warn/error
    restart: unless-stopped

执行docker-compose up -d启动服务。

核心配置参数（环境变量）

访问媒体服务

启动后，可通过以下方式访问媒体内容：

• HTTP播放：http://<服务器IP>:8080/media/<文件名>（例如http://192.168.1.100:8080/media/sample.mp4）
• RTSP流：rtsp://<服务器IP>:554/stream/<流名称>（需提前配置流源）
• HLS流：http://<服务器IP>:8080/hls/<流名称>.m3u8（启用HLS协议时）

注意事项

1. 媒体文件权限：挂载本地目录时，确保容器内用户对媒体文件有读取权限，可通过-u参数指定用户ID。
2. 资源需求：建议至少分配512MB内存，启用转码功能时需增加CPU资源。
3. 防火墙配置：开放对应端口（8080、554等）以允许外部访问。
4. 协议支持：部分协议（如HLS）需在启动时通过环境变量PROTOCOLS=hls,http,rtsp显式启用。