robmarkcole/deepstack-ui

Deepstack-UI Docker 镜像文档

镜像概述

Deepstack-UI 是一个轻量级的 Web 用户界面，专为与 Deepstack AI 视觉 API 交互而设计。该镜像提供了一个直观的图形化操作平台，允许用户轻松上传图像并执行目标检测任务，是测试、调试和探索 Deepstack 各项参数效果的理想工具。

核心功能与特性

• 图像上传与检测：支持通过 Web 界面直接上传本地图像，并调用 Deepstack 后端进行实时目标检测。
• 参数动态探索：提供交互式控件，允许用户实时调整置信度阈值等检测参数，直观观察不同参数对检测结果的影响。
• 结果可视化：在界面上直接渲染带有边界框（Bounding Boxes）和标签的检测结果图像。
• 轻量级部署：基于容器化设计，启动迅速，资源占用低，易于与现有的 Deepstack 服务集成。

使用场景与适用范围

• 算法评估与调试：在开发阶段快速验证 Deepstack 目标检测模型的准确性和参数敏感度。
• 原型开发：为计算机视觉项目快速搭建前端演示界面。
• 服务监控：作为 Deepstack 后端服务的健康状态和推理能力的可视化监控面板。

环境变量与配置说明

在运行容器时，可通过以下环境变量配置 UI 与 Deepstack 后端的连接：

部署指南

1. 使用 Docker Run 部署

如果您已经在本地或远程主机上运行了 Deepstack 服务，可以使用以下命令单独启动 UI：

bash
docker run -d \
  --name deepstack-ui \
  -p 8501:8501 \
  -e DEEPSTACK_URL=http://<deepstack_host_ip>:5000 \
  robmarkcole/deepstack-ui:latest

注：请将 <deepstack_host_ip> 替换为实际的 Deepstack 服务 IP 地址。如果 UI 与 Deepstack 运行在同一台宿主机上，Linux 环境下可使用 --network host 或宿主机局域网 IP。

2. 使用 Docker Compose 部署（推荐）

以下示例展示了如何将 Deepstack-UI 与 Deepstack 后端服务一起编排部署，适合全新环境的快速搭建：

yaml
version: '3.8'

services:
  deepstack:
    image: deepquestai/deepstack:latest
    container_name: deepstack
    ports:
      - "5000:5000"
    environment:
      - VISION-DETECTION=True
      - API-KEY=mysecretkey
    volumes:
      - deepstack_data:/datastore

  deepstack-ui:
    image: robmarkcole/deepstack-ui:latest
    container_name: deepstack-ui
    ports:
      - "8501:8501"
    environment:
      - DEEPSTACK_URL=http://deepstack:5000
      - DEEPSTACK_API_KEY=mysecretkey
    depends_on:
      - deepstack

volumes:
  deepstack_data:

启动服务：

bash
docker-compose up -d

访问与使用

部署完成后，打开浏览器访问 http://localhost:8501（或您配置的宿主机 IP 和端口）即可进入 Deepstack-UI 界面。在界面中上传图像，调整参数，即可查看 Deepstack 返回的目标检测结果。