公益 · 免费 · 永久免费

SamVNC

把任何桌面变成浏览器可访问的远程桌面。支持 X11/GDI 屏幕捕获、键盘鼠标输入注入、Chrome CDP 自动化。一行命令安装,浏览器远程桌面。

为什么选择 SamVNC

基于 aitun.cc 隧道,无需公网 IP。启动即获得公网 HTTPS URL,在浏览器里直接控制远程桌面和 Chrome。

🌐
浏览器远程桌面
在任意浏览器打开公网 URL,即可看到远程桌面画面。支持 X11(Linux)和 GDI(Windows)屏幕捕获,实时帧率可调。
键盘鼠标输入
通过 WebSocket 实时注入键盘和鼠标事件。Linux 用 XTEST + xdotool,Windows 用 SendInput,支持点击、拖拽、滚动。
📁
Chrome CDP 自动化
连接 Chrome DevTools Protocol(CDP),通过 HTTP API 导航页面、执行 JS、读取 DOM、操作 iframe、截图、拖拽滑块验证码。
🔗
剪贴板共享
双向剪贴板同步——在本地复制,远程粘贴。支持文本和图片(Linux 用 xclip,Windows 用系统 API)。
🛡️
自动子域名注册
内置 aitun.cc 管理 API 客户端,启动时自动注册子域名。无需手动配置,一行命令即获公网地址。
📱
跨平台 + Demo 模式
Linux/Windows/macOS 全支持。无显示器的服务器可用 --demo 模式跑合成桌面,方便测试和演示。

一行命令安装

自动检测平台架构,下载 samvnc-server 二进制到 /usr/local/bin 或 ~/.local/bin。

Linux / macOS · curl + bash
# 一行安装(自动检测 amd64/arm64/arm) curl -fsSL https://samai.cc/samvnc/downloads/install.sh | bash # 任何时候重新运行此命令即可更新到最新版 samvnc-server --verbose
Windows · PowerShell
# 在 PowerShell 中执行(管理员装到 Program Files,否则装到 %LOCALAPPDATA%) irm https://samai.cc/samvnc/downloads/install.ps1 | iex
Linux 无桌面服务器 · Demo 模式
# 无桌面的服务器也能跑——用 Demo 模式生成合成桌面 samvnc-server --demo --verbose # 启动后获得公网 URL,浏览器打开即可看到远程桌面 # 自动注册子域名 samvnc-<hostname>-<random>.t.aitun.cc

30 秒拿到远程桌面

安装后三步走,立刻拥有一个浏览器可访问的远程桌面。

1️⃣ 启动 samvnc-server

samvnc-server --token mysecret --verbose

启动后自动注册子域名,打印 Public URL。浏览器打开即可看到桌面。

2️⃣ 浏览器打开远程桌面

# 在任意浏览器打开启动时打印的 URL https://samvnc-myhost-abc123.t.aitun.cc # 或用 API 截图 curl https://samvnc-myhost-abc123.t.aitun.cc/api/screenshot -o screen.png # 查看状态 curl https://samvnc-myhost-abc123.t.aitun.cc/api/status

浏览器显示远程桌面画面,可点击/输入。API 返回 PNG 截图。

3️⃣ Chrome 自动化

# 导航到网页 curl -X POST https://samvnc-myhost.t.aitun.cc/api/navigate \ -H "Content-Type: application/json" \ -d '{"url":"https://example.com"}' # 执行 JS curl -X POST https://samvnc-myhost.t.aitun.cc/api/eval \ -H "Content-Type: application/json" \ -d '{"script":"document.title"}' # 点击坐标 curl -X POST https://samvnc-myhost.t.aitun.cc/api/click \ -H "Content-Type: application/json" \ -d '{"x":100,"y":200}'

CDP 全功能:导航、JS 执行、DOM 读取、iframe 操作、截图、滑块验证码。

直接下载二进制

所有二进制均为静态链接,无任何运行时依赖。SHA256 校验请见 checksums-sha256.txt

平台 架构 文件 大小 下载
🐧Linux x86-64 (amd64) samvnc-server-linux-amd64 8.2 MB 下载
🐧Linux ARM 64-bit (arm64) samvnc-server-linux-arm64 7.7 MB 下载
🐧Linux ARM 32-bit v7 (armv7l) samvnc-server-linux-arm 7.9 MB 下载
🪟Windows x86-64 (amd64) samvnc-server-windows-amd64.exe 8.2 MB 下载
🍎macOS Intel (amd64) samvnc-server-darwin-amd64 8.2 MB 下载
🍎macOS Apple Silicon (arm64) samvnc-server-darwin-arm64 6.9 MB 下载
📜安装脚本 Linux / macOS install.sh 2.1 KB 下载
📜安装脚本 Windows PowerShell install.ps1 2.0 KB 下载

HTTP 端点

HTTP API 无需鉴权(WebSocket 连接时通过 Hello 握手验证 token,使用 --token 参数设置)。

方法路径用途
GET/api/status服务状态(CDP、捕获、注入器)
GET/api/screenshot桌面截图(PNG)
GET/api/targets列出所有 CDP 目标(页面、iframe)
GET/api/cookies读取 Chrome cookies
POST/api/navigateChrome 导航到 URL
POST/api/eval执行 JavaScript,返回结果
POST/api/dom读取 DOM 元素 outerHTML
POST/api/scroll滚动页面
POST/api/click鼠标点击(X11 注入)
POST/api/type键盘输入文字
POST/api/drag鼠标拖拽(滑块验证码)
POST/api/iframe/eval在 iframe 内执行 JS
POST/api/iframe/click在 iframe 内点击
POST/api/mouse/click鼠标点击(指定按钮)
POST/api/mouse/drag鼠标拖拽(任意按钮)
POST/api/mouse/wheel滚轮滚动
POST/api/key/down按键按下
POST/api/key/up按键释放
WS/wsWebSocket 远程桌面(画面流+输入注入)