octop v0.9.20远程桌面非传统rdp/vnc,而是ai助手平台的可视化交互扩展,依托xvfb/xorg等轻量桌面环境实现“实时看屏+键鼠操控”,为ai agent提供图形界面沙箱,仅linux可托管被控端,需手动启用octop-remote-desktop插件并配置display、分辨率及token认证,web界面一键访问,默认限于本地回环,安全隔离各工作区会话。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Octop v0.9.20 的远程桌面功能不是传统意义上的“开启RDP/VNC服务”,而是作为其 AI 助手平台的一个可视化交互扩展能力,依赖底层隔离桌面环境(如基于 Xvfb、Xorg 或 Wayland 的轻量桌面会话)实现“实时看屏 + 键鼠操控”。它不替代系统级远程桌面服务,而是为 AI Agent 提供可操作的图形界面沙箱。
确认运行环境支持
Octop 的远程桌面模块需运行在具备图形能力或能模拟图形环境的 Linux 主机上(Windows/macOS 当前仅支持作为客户端查看,不支持托管被控桌面):
- 确保系统已安装基础桌面组件(如
ubuntu-desktop、xfce4或最小化x11-xserver-utils+xvfb) - 若使用无头服务器(无显卡/无显示器),推荐启用
Xvfb虚拟帧缓冲:sudo apt install xvfb - 检查当前用户是否具备启动 GUI 会话权限(避免以 root 启动 Octop 后无法创建显示会话)
启用并配置远程桌面插件
该功能由独立插件 octop-remote-desktop 提供,需手动启用:
- 进入 Octop 工作目录,执行:
octop plugin enable remote-desktop - 编辑插件配置文件:
~/.octop/plugins/remote-desktop/config.yaml
设置关键参数:-
display: ":99"(指定虚拟显示号,与 Xvfb 一致) resolution: "1280x720"-
enable_keyboard: true和enable_mouse: true -
auth_mode: "token"(默认 Token 验证,非密码登录)
-
- 保存后重启 Octop:
octop restart
从 Web 界面访问远程桌面
启动成功后,无需额外客户端软件:
- 打开浏览器,访问 Octop Web UI(如
http://localhost:3000) - 登录后,在左侧导航栏点击 “远程桌面”(图标为显示器+鼠标)
- 首次访问将自动生成一次性连接 Token,并自动拉起嵌入式桌面视图
- 支持鼠标点击、键盘输入、拖拽窗口;画面延迟取决于网络与主机性能,建议局域网使用
安全与限制说明
该功能默认仅监听本地回环(127.0.0.1),不对外暴露端口:
- 如需远程访问(非 localhost),需配合反向代理(如 Nginx)并启用 HTTPS + Basic Auth
- 不兼容 Wayland 原生会话(Ubuntu 22.04+/24.04 默认),务必在登录界面选择 “Ubuntu on Xorg”
- 每个工作区独享独立桌面会话,不同用户/Agent 不共享屏幕,记忆与操作上下文完全隔离











