热门搜索:

lensorai/docker-daheng-sdk

lensorai

包含Daheng Galaxy相机SDK（GiGE/U3版本）的轻量级Docker镜像，提供容器化相机驱动功能，可作为基础镜像或被复制到其他镜像中，最小化体积同时支持完整相机驱动功能。

下载次数: 0状态：社区镜像维护者：lensorai仓库类型：镜像最近更新：6 个月前

让 AI 帮你使用轩辕镜像？ · 展开查看说明

如果你用 DeepSeek、元宝AI、Copilot 等 AI 代为编写轩辕镜像的 docker pull、修改 compose 镜像地址，或排查拉取失败等问题，请让 AI 先读规则再动手，只要在 AI 对话里直接发送下面这句话即可：

生成 docker pull、修改 compose 的 image，或排查拉取失败前，请先阅读并严格遵守 https://xuanyuan.cloud/agents.md 中的规则。

国内用户首推元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。若 AI 无法访问外链，可打开说明文档复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。

镜像标签列表与下载命令

docker-daheng-sdk

包含Daheng Galaxy相机SDK（GiGE/U3版本）的最小Docker镜像，用于容器化相机驱动功能。该镜像设计为基础镜像或被复制到其他镜像中，在提供完整相机驱动支持的同时最小化体积。

概述

Daheng Galaxy SDK支持与千兆网视觉（GiGE Vision）和USB3视觉（USB3 Vision）相机通信。本仓库通过多阶段构建策略打包SDK，剥离不必要的构建产物，形成轻量级运行时镜像。

核心功能

最小镜像体积：多阶段构建通过排除构建工具和安装程序产物，减小最终镜像大小
多版本支持：通过.versions配置同时构建和标记多个SDK版本
硬件无关性：适用于任何符合GiGE或USB3 Vision标准的相机
易于集成：可将SDK库和配置复制到自己的镜像中
自动构建：Docker Hub钩子自动构建和推送所有配置版本

快速开始

拉取镜像

bash
docker pull lensorai/docker-daheng-sdk:latest

可用标签：

latest - 最新稳定SDK版本
2.4.2503 - 特定版本（或.versions中的任何版本）
提交SHA标签（用于可重现构建）

在自己的镜像中使用

要在自己的Docker镜像中使用Galaxy SDK，从该基础镜像复制必要的库和配置：

dockerfile
FROM lensorai/docker-daheng-sdk:latest AS sdk-base
FROM ubuntu:24.04

# 复制Galaxy SDK库
COPY --from=sdk-base /usr/lib/GxGVTL.cti /usr/lib/
COPY --from=sdk-base /usr/lib/GxU3VTL.cti /usr/lib/
COPY --from=sdk-base /usr/lib/libgxiapi.so /usr/lib/

# 复制安全限制配置
COPY --from=sdk-base /etc/security/limits.d/galaxy-limits.conf /etc/security/limits.d/

# 应用代码
COPY . /app
WORKDIR /app
CMD ["./your-app"]

本地构建

bash
cd balena/
docker build -t daheng-sdk:local .

构建特定SDK版本：

bash
docker build \
  --build-arg GALAXY_SDK_VERSION="Galaxy_Linux-x86_Gige-U3_32bits-64bits_2.4.2503.9201" \
  -t daheng-sdk:2.4.2503 \
  balena/

包含内容

最终镜像仅包含相机通信所需的最小库集：

文件	用途
`libgxiapi.so`	主要Galaxy SDK API库，用于相机控制和图像采集
`GxGVTL.cti`	千兆网视觉传输层，用于网络相机
`GxU3VTL.cti`	USB3视觉传输层，用于USB连接相机
`galaxy-limits.conf`	相机资源访问的安全限制配置

已移除的构建产物：

Galaxy SDK安装程序（Galaxy_camera.run）
安装文件和文档
构建工具（unzip）
包缓存

架构

多阶段构建流程

构建阶段（base）
- 下载并提取Galaxy SDK .zip文件
- 通过自动响应运行交互式安装程序
- 安装所需依赖（unzip）
- 生成系统库缓存（ldconfig）
最终阶段（final）
- 仅复制必要的运行时库
- 复制安全配置
- 丢弃所有构建产物
- 生成约50MB的最小镜像

构建上下文

Dockerfile路径：balena/Dockerfile
构建上下文：仓库根目录（/）
SDK源：files/目录（预存的.zip归档文件）

版本管理

当前版本

配置的版本列于.versions（每行一个）：

Galaxy_Linux-x86_Gige-U3_32bits-64bits_2.4.2503.9201

添加新SDK版本

下载Daheng Galaxy SDK并将.zip文件放入files/目录

更新.versions：

Galaxy_Linux-x86_Gige-U3_32bits-64bits_2.5.0000.0000   # 新版本（将标记为latest）
Galaxy_Linux-x86_Gige-U3_32bits-64bits_2.4.2503.9201   # 旧版本

（第一行成为latest标签）

推送到GitHub - Docker Hub钩子将自动构建所有版本

版本标记

每个版本获得三个标签：

版本标签（如2.4.2503）- 通过正则表达式从版本字符串提取
latest - 仅.versions中的第一个版本获得此标签
提交SHA - Git提交哈希（用于可重现构建）

Docker Hub集成

自动构建

本仓库使用Docker Hub自动构建和自定义钩子：

钩子脚本：balena/hooks/build和balena/hooks/push
Docker Hub仓库：https://hub.docker.com/r/lensorai/docker-daheng-sdk
构建触发：推送到development或main分支

配置

Docker Hub仓库设置：

Dockerfile路径：balena/Dockerfile
构建上下文：/（仓库根目录）

build钩子：

读取.versions文件
使用适当标签构建每个版本
将第一个版本标记为latest
为所有版本标记提交SHA

push钩子：

推送所有生成的标签
从构建镜像中提取版本标签

平台支持

架构：linux/amd64（为相机SDK二进制兼容性锁定）
基础OS：Ubuntu 24.04 LTS
内核：需要linux/amd64主机或QEMU模拟

技术细节

SDK安装程序响应

Galaxy SDK安装程序为交互式。通过以下方式自动响应：

bash
printf "\nY\nEn\n" | ./Galaxy_camera.run

\n - 跳过初始提示
Y - 接受许可协议
En - 选择英语语言

⚠️ 注意：更新SDK时，需验证这些提示在新版本中是否未改变。

安全限制配置

Galaxy SDK需要提升的资源限制。galaxy-limits.conf文件设置：

最大打开文件数
每用户最大进程数
相机操作的内存限制

该文件复制到最终镜像的/etc/security/limits.d/目录。

库依赖

三个库文件在Galaxy SDK中有特定用途：

libgxiapi.so - 核心API，用于：
- 相机发现和枚举
- 图像采集和流传输
- 参数控制和读写访问
- 事件处理
GxGVTL.cti - 支持与以下设备通信：
- 千兆网视觉相机（网络连接）
- 实现GENICAM标准传输层
GxU3VTL.cti - 支持与以下设备通信：
- USB3视觉相机（直接连接）
- USB连接设备的替代传输层

故障排除

相机未检测到

验证库是否正确复制到镜像中：

bash
docker run <image> ls -la /usr/lib/libgxiapi.so /usr/lib/Gx*VTL.cti

检查安全限制是否已配置：

bash
docker run <image> cat /etc/security/limits.d/galaxy-limits.conf

对于千兆网相机，确保网络访问：

bash
docker run --network host <image> # 必要时使用主机网络运行

安装期间构建失败

如果在执行Galaxy_camera.run期间构建失败：

验证files/中的.zip文件是否与GALAXY_SDK_VERSION参数匹配
检查.zip内的目录是否与版本字符串匹配
验证SDK版本支持安装程序响应（可能需要更新）

镜像体积大于预期

通过检查构建阶段进行调试：

bash
# 临时修改Dockerfile保留构建阶段
docker build \
  --target base \
  -t daheng-sdk:debug-base \
  balena/
  
docker run daheng-sdk:debug-base du -sh /usr/lib/*

开发与贡献

本地测试

本地构建镜像：

bash
cd balena/
docker build -t daheng-sdk:test .

测试相机访问：

bash
docker run --rm daheng-sdk:test ls -la /usr/lib/libgxiapi.so

修改构建

要添加依赖或修改构建过程：

编辑balena/Dockerfile
使用docker build本地测试
提交到GitHub
Docker Hub钩子将自动重建所有版本

添加新库

如需SDK中的其他运行时库：

在构建阶段使用apt-get安装
在最终阶段添加到COPY --from=base命令
在.github/copilot-instructions.md中更新新库用途

许可证

Galaxy SDK是Daheng的专有软件。本Docker镜像分发按原样提供，用于与Galaxy SDK兼容的应用集成。有关SDK许可，请参见Daheng的条款。

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问标签列表页面。

轩辕镜像加速拉取命令点我查看更多 docker-daheng-sdk 镜像标签

docker pull docker.xuanyuan.run/lensorai/docker-daheng-sdk:<标签>

使用方法：

DockerHub 原生拉取命令

docker pull lensorai/docker-daheng-sdk:<标签>

轩辕镜像配置手册

探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式

Docker 配置

登录仓库拉取

通过 Docker 登录认证访问私有仓库

用 AI 使用轩辕镜像

发给 Cursor、ChatGPT、豆包等 AI 的说明文档

专属域名拉取

无需登录使用专属域名

K8s Containerd

Kubernetes 集群配置 Containerd

K3s

K3s 轻量级 Kubernetes 镜像加速

Dev Containers

VS Code Dev Containers 配置

Podman

Podman 容器引擎配置

Singularity/Apptainer

HPC 科学计算容器配置

其他仓库配置

ghcr、Quay、nvcr 等镜像仓库

Harbor 镜像源配置

Harbor Proxy Repository 对接专属域名

Portainer 镜像源配置

Portainer Registries 加速拉取

Nexus 镜像源配置

Nexus3 Docker Proxy 内网缓存

系统配置

Linux

在 Linux 系统配置镜像服务

Windows/Mac

在 Docker Desktop 配置镜像

MacOS OrbStack

MacOS OrbStack 容器配置

Docker Compose

Docker Compose 项目配置

NAS 设备

群晖

Synology 群晖 NAS 配置

飞牛

飞牛 fnOS 系统配置镜像

绿联

绿联 NAS 系统配置镜像

威联通

QNAP 威联通 NAS 配置

极空间

极空间 NAS 系统配置服务

网络设备

爱快路由

爱快 iKuai 路由系统配置

宝塔面板

在宝塔面板一键配置镜像

需要其他帮助？请查看我们的常见问题Docker 镜像访问常见问题解答或提交工单

镜像拉取常见问题

使用与功能问题

配置了专属域名后，docker search 为什么会报错？

docker search 限制

Docker Hub 上有的镜像，为什么在轩辕镜像网站搜不到？

站内搜不到镜像

机器不能直连外网时，怎么用 docker save / load 迁镜像？

离线 save/load

docker pull 拉插件报错（plugin v1+json）怎么办？

插件要用 plugin install

WSL 里 Docker 拉镜像特别慢，怎么排查和优化？

WSL 拉取慢

轩辕镜像安全吗？如何用 digest 校验镜像没被篡改？

安全与 digest

第一次用轩辕镜像拉 Docker 镜像，要怎么登录和配置？

新手拉取配置

轩辕镜像合规吗？轩辕镜像的合规是怎么做的？

镜像合规机制

轩辕镜像支持 docker push 上传本地镜像吗？

不支持 push

错误码与失败问题

docker pull 提示 manifest unknown 怎么办？

manifest unknown

docker pull 提示 no matching manifest 怎么办？

no matching manifest（架构）

镜像已拉取完成，却提示 invalid tar header 或 failed to register layer 怎么办？

invalid tar header（解压）

Docker pull 时 HTTPS / TLS 证书验证失败怎么办？

TLS 证书失败

Docker pull 时 DNS 解析超时或连不上仓库怎么办？

DNS 超时

docker 无法连接轩辕镜像域名怎么办？

域名连通性排查

Docker 拉取出现 410 Gone 怎么办？

410 Gone 排查

出现 402 或「流量用尽」提示怎么办？

402 与流量用尽

Docker 拉取提示 UNAUTHORIZED（401）怎么办？

401 认证失败

遇到 429 Too Many Requests（请求太频繁）怎么办？

429 限流

docker login 提示 Cannot autolaunch D-Bus，还算登录成功吗？

D-Bus 凭证提示

为什么会出现「单层超过 20GB」或 413，无法加速拉取？

413 与超大单层

账号 / 计费 / 权限

轩辕镜像免费版和专业版有什么区别？

免费版与专业版区别

轩辕镜像支持哪些 Docker 镜像仓库？

支持的镜像仓库

镜像拉取失败还会不会扣流量？

失败是否计费

麒麟 V10 / 统信 UOS 提示 KYSEC 权限不够怎么办？

KYSEC 拦截脚本

如何在轩辕镜像申请开发票？

申请开发票（企业 / 个人）

怎么修改轩辕镜像的网站登录和仓库登录密码？

修改登录密码

如何注销轩辕镜像账户？要注意什么？

注销账户

配置与原理类

写了 registry-mirrors，为什么还是走官方或仍然报错？

mirrors 不生效

怎么用 docker tag 去掉镜像名里的轩辕域名前缀？

去掉域名前缀

如何拉取指定 CPU 架构的镜像（如 ARM64、AMD64）？

指定架构拉取

用轩辕镜像拉镜像时快时慢，常见原因有哪些？

拉取速度原因

为什么拉取镜像的 :latest 标签，拿到的往往不是「最新」镜像？

latest 与「最新」

查看全部问题→

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

"Docker访问体验非常流畅，大镜像也能快速完成下载。"