Improve screencast performance: lower defaults, fps cap, drop mousemove flood

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-27 11:09:16 +08:00
parent b9ee546bc1
commit a409f35e6c
7 changed files with 116 additions and 41 deletions
@@ -206,6 +206,29 @@ docker compose down
 docker compose up -d
 ```

+### 画面卡顿
+
+这是 JPEG 画面流方案的正常现象，可调整 `/opt/cloud-browser/.env`：
+
+```env
+VIEWPORT_WIDTH=960
+VIEWPORT_HEIGHT=540
+SCREENCAST_QUALITY=45
+SCREENCAST_MAX_FPS=12
+SCREENCAST_EVERY_NTH_FRAME=3
+```
+
+修改后执行：
+
+```bash
+cd /opt/cloud-browser
+docker compose up -d --build
+```
+
+浏览页右上角会显示当前 fps，便于判断网络是否跟得上。
+
+其他原因：VPS 内存不足、跨境带宽延迟、Nginx 反代未开 WebSocket。
+
 ### 页面黑屏

 ```bash