问题描述#
在 Instabox 上创建的云桌面（VNC + XFCE）存在鼠标功能完全失效的问题：
- 鼠标指针完全不可见
- 左键和右键点击均无反应
- 键盘输入正常
根本原因#
TigerVNC 的指针输入设备（TigerVNC pointer）被禁用，且处于 floating slave（浮动从属）状态，没有正确连接到 X11 的主指针设备（Virtual core pointer）。
验证方法：
xinput list正常状态下应显示：
⎡ Virtual core pointer id=2 [master pointer (3)]
⎜ ↳ Virtual core XTEST pointer id=4 [slave pointer (2)]
⎜ ↳ TigerVNC pointer id=6 [slave pointer (2)] ← 应该是 slave 而非 floating
⎣ Virtual core keyboard id=3 [master keyboard (2)]
↳ Virtual core XTEST keyboard id=5 [slave keyboard (3)]
↳ TigerVNC keyboard id=7 [slave keyboard (3)]有问题时 TigerVNC pointer 显示为：
∼ TigerVNC pointer id=6 [floating slave]且设备被禁用：
xinput list-props "TigerVNC pointer" | grep "Device Enabled"
# Device Enabled (117): 0 ← 0 表示禁用修复步骤#
方法一：通过 SSH 或终端命令修复（临时修复）#
连接到机器终端（SSH 或 Web Terminal）
执行修复命令：
# 1. 重新附加 TigerVNC pointer 到主指针设备
xinput reattach "TigerVNC pointer" 2
# 2. 启用指针设备
xinput enable "TigerVNC pointer"
# 3. 验证修复结果
xinput list
xinput list-props "TigerVNC pointer" | grep "Device Enabled"- 验证鼠标功能：
# 移动鼠标到 (100, 100)
xdotool mousemove 100 100
# 获取当前鼠标位置
xdotool getmouselocation方法二：持久化修复（推荐）#
创建自动启动脚本，确保每次重启后自动修复。
2.1 创建 XFCE 自动启动项#
mkdir -p ~/.config/autostart
cat > ~/.config/autostart/fix-vnc-input.desktop << 'EOF'
[Desktop Entry]
Type=Application
Name=Fix VNC Input
Exec=xinput enable "TigerVNC pointer"
X-GNOME-Autostart-enabled=true
EOF2.2 添加到 .xsessionrc（会话启动时执行）#
cat >> ~/.xsessionrc << 'EOF'
# Fix VNC pointer device being disabled
if command -v xinput >/dev/null 2>&1; then
xinput enable "TigerVNC pointer" 2>/dev/null || true
xinput reattach "TigerVNC pointer" 2 2>/dev/null || true
fi
EOF方法三：通过 Instabox API 修复（无 SSH 时）#
如果无法直接访问终端，可以通过 Instabox 的 exec API 执行命令：
# 替换 MACHINE_ID 和 CSRF_TOKEN
curl -X POST 'https://api.instabox.sh/v1/machines/MACHINE_ID/exec' \
-H 'Content-Type: application/json' \
-H 'X-Instabox-CSRF: CSRF_TOKEN' \
-d '{"cmd": "xinput enable \"TigerVNC pointer\" && xinput reattach \"TigerVNC pointer\" 2"}'验证修复是否成功#
- 检查设备状态：
xinput list | grep TigerVNC
# 应显示为 slave pointer，而非 floating slave- 检查设备是否启用：
xinput list-props "TigerVNC pointer" | grep "Device Enabled"
# 应显示 Device Enabled (117): 1- 实际测试鼠标移动：
# 先将鼠标移到原点
xdotool mousemove 0 0
# 然后通过 VNC 移动鼠标，再检查位置
xdotool getmouselocation
# 如果 x,y 坐标变化了，说明鼠标输入正常工作相关诊断命令#
# 查看所有输入设备
xinput list
# 查看 TigerVNC pointer 的属性
xinput list-props "TigerVNC pointer"
# 查看 Xvnc 进程
ps aux | grep Xvnc
# 查看 VNC 日志
tail -50 /tmp/instabox-xvnc.log
# 查看 XFCE 日志
tail -30 /tmp/instabox-xfce.log
# 测试鼠标事件（需要手动移动鼠标）
xinput test-xi2 --root
# 用 xdotool 模拟鼠标操作
xdotool mousemove 100 100 click 1补充说明#
- 此问题仅影响鼠标输入，键盘输入正常
- TigerVNC keyboard 设备默认是启用的，无需修复
- 建议在新机器创建后立即应用持久化修复，避免每次重启后都要手动修复
- 如果使用的是 suspend/resume 而非完整重启，设备状态可能会保留，无需重新修复
