virtual-remote-desktop

🖥️ AI 自动化 + 人机协作,一键接管验证码

基于 KasmVNC 的无头 Linux 虚拟桌面,支持 AI 自动化与人机协作,专为验证码/风控场景设计,手机/电脑无缝接管。

收藏
7.8k
安装
2.3k
版本
1.0.2
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心功能

Virtual Remote Desktop 是一款专为 AI 自动化工作流设计的远程桌面解决方案,基于 KasmVNC 构建,替代传统的 x11vnc+noVNC 方案。其核心定位是解决"AI 自动化为主、人工干预为辅"的混合场景——当浏览器自动化流程遇到验证码、风控检测或 MFA 二次认证时,用户可快速接管操作 1-3 分钟,完成后 AI 自动恢复执行。

显著优势

1. 双模式灵活适配

  • 需求驱动式启动:通过交互式脚本确认用户设备类型(手机/电脑)、网页渲染模式(移动端/桌面端)、网络质量及访问方式,自动生成最优配置
  • 环境变量直启:支持 AUTO_LAUNCH_URLBROWSER_MOBILE_MODEMOBILE_PRESET 等参数精细控制,满足程序化调用场景

2. 移动端深度优化

  • MOBILE_MODE 优化 VNC 流传输尺寸(960x540 手机/1280x720 平板),弱网环境下可进一步降帧
  • BROWSER_MOBILE_MODE 实现浏览器级别的设备模拟(UA、viewport、触摸行为),区别于单纯的画面压缩

3. 安全架构

  • 默认 KASM_BIND=127.0.0.1 本地绑定,强制 SSH 隧道访问
  • 支持临时公网暴露(0.0.0.0),配合 AUTO_STOP_IDLE_SECS 自动销毁,最小化攻击面
  • KasmVNC 原生 HTTPS + 独立用户认证

4. 自动化无缝衔接
提供 computer-use 风格动作脚本集:截图(base64 输出)、点击、输入、按键、滚动、光标定位等,AI 可通过 shell 调用实现"截图→分析→操作→验证"闭环。

局限性与注意事项

  • 单用户并发:KasmVNC 设计为单会话模式,不支持多用户同时操作
  • 图形性能:轻量级 fluxbox 桌面 + 软件渲染,不适合 GPU 密集型应用
  • 网络依赖:流畅体验需稳定连接,极端弱网建议降低 KASM_MAX_FPS 至 18 以下
  • 认证状态管理:浏览器 profile 持久化需手动配置 CHROME_PROFILE_DIR,高频率验证码场景建议保持长会话以减少重复挑战

适用人群

  • 自动化测试工程师:处理反爬虫、验证码拦截等异常分支
  • RPA 开发者:需要人机协作模式的流程编排
  • 运维人员:安全可控的远程应急接管方案
  • AI Agent 构建者:实现"自动-人工-自动"状态机的工作流

常规风险

| 风险类型 | 描述 | 缓解措施 |
|---------|------|---------|
| 公网暴露 | `0.0.0.0` 绑定可能遭遇扫描攻击 | 严格限制 `AUTO_STOP_IDLE_SECS`,配合防火墙规则 |
| 凭证泄露 | 用户名/密码在协作中传递 | 使用一次性凭据,会话结束后立即销毁 |
| 会话劫持 | VNC 协议若未走隧道可能被中间人攻击 | 强制 HTTPS + SSH 隧道,禁用明文 HTTP |
| 资源耗尽 | 空闲会话未清理导致内存占用 | 默认 15 分钟自动停止,可按需调整 |
| 浏览器指纹 | 长周期 profile 可能积累追踪特征 | 定期清理或轮换 `CHROME_PROFILE_DIR` |

virtual-remote-desktop 内容

.clawhub文件夹
scripts文件夹
手动下载zip · 17.6 kB
origin.jsonapplication/json
请选择文件