# 云端浏览器

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

## 功能特性

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

## 快速体验

部署完成后访问：

```
http://服务器IP:32450
```

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

## 文档

- [部署文档 DEPLOY.md](DEPLOY.md) — 含一键部署说明

## 技术架构

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

## 目录结构

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

## 常用命令

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

## 安全说明

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

## 许可证

MIT