al42and/debian-opencv2

Debian-OpenCV2镜像说明

镜像概述

本Docker镜像基于最新稳定版Debian系统，集成OpenCV 2.4、Python 2.7及常用Python包，同时提供Jupyter Notebook、SSH X转发、VNC远程桌面等多种图形交互方式，为计算机视觉相关的开发、测试与学习提供便捷环境。

核心功能

1. 基础环境：Debian稳定版 + OpenCV 2.4 + Python 2.7
2. 图形交互：支持Jupyter Notebook、SSH X图形转发、VNC远程桌面
3. 灵活部署：支持目录挂载、端口映射等Docker标准操作

使用场景

• 计算机视觉算法原型开发与验证
• 教学场景中的OpenCV实践操作
• 需要图形输出的Python 2.7项目测试

配置说明

安装Docker

Ubuntu系统

bash
sudo apt install docker.io
sudo usermod -aG docker $(whoami)

注：重新登录前，所有docker命令需前缀sudo。

Windows系统

从https://www.docker.com/products/docker-toolbox%E4%B8%8B%E8%BD%BD%E5%AE%89%E8%A3%85%E5%8C%85%EF%BC%8C%E8%BF%90%E8%A1%8C%22Docker Quick-start Terminal"完成初始化。也可尝试"Docker for Windows"，但需注意系统兼容性。

镜像使用

1. 拉取镜像：

bash
docker pull al42and/debian-opencv2:latest

镜像大小约1GiB。

2. 目录挂载（可选）： 使用-v参数绑定主机目录到容器内：

bash
docker run -v $(pwd):/app al42and/debian-opencv2

Linux系统可能因用户ID差异导致权限问题。

Jupyter Notebook使用

• 基础启动：

bash
docker run -p 9999:9999 -dt al42and/debian-opencv2 run_jupyter

浏览器访问http://localhost:9999/即可使用。

• Linux/MacOS下Jupyter结合X图形：

bash
XSOCK=/tmp/.X11-unix
XAUTH=/tmp/.docker.xauth
xauth nlist :0 | sed -e 's/^..../ffff/' | xauth -f $XAUTH nmerge -
docker run -p 9999:9999 -dt -v $XSOCK:$XSOCK -v $XAUTH:$XAUTH -e XAUTHORITY=$XAUTH -e DISPLAY=$DISPLAY al42and/debian-opencv2 run_jupyter

此方式可直接在Jupyter中显示OpenCV视频或Matplotlib动画。

SSH X转发使用

• 启动容器：

bash
docker run -p 2222:22 -dt al42and/debian-opencv2 run_ssh

• Linux/MacOS连接：

bash
ssh -X root@localhost -p2222

密码为1234。

• Windows连接：
  1. 运行docker-machine ip default获取Docker虚拟机IP；
  2. 安装https://sourceforge.net/projects/xming/%EF%BC%8C%E9%80%9A%E8%BF%87XLaunch%E8%BF%9E%E6%8E%A5%E5%88%B0%E4%B8%8A%E8%BF%B0IP%E7%9A%842222%E7%AB%AF%E5%8F%A3%EF%BC%8C%E7%94%A8%E6%88%B7%E5%90%8D%60root%60%EF%BC%8C%E5%AF%86%E7%A0%81%601234%60%E3%80%82

VNC使用

• 启动容器：

bash
docker run -p 5900:5900 -dt al42and/debian-opencv2 run_vnc

使用VNC客户端连接localhost:5900，密码1234。

镜像构建

bash
docker build -t al42and/debian-opencv2 --no-cache .

已知问题

1. MacOS：证书路径不存在
   参考：https://stackoverflow.com/questions/38285282/where-is-the-certificates-folder-for-docker-beta-for-mac
2. 导入cv2时出现libdc1394 error: Failed to initialize libdc1394
   可忽略此错误，不影响功能使用。