mekayelanik/ispyagentdvr

iSpy Agent DVR 多架构镜像

!ispyagentdvr

这是iSpy的Agent DVR的非官方多架构Docker镜像，为多平台提供支持。iSpy Agent DVR创建本地服务器用于IP摄像头的管理。官方网站：[***]

!https://img.shields.io/docker/pulls/mekayelanik/ispyagentdvr.svg!https://img.shields.io/docker/stars/mekayelanik/ispyagentdvr.svg

镜像支持的架构

公告

• ⚠️⚠️⚠️ 目录结构从/home/agentdvr/AgentDVR恢复为/AgentDVR。在unRAID、Synology NAS和其他基于GUI的容器部署工具中正确应用此更改尤为重要。⚠️⚠️⚠️
• ⚠️ 基础镜像已更新为Debian Trixie ⚠️
• ⚠️ 应用ZSTD压缩以减小镜像大小并节省带宽。对于6.5.7.0及更高版本的镜像，需要Docker Engine 23.0或更高版本；Podman部署需要Podman Machine v5.1或更高版本！⚠️
• ⚠️⚠️⚠️ 非常重要：TURN服务器端口范围已从50000-50010更改为50000-50100。请在Docker CLI或Docker Compose中将范围设置为50000-50100⚠️⚠️⚠️
• 感谢真主，ARMHF镜像已修复。特别感谢Sean T修复了底层问题。对于ARM32位/ARMHF设备，请下载版本大于或等于4.8.2.0的镜像。
• 如需GPU硬件加速编解码，请使用5.3.5.0或更新版本的镜像。
• ⚠️⚠️⚠️ 不建议在关键任务环境中使用BETA版本！！！
• 此镜像提供多种版本，可通过标签获取。请仔细阅读更新信息，使用"旧版本"标签时需谨慎，因为它们可能包含未修复的错误。

运行镜像

以下是帮助您开始创建容器的示例代码片段。

docker-compose（推荐，点击此处了解更多信息）

yaml
---
services:
  ispyagentdvr:
    image: mekayelanik/ispyagentdvr:latest
    container_name: ispyagentdvr
    environment:
      - PUID=1000
      - PGID=1000
      - AGENTDVR_WEBUI_PORT=8090 
      - TZ=Asia/Dhaka
    volumes:
      - /path/to/config:/AgentDVR/Media/XML
      - /path/to/recordings:/AgentDVR/Media/WebServerRoot/Media
      - /path/to/commands:/AgentDVR/Commands
    ports:
      - 8090:8090
      - 3478:3478/udp
      - 50000-50100:50000-50100/udp
    restart: unless-stopped

注意：

• 在树莓派和其他低功耗ARM单板计算机的情况下，请在容器部署后至少30秒再访问WebUI URL。ARM处理器可能需要几秒钟启动所需服务。在此之前，您可能无法在Web浏览器中获得响应。此外，首次访问时可能需要刷新WebUI几次才能完全加载界面。
• 另外，如果您有大量摄像头，启动时间会相应增加。请耐心等待，并查看AgentDVR容器日志。

docker cli（https://docs.docker.com/engine/reference/commandline/cli/%EF%BC%89

bash
docker run -d \
  --name=ispyagentdvr \
  -e PUID=1000 \
  -e PGID=1000 \
  -e AGENTDVR_WEBUI_PORT=8090 \
  -e TZ=Asia/Dhaka \
  -p 8090:8090 \
  -p 3478:3478/udp \
  -p 50000-50100:50000-50100/udp \
  -v /path/to/config:/AgentDVR/Media/XML \
  -v /path/to/recordings:/AgentDVR/Media/WebServerRoot/Media \
  -v /path/to/commands:/AgentDVR/Commands \
  --restart unless-stopped \
  mekayelanik/ispyagentdvr:latest

如需为iSpy Agent DVR容器使用MACVLAN分配专用本地IP（https://docs.docker.com/network/macvlan/%EF%BC%89

yaml
---
services:
  ispyagentdvr:
    image: mekayelanik/ispyagentdvr:latest
    container_name: ispyagentdvr
    environment:
      - PUID=1000
      - PGID=1000
      - AGENTDVR_WEBUI_PORT=8090 
      - TZ=Asia/Dhaka
    volumes:
      - /path/to/config:/AgentDVR/Media/XML
      - /path/to/recordings:/AgentDVR/Media/WebServerRoot/Media
      - /path/to/commands:/AgentDVR/Commands
    ports:
      - 8090:8090
      - 3478:3478/udp
      - 50000-50100:50000-50100/udp
    restart: unless-stopped
    hostname: ispyagentdvr
    domainname: local
    mac_address: AB-BC-C0-D1-E2-EF
    networks:
      macvlan-1:
        ipv4_address: 192.168.2.12
networks:
  macvlan-1:
    name: macvlan-1
    external: True

要使MACVLAN正常工作，必须将有效的MAC地址映射到mac_address:，将子网内的有效IP地址映射到ipv4_address:（这将是容器的IP），将路由器的本地IP子网映射到subnet:，将子网内所需的本地IP范围映射到ip_range:，最后将路由器的LAN IP地址映射到gateway:。

使用MACVLAN时，必须通过http://ipv4_address:8090访问WebUI。

GPU硬件加速（5.3.5.0及更新版本镜像已测试"正常工作"）

必须使用5.3.5.0或更新版本的镜像才能获得GPU硬件加速支持。旧版本镜像不支持。如遇问题，请在该镜像的GitHub上报告。GitHub链接位于本页面底部。

docker-compose（推荐，点击此处了解更多信息）

必须能够按照以下说明将GPU（渲染设备）传递到容器中！

yaml
---
services:
  ispyagentdvr:
    image: mekayelanik/ispyagentdvr:latest
    container_name: ispyagentdvr
    environment:
      - PUID=1000
      - PGID=1000
      - AGENTDVR_WEBUI_PORT=8090
      - TZ=Asia/Dhaka
    volumes:
      - /path/to/config:/AgentDVR/Media/XML
      - /path/to/recordings:/AgentDVR/Media/WebServerRoot/Media
      - /path/to/commands:/AgentDVR/Commands
    ports:
      - 8090:8090
      - 3478:3478/udp
      - 50000-50100:50000-50100/udp
    restart: unless-stopped

docker cli（https://docs.docker.com/engine/reference/commandline/cli/%EF%BC%89

bash
docker run -d \
  --name=ispyagentdvr \
  -e PUID=1000 \
  -e PGID=1000 \
  -e AGENTDVR_WEBUI_PORT=8090 \
  -e TZ=Asia/Dhaka \
  -p 8090:8090 \
  -p 3478:3478/udp \
  -p 50000-50100:50000-50100/udp \
  -v /path/to/config:/AgentDVR/Media/XML \
  -v /path/to/recordings:/AgentDVR/Media/WebServerRoot/Media \
  -v /path/to/commands:/AgentDVR/Commands \
  --restart unless-stopped \
  mekayelanik/ispyagentdvr:latest

对于Nvidia GPU

要从Nvidia获得GPU硬件加速，用户必须在主机/服务器/VM/LXC上安装Nvidia提供的"最新"Nvidia驱动程序和Nvidia Container Toolkit。Nvidia Container Toolkit的安装说明可在此处找到：

https://github.com/NVIDIA/nvidia-container-toolkit

我们添加了必要的环境变量，以利用主机GPU上的所有可用功能。在主机上安装Nvidia容器运行时后，需要使用nvidia容器运行时重新创建docker容器，即--runtime=nvidia，并添加环境变量-e NVIDIA_VISIBLE_DEVICES=all（也可设置为特定GPU的UUID，可通过运行nvidia-smi --query-gpu=gpu_name,gpu_uuid --format=csv发现）。Nvidia会自动将主机的GPU和驱动程序挂载到AgentDVR docker容器中。

对于AMD GPU和集成GPU

需在docker-compose文件/docker-cli命令中添加以下内容：

docker compose

yaml
devices:
    - /dev/dri/renderD128:/dev/dri/renderD128
    - /dev/dri/card0:/dev/dri/card0
    - /dev/kfd:/dev/kfd

docker cli

bash
--device /dev/dri/renderD128:/dev/dri/renderD128 --device /dev/dri/card0:/dev/dri/card0 --device /dev/kfd:/dev/kfd

对于Intel GPU和集成GPU

需在docker-compose文件/docker-cli命令中添加以下内容：

docker compose

yaml
devices:
    - /dev/dri/renderD128:/dev/dri/renderD128
    - /dev/dri/card0:/dev/dri/card0

docker cli

bash
--device /dev/dri/renderD128:/dev/dri/renderD128 --device /dev/dri/card0:/dev/dri/card0

对于Rockchip SBC的集成VPU，请使用以下CLI命令

bash
docker run -d \
  --name=ispyagentdvr \
  -e PUID=1000 \
  -e PGID=1000 \
  -e AGENTDVR_WEBUI_PORT=8090 \
  -e TZ=Asia/Dhaka \
  -p 8090:8090 \
  -p 3478:3478/udp \
  -p 50000-50100:50000-50100/udp \
  -v /path/to/config:/AgentDVR/Media/XML \
  -v /path/to/recordings:/AgentDVR/Media/WebServerRoot/Media \
  -v /path/to/commands:/AgentDVR/Commands \
  --restart unless-stopped \
`for dev in dri dma_heap mali0 rga mpp_service \
   iep mpp-service vpu_service vpu-service \
   hevc_service hevc-service rkvdec rkvenc vepu h265e ; do \
  [ -e "/dev/$dev" ] && echo " --device /dev/$dev"; \
 done` 
  mekayelanik/ispyagentdvr:latest

免责声明：本镜像使用了Jellyfin FFMPEG及相关思路来启用硬件加速

参数

容器镜像通过运行时传递的参数进行配置（如上所示）。这些参数用冒号分隔，表示<外部>:<内部>。例如，-p 8090:80会将容器内的端口80暴露到主机IP的端口8090。

用户/组标识符

使用卷（-v标志）时，主机操作系统和容器之间可能出现权限问题。通过指定用户PUID和组PGID可以避免此问题。

确保主机上的任何卷目录都归您指定的用户所有，权限问题将迎刃而解。

本示例中PUID=1000和PGID=1000，通过以下命令查找您的ID：

bash
$ id username
uid=1000(docker user) gid=1000(docker group) groups=1000(docker group)

iSpy Agent DVR详细用户指南请访问：

[***]

非主机网络使用：

要使用非主机