jsntwdj/virtualhere-server repository overview

⁠VirtualHere USB Server Docker 容器

一个用于运行 VirtualHere USB Server 的 Docker 容器，包含预下载的二进制文件，支持多种架构并配有专用的 Dockerfile。

⁠功能特点

• 🚀 预下载的二进制文件 - 构建时使用已下载特定架构的二进制文件
• 🏗️ 多架构支持 - 分别为 AMD64、ARM64、ARM 提供独立的

⁠快速开始

⁠多架构镜像

根据您的系统选择适当的镜像：

services:
  virtualhere:
    image: virtualhere-server:latest
    container_name: virtualhere
    volumes:
      - /dev/bus/usb:/dev/bus/usb
      - ./data:/data
    devices:
      - /dev:/dev
    restart: unless-stopped
    network_mode: "host"

⁠Docker Hub 和 GitHub Container Registry

⁠故障排除

⁠容器无法启动

1. 检查容器是否有 USB 访问权限：

   docker exec virtualhere lsusb
   

   Copy

2. 验证 USB 设备是否已挂载：

   ls -la /dev/bus/usb/
   

   Copy

⁠未检测到 USB 设备

1. 确保主机已连接 USB 设备
2. 检查容器是否以 --privileged 或适当的设备访问权限运行
3. 验证主机系统的 udev 规则

⁠连接问题

1. 检查端口 7575 是否可访问：

   netstat -tuln | grep 7575
   

   Copy

2. 验证主机的防火墙设置

3. 从 VirtualHere 客户端测试连接

⁠日志和调试

# 查看容器日志
docker logs virtualhere

# 交互式 shell 访问
docker exec -it virtualhere /bin/bash

# 检查运行中的进程
docker exec virtualhere ps aux

⁠许可证

本项目基于 MIT 许可证 - 详见 LICENSE⁠ 文件。

⁠致谢

• VirtualHere⁠ 提供优秀的 USB 共享软件
• Docker 社区提供的最佳实践和工具

⁠支持

• 📖 VirtualHere 文档⁠
• 🐛 报告问题⁠
• 💬 讨论区⁠