显示
将完整的 Linux 桌面流传输到任何浏览器。启动任何 X11 应用——Firefox、VS Code、GIMP、LibreOffice——并从 URL 访问它。采用 Xpra 驱动,支持 H264 硬件加速。无需 VNC 客户端、无需 RDP 客户端、无需桌面应用。只需一个浏览器标签。
1 import requests
2
3 r = requests.get(
4 '.../screenshot'
5 )
6 with open('f.png', 'wb') as f:
7 f.write(r.content)
8 # 1920x1080 PNG
五种使用 Display 的方法
Display 适应你的工作方式。在标签页中运行完整的 Linux 桌面、与团队共享、以编程方式捕获、将其嵌入你自己的 UI 或针对低带宽链接进行调整——全部来自同一个 URL。
完整的 Linux 桌面
在沙箱容器中运行任何 X11 应用——浏览器、IDE、图像编辑器——并将其流传输到浏览器标签。无需 VNC、无需 RDP、无需原生客户端。
# 前 / 后
- vncviewer user@server:5901(安装客户端、开放端口)
+ 打开 https://display-1.hoody.com——在任何设备上都可以使用
# 检查显示是否可用
$ curl /api/v1/health
> ["status": "ok"]
# 检查会话
$ curl /api/v1/display/info
> [
> "display": 1,
> "resolution": "1920x1080",
> "encoding": "h264",
> "clients": 1
> ]
一个 URL,50+ 参数
显示会话的所有内容都由 URL 控制。下方翻转一个开关,URL 就会更新——然后打开它、将其嵌入 iframe 或发送给团队成员。
会话
谁可以连接、谁可以控制、断开时是否重新连接。
媒体 & 功能
声音、剪贴板同步、文件传输、打印——锁定或开放。
编码
运动采用 H264,平衡采用 WebP,无损采用 PNG,流量受限采用 JPEG。
带宽上限
每秒字节数的硬上限。0 表示无限制。
键盘布局
布局代码。在 macOS 上使用 swap_keys=true 进行 Cmd→Ctrl 映射。
# Capture the live desktop as a PNG
curl -X GET \
https://proj-dev-display-1.hoody.com/api/v1/display/screenshot \
-H "Authorization: Bearer $TOKEN" \
-o frame.png
# Or get base64 + metadata in JSON
curl "https://proj-dev-display-1.hoody.com/api/v1/display/screenshot?base64=true" \
-H "Authorization: Bearer $TOKEN"
# Response:
# {
# "image": { "data": "iVBORw0KG..." },
# "info": {
# "full": { "width": 1920, "height": 1080 },
# "timestamp": "1730659200000"
# }
# }
按需桌面
一个 URL 可寻址的桌面开辟了以前从不实用的工作流。无需安装、无需客户端、无需操作系统锁定。
AI 计算机使用
能够点击、输入和读取像素的代理。截图 API 提供视觉模型;键盘和鼠标是 HTTP。给 Claude 或 GPT 一个完整的 Linux 桌面 URL。
远程工作桌面
每个员工一个桌面,集中管理,可从任何设备访问。数据永远不会离开容器。在几秒内登录——共享一个 URL。
开发环境
Cursor、VS Code、JetBrains、完整浏览器——全部在容器中运行,不在笔记本电脑上。在 Chromebook 上打开 URL 并拥有一个资深工作站。
SaaS 桌面应用
将仅限 Linux 的软件交付到任何浏览器。遗留的 CAD 工具、科学应用、交易终端——将它们包装在容器中并按 URL 收费。
监控仪表板
320px 的缩略图让你在单一视图中平铺几十个实时桌面。每 5 秒刷新一次、标记异常、通过一次点击钻入完整显示。
共享演示
?sharing=true&readonly=true 将任何桌面变成广播。演示者驱动、观众观看——无需屏幕共享软件。
13 个端点,完全可观察性
屏幕截图、缩略图、会话元数据和健康检查。每个端点都返回结构化 JSON 或原始图像数据,支持持有者令牌身份验证。
屏幕截图
5 endpointscurl .../screenshot -o frame.png → 1920x1080 PNG
缩略图
5 endpointscurl .../thumbnail/last → 320px preview JPEG
信息 & 元数据
2 endpointscurl .../display/info → {display: 1, screenshots: [...]}
健康状态
1 endpointcurl .../health → {status: "ok"}
一切内置
每个功能都已准备好使用。无需插件、无需驱动程序、无需客户端安装。
硬件加速
H264 视频编码在 2–5 Mbps 下实现流畅运动。JPEG 在 100–500 Kbps 下用于流量受限的链接。WebP、PNG 和原始 RGB 也都可用。
剪贴板同步
在你的笔记本电脑上复制,在远程桌面中粘贴——反之亦然。支持纯文本、富文本和 UTF-8 格式。
触摸设备
点击、捏合缩放和两指滚动可开箱即用。在手机和平板电脑上添加 ?keyboard=true 以获得屏幕虚拟键盘。
自动重连
?reconnect=true 在 Wi-Fi 切换或笔记本电脑唤醒时恢复会话。桌面在你不在时在服务器端持续运行。
只读模式
?readonly=true 锁定输入以获得仅查看访问权限。非常适合仪表板、演示和分发演示链接。
功能标志
独立切换声音、打印、剪贴板和文件传输。锁定环境以提高安全性或删除功能以提高性能。