跳转到内容
主页 / 工具包 / 显示
Display工具包服务

显示

将完整的 Linux 桌面流传输到任何浏览器。启动任何 X11 应用——Firefox、VS Code、GIMP、LibreOffice——并从 URL 访问它。采用 Xpra 驱动,支持 H264 硬件加速。无需 VNC 客户端、无需 RDP 客户端、无需桌面应用。只需一个浏览器标签。

display-1 — Hoody已连接 · H264
https://proj-dev-display-1.hoody.com/?sharing=true&encoding=h264
Firefox
code — main.py

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

alice
bob
1920 × 1080 · 2 个用户
H264 硬件加速·Xpra 会话·共享:2 个客户端·~2.3 Mbps
主页 / 工具包 / 显示 / 功能
工作原理

五种使用 Display 的方法

Display 适应你的工作方式。在标签页中运行完整的 Linux 桌面、与团队共享、以编程方式捕获、将其嵌入你自己的 UI 或针对低带宽链接进行调整——全部来自同一个 URL。

display-1

完整的 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

> ]

桌面1/5
主页 / 工具包 / 显示 / 参数
URL 参数

一个 URL,50+ 参数

显示会话的所有内容都由 URL 控制。下方翻转一个开关,URL 就会更新——然后打开它、将其嵌入 iframe 或发送给团队成员。

https://proj-dev-display-1.hoody.com/
打开

会话

谁可以连接、谁可以控制、断开时是否重新连接。

媒体 & 功能

声音、剪贴板同步、文件传输、打印——锁定或开放。

编码

运动采用 H264,平衡采用 WebP,无损采用 PNG,流量受限采用 JPEG。

带宽上限

每秒字节数的硬上限。0 表示无限制。

键盘布局

布局代码。在 macOS 上使用 swap_keys=true 进行 Cmd→Ctrl 映射。

[count, plural, =0 [无覆盖——使用默认值] one [应用了 # 个覆盖] other [应用了 # 个覆盖]]'
主页 / 工具包 / 显示 / API
HTTP API

每个像素都是一个 HTTP 响应

捕获屏幕截图、流式传输缩略图并使用查询参数配置会话。显示是可寻址、可观察且可以端到端编程的。

查看所有端点
display-api.sh

# 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。

display-1.hoody.com● ai-agent
POST /api/v1/display/screenshot → vision model

远程工作桌面

每个员工一个桌面,集中管理,可从任何设备访问。数据永远不会离开容器。在几秒内登录——共享一个 URL。

开发环境

Cursor、VS Code、JetBrains、完整浏览器——全部在容器中运行,不在笔记本电脑上。在 Chromebook 上打开 URL 并拥有一个资深工作站。

SaaS 桌面应用

将仅限 Linux 的软件交付到任何浏览器。遗留的 CAD 工具、科学应用、交易终端——将它们包装在容器中并按 URL 收费。

监控仪表板

320px 的缩略图让你在单一视图中平铺几十个实时桌面。每 5 秒刷新一次、标记异常、通过一次点击钻入完整显示。

共享演示

?sharing=true&readonly=true 将任何桌面变成广播。演示者驱动、观众观看——无需屏幕共享软件。

# broadcast URL
?sharing=true&readonly=true
8 2 1viewers / presenters / muted
主页 / 工具包 / 显示 / 端点
HTTP API

13 个端点,完全可观察性

屏幕截图、缩略图、会话元数据和健康检查。每个端点都返回结构化 JSON 或原始图像数据,支持持有者令牌身份验证。

屏幕截图

5 endpoints

curl .../screenshot -o frame.png → 1920x1080 PNG

GET
/api/v1/display/screenshot捕获全分辨率 PNG
GET
/api/v1/display/screenshot/last最后捕获的屏幕截图
GET
/api/v1/display/screenshot/:ts按时间戳查询历史屏幕截图
GET
/api/v1/display/screenshot/info捕获并仅返回元数据
GET
/api/v1/display/screenshot/last/info最新捕获的元数据

缩略图

5 endpoints

curl .../thumbnail/last → 320px preview JPEG

GET
/api/v1/display/thumbnail320px 预览,低带宽
GET
/api/v1/display/thumbnail/last最后的缩略图
GET
/api/v1/display/thumbnail/:ts历史缩略图
GET
/api/v1/display/thumbnail/info仅缩略图元数据
GET
/api/v1/display/thumbnail/last/info最新缩略图的元数据

信息 & 元数据

2 endpoints

curl .../display/info → {display: 1, screenshots: [...]}

GET
/api/v1/display/info显示 ID + 屏幕截图列表
GET
/api/v1/display/screenshots所有屏幕截图及元数据

健康状态

1 endpoint

curl .../health → {status: "ok"}

GET
/api/v1/health服务健康检查
主页 / 工具包 / 显示 / 更多
功能

一切内置

每个功能都已准备好使用。无需插件、无需驱动程序、无需客户端安装。

硬件加速

H264 视频编码在 2–5 Mbps 下实现流畅运动。JPEG 在 100–500 Kbps 下用于流量受限的链接。WebP、PNG 和原始 RGB 也都可用。

?encoding=h264?encoding=webp?encoding=jpeg?encoding=png

剪贴板同步

在你的笔记本电脑上复制,在远程桌面中粘贴——反之亦然。支持纯文本、富文本和 UTF-8 格式。

?clipboard=true?clipboard=false

触摸设备

点击、捏合缩放和两指滚动可开箱即用。在手机和平板电脑上添加 ?keyboard=true 以获得屏幕虚拟键盘。

?keyboard=true?swap_keys=true

自动重连

?reconnect=true 在 Wi-Fi 切换或笔记本电脑唤醒时恢复会话。桌面在你不在时在服务器端持续运行。

?reconnect=true

只读模式

?readonly=true 锁定输入以获得仅查看访问权限。非常适合仪表板、演示和分发演示链接。

?readonly=true?steal=false

功能标志

独立切换声音、打印、剪贴板和文件传输。锁定环境以提高安全性或删除功能以提高性能。

?sound=false?printing=false?file_transfer=false
主页 / 工具包 / 显示 / 开始

将桌面放入 URL

Display 是每个 Hoody 容器附带的 14 个工具包服务之一。无需安装程序、无需客户端、无需 VPN——只需一个浏览器标签。

阅读文档