# 云瞰 Unraid 6.12+ 部署
#
# 前提:
#   - Unraid 6.12.13+(原生支持 docker compose;旧版需装 Docker Compose Manager plugin)
#   - x86_64 CPU(Intel iGPU 推荐 openvino 变体;NVIDIA GPU 推荐 cuda/trt 变体)
#   - 镜像变体根据硬件选,默认本文件用 openvino;NVIDIA 改 image 为 yunkan-cuda 或 yunkan-trt
#
# 关于 Unraid 习惯的 PUID/PGID(nobody:users = 99:100):
#   本模板用 host network + 容器默认 root 跑,license 硬件指纹和 iGPU 透传都需要
#   root 权限。Unraid 习惯的 nobody:users 模式适用于 bridge 网络 + 非特权容器(常见的
#   媒体类 app),本场景不必,**保持容器内 root 即可**。如有强需求自行加 `user: "99:100"`,
#   但需注意 /etc/machine-id 读权限和 /dev/dri 访问可能受影响。
#
# iGPU 透传(Intel 集显):
#   - 装 "Intel GPU TOP" plugin → 重启 → /dev/dri 出现
#   - 本文件已配 devices: /dev/dri:/dev/dri,自动生效
#
# NVIDIA GPU 透传:
#   - 装 "NVIDIA Driver" plugin → 重启
#   - 把下面 deploy.resources 注释取消,并把 image 换成 yunkan-cuda 或 yunkan-trt
#
# 用法:
#   1. 在 Unraid Web UI → Docker 标签页底部 → "Add Container" 旁边的 "Compose" → "Add New Stack"
#      (或 SSH 进 Unraid:cd /mnt/user/appdata/yunkan && docker compose up -d)
#   2. 粘贴本文件内容,或先 wget 下来再上传
#   3. 浏览器打开 http://<Unraid IP>:23406/ 进入 Setup 向导
#
# 持久化(两个目录,可分别放不同盘):
#   data/        小状态:DB / cookies / 日志 / 升级状态(体积小,建议放 SSD / 缓存池)。
#                (模型不在这里——已 bake 进镜像 /var/lib/skyview/models,不暴露给客户。)
#   recordings/  录像(可达 TB 级):嵌套挂到容器内 /app/data/recordings,recordings_dir
#                配置不变,可单独把它指到阵列大盘 / 专用 ZFS pool / 远端 NAS。
# Unraid 习惯把容器数据放 /mnt/user/appdata/yunkan/ 下,录像建议另指容量更大的存储池。
#
# 防火墙:Unraid 默认无防火墙,所有端口直接暴露在 host 上;如有 host 防火墙需放行:
#   23406/tcp、23880/tcp、24214/tcp、24215/tcp、23515/udp
#
# 升级:可走 yunkan-updater sidecar(下面 updater 服务),也可手动 docker compose pull && up -d。

# ★ 本文件请保存为 compose.yml ★ —— OTA sidecar updater 靠固定文件名 compose.yml
# 定位本文件来重建主容器;存成下载得到的 unraid.yml 等别的名字会让网页后台在线
# 升级失效。
#
# docker compose 项目名固定为 yunkan —— updater 在它自己的容器里跑 compose 重建
# 主容器时,要靠同一项目名找到已存在的 yunkan 容器;用 Unraid Compose 插件 /
# 图形界面导入本文件时,请把 Stack 名称也填 yunkan。
name: yunkan

services:
  yunkan:
    image: registry.cn-hangzhou.aliyuncs.com/yunkan/yunkan-openvino:latest
    container_name: yunkan
    restart: always

    # Unraid 上 host 网络最省事:WebRTC ICE / RTSP / HLS 多端口直接暴露,不用逐个映射。
    network_mode: host

    # ─── Intel iGPU 直通(需 Intel GPU TOP plugin)──────────────────
    devices:
      - /dev/dri:/dev/dri

    # ─── NVIDIA GPU 直通(需 NVIDIA Driver plugin,并把 image 换成 yunkan-cuda/yunkan-trt)──
    # deploy:
    #   resources:
    #     reservations:
    #       devices:
    #         - driver: nvidia
    #           count: all
    #           capabilities: [gpu]

    volumes:
      # 状态盘:DB / cookies / 日志 / 升级状态(体积小)。
      # Unraid 习惯放 /mnt/user/appdata/<app>/。(模型不在这里——已 bake 进镜像。)
      - /mnt/user/appdata/yunkan/data:/app/data
      # 录像盘:可达 TB 级,可指到阵列大盘 / NAS。嵌套覆盖 /app/data/recordings
      # (recordings_dir 配置不变,snapshots / 导出跟录像走)。改这一行左侧路径即可换盘。
      - /mnt/user/appdata/yunkan/recordings:/app/data/recordings

      # License 硬件指纹:把 Unraid 宿主机稳定标识 bind mount 进容器。
      # 不挂的话每次重建容器 machine-id 随机变 → 指纹变 → license 占新 slot 死循环。
      - /etc/machine-id:/etc/machine-id:ro
      - /sys/class/dmi/id/product_uuid:/sys/class/dmi/id/product_uuid:ro

      # OTA 升级用(yunkan-updater sidecar 需要 docker socket)
      - /var/run/docker.sock:/var/run/docker.sock

    environment:
      - TZ=Asia/Shanghai
      - SKYVIEW_SELF_CONTAINER_NAME=yunkan

  # ─── OTA sidecar(可选,删掉这段就不开 OTA)──────────────────────
  # yunkan-updater 监视 ./data/.upgrade-state,触发后调 docker compose 重建 yunkan 容器。
  # Unraid 上 docker socket 权限正常,可直接用。
  updater:
    image: registry.cn-hangzhou.aliyuncs.com/yunkan/yunkan-updater:latest
    container_name: yunkan-updater
    restart: always
    network_mode: none
    volumes:
      - /mnt/user/appdata/yunkan/data:/app/data
      - /mnt/user/appdata/yunkan/compose.yml:/app/compose.yml:ro
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - TZ=Asia/Shanghai
      # 项目名必须和主容器侧一致(本文件顶层 name: yunkan)
      - COMPOSE_PROJECT_NAME=yunkan
      - STATE_FILE=/app/data/.upgrade-state
      - SKYVIEW_COMPOSE_FILE=/app/compose.yml
      - SKYVIEW_COMPOSE_SERVICE=yunkan