emptysuns/scrcpy-web 将 scrcpy 封装为 Web 服务，用户通过浏览器查看并操作已 adb 连接的 Android 设备。容器需访问 USB 设备或网络 adb（adb connect），通常 --privileged 或挂载 /dev/bus/usb，并增大 /dev/shm。镜像含实时 GUI 与 WebSocket 流，不适合常规 Kubernetes Deployment——会话状态、设备独占与低延迟要求更适合单节点 Docker 或专用 VM；若内网使用应限制 IP 并启用认证。

快速启动

docker run -d --name scrcpy-web \
  --privileged \
  -p 8000:8000 \
  -v /dev/bus/usb:/dev/bus/usb \
  docker.io/emptysuns/scrcpy-web:latest

推荐实践

docker run -d --name scrcpy-web \
  --restart unless-stopped \
  --privileged \
  -p 127.0.0.1:8000:8000 \
  --shm-size=512m \
  -v /dev/bus/usb:/dev/bus/usb \
  docker.io/emptysuns/scrcpy-web:latest

核心参数说明

• --privileged — 访问 USB adb 设备
• -v /dev/bus/usb — 挂载 USB 总线
• -p 127.0.0.1:8000:8000 — 仅本机访问 Web UI
• --shm-size=512m — 视频缓冲共享内存
• --restart unless-stopped — 调试环境持续可用
• 禁止 K8s — GUI/设备独占，勿多副本 Deployment