HH-738: add constrained browser container control (#4)

2026-08-27 18:07:34 +08:00
parent 8aa194b264
commit 4b054d6f04
16 changed files with 1925 additions and 1 deletions
@@ -4,11 +4,32 @@

 ## 当前阶段

-项目处于规划与初始化阶段。功能参考公开上游项目独立实现，不直接复制其代码。
+项目处于阶段 A 技术验证。首个可运行切片提供浏览器容器的创建、列表、启停和回收，功能参考公开上游项目独立实现，不直接复制其代码。

 详细的五领域优先级、系统边界、合规知识库与分阶段验证方案见
 [《合规产品规划与上游调研》](docs/product/compliance-product-plan.md)。

+## 本地运行
+
+需要 Docker Compose。控制面仅绑定本机；浏览器网络在阶段 A 默认禁止外网访问：
+
+```bash
+docker pull git.ipao.vip/rogee/fingerprint-chromium:148.0.7778.215
+DOCKER_GID=$(stat -c %g /var/run/docker.sock) docker compose up --build
+```
+
+打开 <http://127.0.0.1:8080>。架构、API 契约、失败语义和 `docker.sock` 风险边界见
+[《浏览器容器控制面》](docs/architecture/container-control.md)。
+
+最小验证：
+
+```bash
+go test ./...
+npm --prefix web ci
+npm --prefix web run build
+docker compose config --quiet
+```
+
 ## 合规边界

 - 自动化行为必须遵守目标平台规则、适用法律和账号授权范围。