Files
cloud-browser/README.md
T
2026-06-27 11:13:30 +08:00

68 lines
1.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 云端浏览器
在境外 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 # 一键部署脚本
├── uninstall.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 # 更新并重新部署
bash uninstall.sh # 一键卸载
```
## 安全说明
- 首次部署后务必修改默认密码
- 内置 SSRF 防护,禁止访问内网地址
- 账号数据保存在 `data/auth.json`Docker 卷持久化)
- 建议通过 Nginx/宝塔配置 HTTPS 后再对外使用
## 许可证
MIT