远程控制演示工具

这是一个一日演示版远程控制工具，核心目标是验证远程控制闭环：

• Windows Agent 连接控制端。
• 浏览器控制端实时看到 Agent 屏幕。
• 浏览器控制端可以移动鼠标、点击、滚轮和输入基础键盘内容。

当前版本优先用于本机或局域网演示，不包含公网穿透、WebRTC、文件传输、剪贴板、多用户权限和完整审计。

启动控制端

go run .\cmd\server --addr :8080 --token demo-token

浏览器访问：

http://127.0.0.1:8080/?token=demo-token

启动被控端 Agent

在 Windows 被控机器上运行：

go run .\cmd\agent --server ws://127.0.0.1:8080/agent/ws --token demo-token --id demo-agent

如果控制端服务在另一台机器上，将 127.0.0.1 替换为控制端机器的局域网 IP。

双机演示推荐参数

控制端机器启动服务：

.\bin\remote-server.exe --addr :8080 --token demo-token

被控端机器连接控制端。将下面的 192.168.1.10 替换为控制端机器的局域网 IP。

均衡模式，推荐优先使用：

.\bin\remote-agent.exe --server ws://192.168.1.10:8080/agent/ws --token demo-token --id demo-agent --width 1920 --height 1080 --fps 15 --quality 70 --scale fast

流畅模式，适合网络一般或机器性能一般：

.\bin\remote-agent.exe --server ws://192.168.1.10:8080/agent/ws --token demo-token --id demo-agent --width 1280 --height 720 --fps 20 --quality 60 --scale fast

高画质模式，适合局域网和性能较好的机器：

.\bin\remote-agent.exe --server ws://192.168.1.10:8080/agent/ws --token demo-token --id demo-agent --width 1920 --height 1080 --fps 20 --quality 80 --scale fast

当前演示版最高建议设置到 --fps 30。如果出现卡顿，优先降低 --quality，其次降低 --width 和 --height。

本机单屏演示方式

如果控制端页面和 Agent 都运行在同一台电脑上，默认会出现“画面套画面”的递归镜像。这是因为 Agent 截取了整个桌面，而桌面里又包含浏览器控制页面。

单机演示建议使用区域采集：

1. 将被控目标窗口，例如记事本，放在屏幕左半边。
2. 将浏览器控制端页面放在屏幕右半边。
3. 运行 Agent 时只采集左半边区域。

以 1920x1080 屏幕为例：

.\bin\remote-agent.exe --server ws://127.0.0.1:8080/agent/ws --token demo-token --id demo-agent --capture-left 0 --capture-top 0 --capture-width 960 --capture-height 1080 --width 960 --height 540 --fps 15 --quality 70 --scale fast

这样控制端页面只会显示左半边被控区域，鼠标点击也会映射到左半边区域，不会再无限递归。

编译

go build -o .\bin\remote-server.exe .\cmd\server
go build -o .\bin\remote-agent.exe .\cmd\agent

演示步骤

1. 启动控制端服务。
2. 打开浏览器控制页面。
3. 启动 Windows Agent。
4. 控制页面显示 Agent 在线和远程屏幕画面。
5. 点击远程屏幕区域，测试鼠标移动、点击、滚轮。
6. 保持远程屏幕区域聚焦，测试基础键盘输入。
7. 在 Agent 控制台按 Ctrl+C 断开连接。

安全边界

• Agent 运行时控制台会显示正在作为被控端。
• 当前版本不做隐藏运行、不做权限提升、不做安全软件绕过。
• 当前版本建议只在授权测试环境、本机或局域网演示。