Windows下Docker容器内调用摄像头并使用cv2的问题求助

一、针对WSL2后端的Docker（推荐，兼容性更好） #

• 先在Windows端安装usbipd-win工具，实现Windows USB设备（摄像头）向WSL2的共享
  打开管理员权限的PowerShell，执行：

  winget install usbipd-win
  

• 列出Windows上的USB设备，找到摄像头对应的总线ID：

  usbipd wsl list
  

• 将摄像头绑定到目标WSL2发行版（以Ubuntu为例）：

  usbipd wsl attach --busid <设备总线ID> --distribution Ubuntu
  

  注意：电脑重启后需重新执行此绑定命令
• 启动Docker容器时，挂载设备目录并赋予特权：

  docker run -it --rm --device=/dev/video0:/dev/video0 --privileged <你的镜像名>
  

二、针对Hyper-V后端的Docker #

• 打开Hyper-V管理器，找到Docker对应的虚拟机（通常为DockerDesktopVM）
• 右键虚拟机→设置→硬件→添加硬件→选择“USB设备”，添加你的摄像头
• 启动容器时挂载设备并加特权：

  docker run -it --rm --device=/dev/video0:/dev/video0 --privileged <你的镜像名>
  

三、cv2测试代码（验证摄像头可用性） #

带图形界面验证（需容器支持图形输出或X11转发） #

import cv2

cap = cv2.VideoCapture(0)
if not cap.isOpened():
    print("无法打开摄像头")
    exit()

while True:
    ret, frame = cap.read()
    if not ret:
        print("无法获取帧")
        break
    
    cv2.imshow('Camera Feed', frame)
    if cv2.waitKey(1) & 0xFF == ord('q'):
        break

cap.release()
cv2.destroyAllWindows()

无图形界面验证（保存为图片） #

import cv2

cap = cv2.VideoCapture(0)
ret, frame = cap.read()
if ret:
    cv2.imwrite('test_camera.jpg', frame)
    print("摄像头捕获成功，已保存test_camera.jpg")
else:
    print("捕获失败")
cap.release()

四、常见问题排查 #

• 可见/dev/video0但无法使用：优先确认启动容器时添加了--privileged参数，或在容器内执行chmod 666 /dev/video0手动赋予权限
• WSL2下绑定设备后无/dev/video0：执行wsl --shutdown重启WSL2，重新绑定设备后重试
• cv2报错CAP_V4L: error opening /dev/video0：检查摄像头是否被Windows本地程序占用（如相机应用），或设备是否正确绑定到WSL2/Hyper-V

内容的提问来源于stack exchange，提问作者A.Y B