P
psyb0t/docker-auto-linux-desk
Full Linux desktop automation in Docker.
更新 2026-11-19
在 GitHub 查看 ↗直链 · 无中转页
官方说明Full Linux desktop automation in Docker. An Xvfb + Openbox desktop you drive over a JSON HTTP API and MCP server: humanized OS-level mouse and keyboard input, window control, keyboard shortcuts, app launching, shell commands, screenshots and screen recording. Watch it live via noVNC. Base image for
装完之后怎么算装好了
- 装完该看到什么 — 命令正常结束时退出码为 0,终端里没有 "command not found" 或 "permission denied"。
- 一行自检 — 按该仓库 README 里给出的最小用法跑一次;能按 README 的描述输出就是通了。
- 答不出来怎么办 — 这个项目没有写排错说明,去仓库的 Issues 搜 install。
安装命令取自该仓库;以上判据只描述可观察到的结果,不替代项目自己的文档。
- ★ 数取值
- 0 ★ · psyb0t/docker-auto-linux-desk · 取自 GitHub 搜索 API · (2026-11-19 20:00:48 核对)
- 来源明细
- 从该仓库的 GitHub 页面直接读取 · 条目类型:开源项目
- 收录与活跃
- 收录于 2026-11-20 · 最近见到 2026-11-20 · 共见到 1 次 · 被 1 个来源列出
- 评分构成
- 综合分 103 · 1 个来源 · repo
- 安装
- 安装命令见上方「安装与配置」。
常见问题(答案都来自我们的记录)
它适合谁 / 用来做什么?
我们把它归在这些标签下: 开源项目。标签来自条目自身,不是我们强加的分类。
谁维护它、还在更新吗?
仓库
psyb0t/docker-auto-linux-desk;我们收录于 2026-11-20;最近见到 2026-11-20。这里没有"官方认证"或"质量评级"——我们只记录来源与时间。README 原文(英文,未翻译) · 在 GitHub 读完整 README →
# auto-linux-desk
以下摘录自该仓库的 README(片段)
A virtual Linux desktop in Docker that you drive over HTTP or MCP. One container runs Xvfb, the Openbox window manager, a noVNC viewer and an API that moves the real mouse with human motion, types with human rhythm, presses window manager shortcuts, arranges windows, starts programs, runs shell commands, reads and writes the clipboard, takes screenshots and records the screen.
Use it as it is for Linux desktop automation, or build your own image on it: a plugin adds actions for the software you install, such as a browser.
## Contents
Quick start
How it works
What it can do
Agent integrations
Script mode
Building on it
Configuration and security
Documentation
Development
Sponsor
License
## Quick start
bash
docker run -d --name desk \
-p 127.0.0.1:8080:8080 \
-p 127.0.0.1:5900:5900 \
psyb0t/auto-linux-desk
Open http://localhost:5900/ to watch the screen. Port 8080 serves the HTTP API and the MCP endpoint at /mcp/.
bash
# Open a terminal with the window manager shortcut
curl -X POST http://localhost:8080 \
-H "Content-Type: application/json" \
-d '{
"action": "send_key",
"key": "ctrl+alt+t"
}'
# Type into it with human keystrokes
curl -X POST http://localhost:8080 \
-H "Content-Type: application/json" \
-d '{
"action": "system_type",
"text": "uname -a\n"
}'
# Or run a command directly
curl -X POST http://localhost:8080 \
-H "Content-Type: application/json" \
-d '{
"action": "run_command",
"command": "ls -la /userdata"
}'
# Look at the screen
curl "http://localhost:8080/screenshot/desktop?whLargest=512" -o desk.png
The example keeps both ports on loopback. Read configuration and security before making them reachable from another machine.
## How it works
One container owns one desktop. HTTP requests and MCP tools call the same action dispatcher; run_script keeps several steps under one request lock. The noVNC viewer shows the same screen the agent controls.
| Component | Purpose |
| Xvfb and Openbox | Virtual screen, windows, focus, tiling and keyboard shortcuts. |
| PyAutoGUI and XTest | OS-level mouse, keyboard and wheel input with humanized motion and timing. |
| D-Bus and AT-SPI2 | Read and act on widgets that desktop apps expose to accessibility clients. |
| HTTP API and MCP | Control the desktop on port 8080; MCP uses /mcp/. |
| x11vnc and noVNC | Watch and control the desktop in a browser on port 5900. |
| ffmpeg, scrot and xclip | MP4 recordings, PNG screenshots and the shared X11 clipboard. |
## What it can do
| Area | Actions |
| Mouse | system_click, system_double_click, system_right_click, mouse_click, mouse_move, system_hover, system_mouse_down, system_mouse_up, system_drag, scroll, human_pause |
| Keyboard | paste_text, system_type, send_key |
| Keyboard shortcuts | One complete key map with no Super-key bindings: half and quarter tiling, maximize, fullscreen, minimize, close, focus by app, by number and by direction, terminal. desktop_keybindings lists it, and KEYBINDINGS_FILE replaces it |
| Accessibility tree | desktop_accessibility_tree, desktop_accessibility_find and desktop_accessibility_action read and act on controls an app exposes through AT-SPI2, like uiautomator |
Use it as it is for Linux desktop automation, or build your own image on it: a plugin adds actions for the software you install, such as a browser.
## Contents
Quick start
How it works
What it can do
Agent integrations
Script mode
Building on it
Configuration and security
Documentation
Development
Sponsor
License
## Quick start
bash
docker run -d --name desk \
-p 127.0.0.1:8080:8080 \
-p 127.0.0.1:5900:5900 \
psyb0t/auto-linux-desk
Open http://localhost:5900/ to watch the screen. Port 8080 serves the HTTP API and the MCP endpoint at /mcp/.
bash
# Open a terminal with the window manager shortcut
curl -X POST http://localhost:8080 \
-H "Content-Type: application/json" \
-d '{
"action": "send_key",
"key": "ctrl+alt+t"
}'
# Type into it with human keystrokes
curl -X POST http://localhost:8080 \
-H "Content-Type: application/json" \
-d '{
"action": "system_type",
"text": "uname -a\n"
}'
# Or run a command directly
curl -X POST http://localhost:8080 \
-H "Content-Type: application/json" \
-d '{
"action": "run_command",
"command": "ls -la /userdata"
}'
# Look at the screen
curl "http://localhost:8080/screenshot/desktop?whLargest=512" -o desk.png
The example keeps both ports on loopback. Read configuration and security before making them reachable from another machine.
## How it works
One container owns one desktop. HTTP requests and MCP tools call the same action dispatcher; run_script keeps several steps under one request lock. The noVNC viewer shows the same screen the agent controls.
| Component | Purpose |
| Xvfb and Openbox | Virtual screen, windows, focus, tiling and keyboard shortcuts. |
| PyAutoGUI and XTest | OS-level mouse, keyboard and wheel input with humanized motion and timing. |
| D-Bus and AT-SPI2 | Read and act on widgets that desktop apps expose to accessibility clients. |
| HTTP API and MCP | Control the desktop on port 8080; MCP uses /mcp/. |
| x11vnc and noVNC | Watch and control the desktop in a browser on port 5900. |
| ffmpeg, scrot and xclip | MP4 recordings, PNG screenshots and the shared X11 clipboard. |
## What it can do
| Area | Actions |
| Mouse | system_click, system_double_click, system_right_click, mouse_click, mouse_move, system_hover, system_mouse_down, system_mouse_up, system_drag, scroll, human_pause |
| Keyboard | paste_text, system_type, send_key |
| Keyboard shortcuts | One complete key map with no Super-key bindings: half and quarter tiling, maximize, fullscreen, minimize, close, focus by app, by number and by direction, terminal. desktop_keybindings lists it, and KEYBINDINGS_FILE replaces it |
| Accessibility tree | desktop_accessibility_tree, desktop_accessibility_find and desktop_accessibility_action read and act on controls an app exposes through AT-SPI2, like uiautomator |
收录徽章(可选)
想把收录标记放进 README 就复制这行,可选,不影响收录。
[](https://anclum.com/zh/s/psyb0t-docker-auto-linux-desk/)
- 来源
- github · https://github.com/psyb0t/docker-auto-linux-desk
- 按领域浏览
- 开源项目
- 收录于
- 今天
更多条目
所属领域与标签
每个标签都能点进去看同类的全部条目。数字是当前库里的真实条数。