mkdir -p ~/.config/creatorhub
cp deploy/browser-gateway.env.example ~/.config/creatorhub/browser-gateway.env
$EDITOR ~/.config/creatorhub/browser-gateway.env
scripts/install-native-browser-gateway.sh
curl --fail --silent --show-error http://127.0.0.1:8081/healthz

首次部署可生成控制面凭据：

export CREATORHUB_PORT=8080
export CONTROL_PLANE_USERNAME=creatorhub
export CONTROL_PLANE_PASSWORD="$(openssl rand -hex 24)"
export CREATORHUB_CREDENTIAL_MASTER_KEY="$(openssl rand -base64 32)"

docker compose config --quiet
docker compose up --detach --build

Compose 只运行 control-plane 和 PostgreSQL，浏览器 gateway 仍是宿主机 systemd user service。启动后检查：

docker compose ps
curl --fail --silent --show-error "http://127.0.0.1:${CREATORHUB_PORT:-8080}/healthz"
curl --fail --silent --show-error "http://127.0.0.1:${CREATORHUB_PORT:-8080}/readyz"
docker compose logs --tail=200 creator-hub postgres

打开 http://127.0.0.1:${CREATORHUB_PORT:-8080} 登录。首次配置：

在「网关管理」注册 gateway。control-plane 在 Compose 中运行时使用 http://host.docker.internal:8081；裸机运行 control-plane 时使用 http://127.0.0.1:8081。令牌必须与 gateway 配置一致。
在「浏览器版本」登记宿主机上实际存在的浏览器版本和绝对路径。
创建抖音账号和运行环境，显式启动环境。
在账号页显示登录二维码，完成登录后核验浏览器身份。
按验证文档手工完成抖音采集、结果保存、停止、再启动和资源释放检查。

已有数据的重启必须复用原控制面主密钥、gateway 令牌、Profile 根目录和素材目录。不要使用 docker compose down -v，也不要删除 gateway 的 Profile 根目录。

停止控制面和数据库：

docker compose down
systemctl --user stop creatorhub-browser-gateway.service

本地开发（分开启动）

首次安装前端依赖：

npm --prefix web ci

分别在四个终端运行：

pnpm env       # PostgreSQL 依赖
pnpm gateway   # native browser gateway
pnpm backend   # Go control-plane，Air 自动重载
pnpm frontend  # Vite 前端，支持 HMR

pnpm backend 不会自动启动数据库或 gateway；先启动 env 和 gateway。pnpm gateway 直接运行当前用户的 native gateway，不要求安装 systemd 服务。修改 browser_gateway 的 Python 文件后，重启该命令；新增或删除前端路由后，重跑 pnpm --dir web run routes:generate。

服务地址：

端	地址	说明
前端	http://127.0.0.1:5173	`/api` 代理到本地 control-plane
control-plane	http://127.0.0.1:8082	Go 热加载
native browser gateway	http://127.0.0.1:8081	宿主机 Xvfb/浏览器生命周期
PostgreSQL	`127.0.0.1:5432`	仅数据库依赖使用容器

开发默认登录信息和目录可在 .env.example、deploy/browser-gateway.env.example 中查看。不要把真实密码、Cookie、验证码或令牌写入仓库。

最小检查：

go test ./...
go vet ./...
go build ./cmd/control-plane
go test -race ./...
npm --prefix web ci
npm --prefix web test -- --run
npm --prefix web run build
docker compose config --quiet

README.md Unescape Escape

CreatorHub

当前阶段

本地运行

本地开发（分开启动）

README.md