nocturno/hyper-hdr

HyperHDR Docker镜像文档

镜像概述

本镜像为HyperHDR应用的Docker容器化版本，旨在简化HyperHDR的部署流程。HyperHDR是一款由Awawa开发的应用（项目地址：https://github.com/awawa-dev/HyperHDR%EF%BC%89%EF%BC%8C%E6%9C%AC%E9%95%9C%E5%83%8F%E9%80%9A%E8%BF%87%E5%AE%B9%E5%99%A8%E5%8C%96%E5%B0%81%E8%A3%85%EF%BC%8C%E6%94%AF%E6%8C%81%E5%BF%AB%E9%80%9F%E9%83%A8%E7%BD%B2%E3%80%81%E8%A7%86%E9%A2%91%E8%AE%BE%E5%A4%87%E6%8E%A5%E5%85%A5%E5%8F%8A%E8%87%AA%E5%AE%9A%E4%B9%89%E9%85%8D%E7%BD%AE%EF%BC%8C%E9%80%82%E7%94%A8%E4%BA%8E%E9%9C%80%E8%A6%81%E8%BF%90%E8%A1%8CHyperHDR%E7%9A%84%E5%90%84%E7%B1%BB%E7%8E%AF%E5%A2%83%E3%80%82

核心功能与特性

• 便捷部署：通过Docker容器化打包，无需手动配置依赖，一键启动HyperHDR服务
• 硬件支持：支持挂载本地视频设备（如/dev/video0），实现视频输入硬件接入
• 灵活配置：通过环境变量自定义用户权限（PUID/PGID）、时区（TZ）等参数
• 数据持久化：支持挂载本地目录至容器/config路径，实现配置数据持久化
• 网络优化：默认使用主机网络模式（--net=host），简化网络配置

使用场景

适用于需要部署HyperHDR应用的场景，如树莓派、Linux服务器等环境，尤其适合希望快速搭建HyperHDR服务并接入视频设备的用户。

使用方法与配置说明

1. 拉取镜像

通过以下命令拉取最新版本镜像：

bash
docker pull docker.xuanyuan.run/nocturno/hyper-hdr:latest

2. 运行容器

基础运行命令

bash
docker run -d \
  --name=hyperhdr \
  --net=host \
  --device=/dev/video0:/dev/video0 \  # 挂载视频设备（通常为/dev/video0）
  -e PUID=1000 \                     # 用户ID（默认1000，对应pi用户）
  -e PGID=1000 \                     # 组ID（默认1000，对应pi用户）
  -e TZ=America/New_York \           # 时区设置（示例为纽约时区）
  -v /本地路径:/config \             # 挂载本地目录至容器/config（持久化配置）
  --restart=unless-stopped \         # 重启策略：除非手动停止，否则自动重启
  nocturno/hyper-hdr:latest

参数详细说明

• 网络配置：--net=host
  使用主机网络模式，直接复用主机网络栈，避免端口映射配置。

• 设备挂载：--device=/dev/video0:/dev/video0
  用于将本地视频设备挂载至容器，确保HyperHDR可访问视频输入。若不确定设备路径，可临时使用--privileged参数（不推荐，存在安全风险）。

• 环境变量

  • PUID：运行容器的用户ID，默认值1000（适用于pi用户）。可通过终端执行id命令查看当前用户uid（格式：uid=1000(pi)）。
  • PGID：运行容器的组ID，默认值1000（适用于pi用户）。可通过终端执行id命令查看当前用户gid（格式：gid=1000(pi)）。
  • TZ：时区配置，格式为区域/城市（如Asia/Shanghai表示中国标准时间）。

• 数据持久化：-v /本地路径:/config
  将容器内/config目录挂载至本地路径，用于保存HyperHDR配置文件，避免容器重启后配置丢失。

3. 推荐使用Docker Compose

建议通过docker-compose.yml管理服务，简化配置维护。示例配置如下（需根据实际环境调整路径和参数）：

yaml
version: '3'
services:
  hyperhdr:
    image: docker.xuanyuan.run/nocturno/hyper-hdr:latest
    container_name: hyperhdr
    network_mode: host
    devices:
      - /dev/video0:/dev/video0  # 替换为实际视频设备路径
    environment:
      - PUID=1000                # 替换为实际用户uid
      - PGID=1000                # 替换为实际用户gid
      - TZ=Asia/Shanghai         # 替换为实际时区
    volumes:
      - /本地配置路径:/config    # 替换为本地配置目录路径
    restart: unless-stopped

启动命令：docker-compose up -d