cloud-browser/README.md

云端浏览器

在境外 VPS 上自部署的轻量远程浏览器：登录后输入网址，由云端 Chromium 打开页面，画面通过 WebSocket 实时回传，支持鼠标键盘操作。

功能特性

• 输入网址即可在云端打开并远程操作
• 内置登录鉴权，默认账号 admin / admin
• 前端可修改用户名和密码
• Docker 部署，默认端口 32450
• 反向代理（HTTPS/域名）请自行在宝塔/Nginx 配置

快速体验

部署完成后访问：

http://服务器IP:32450

默认账号密码均为 admin，登录后请立即修改。

文档

• 部署文档 DEPLOY.md — 含一键部署说明

技术架构

浏览器 → :32450 → FastAPI → Playwright Chromium
              ↑ WebSocket 画面流 / 输入事件

目录结构

cloud-browser/
├── app/              # 后端（FastAPI + Playwright）
├── static/           # 前端页面
├── deploy.sh         # 一键部署脚本
├── uninstall.sh      # 一键卸载脚本
├── docker-compose.yml
├── Dockerfile
└── DEPLOY.md         # 部署文档

常用命令

cd /opt/cloud-browser
docker compose logs -f app      # 查看日志
docker compose restart        # 重启
docker compose down           # 停止
bash deploy.sh                # 更新并重新部署
bash uninstall.sh             # 一键卸载

安全说明

• 首次部署后务必修改默认密码
• 内置 SSRF 防护，禁止访问内网地址
• 账号数据保存在 data/auth.json（Docker 卷持久化）
• 建议通过 Nginx/宝塔配置 HTTPS 后再对外使用

许可证

MIT