# 本机隔离执行部署 2026-10-31 已实际部署并通过隔离验收。预览使用 Windows 上的 Vue / Spring Boot / 独立 H2 文件库,以及专用 WSL2 发行版 `WebUp-Local` 中的 Docker、K3s、gVisor 和私有工具网关。不需要远程服务器或 Docker Desktop,也不修改原有 Ubuntu 发行版。 ## 当前入口与状态 - 首页 `http://127.0.0.1:5173/`,用户 AI 开发 `/develop`,管理员 `/admin`。 - 后端 `http://127.0.0.1:8080`,网关 `http://127.0.0.1:8090`(仅回环、需要令牌)。 - 集群节点 `webup-local`;K3s / gVisor 版本与官方制品哈希固定在 `infra/local/versions.json`。 - 平台默认同时开发 2 个项目,预览 Worker 本实例容量 4。管理员 `/admin/tasks` 可改总并发和队列顺序。 - 预览 AI Worker 已启用,实际调用管理员配置的模型。预览余额是测试余额,外部模型供应商仍可能收取真实 API 费用。 - 本地发布 Worker 默认关闭。部署新版网关并通过隔离验收后,可用 `enable-preview.ps1 -EnableHosting` 启用本地托管和源码发布。公网域名仍需要实际 DNS、Ingress 与证书配置。 ## 重启和复验 WSL 空闲时可能停止。保持一个终端运行以下前台命令,直到本地测试结束: ```powershell wsl -d WebUp-Local -u root --exec sleep infinity ``` K3s 和端口转发由该发行版的 systemd 管理。检查状态: ```powershell wsl -d WebUp-Local -u root --exec systemctl is-active k3s webup-gateway-forward wsl -d WebUp-Local -u root --exec k3s kubectl get nodes ``` 修改网关源码后,在项目根目录依次执行(第二步导入本地镜像并滚动重启网关): ```powershell wsl -d WebUp-Local -u root --exec bash '/mnt/k/web dev/webup.run/scripts/local/build-images.sh' '/mnt/k/web dev/webup.run' wsl -d WebUp-Local -u root --exec bash '/mnt/k/web dev/webup.run/scripts/local/deploy-gateway.sh' '/mnt/k/web dev/webup.run' wsl -d WebUp-Local -u root --exec python3 '/mnt/k/web dev/webup.run/scripts/local/smoke-cluster.py' .\scripts\local\enable-preview.ps1 ``` `enable-preview.ps1` 要求最近 24 小时真实隔离验收通过,并重新探测网关。它只更新被忽略的本地基础设施配置和预览 reload trigger,不创建后台 Windows 进程,不改用户 / 模型 / 钱包数据。已运行的预览后端重新加载后,可在管理员服务器页面查看 READY 状态。 ## 实际验收 真实调用网关并检查 10 项:拒绝无令牌访问、实际查询 Kubernetes、创建 PVC / 写文件、读回、拒绝父路径越界、非 root / 无平台凭证 / 根只读 / 内网阻断 / 公网 HTTPS 可达、请求 gVisor、containerd 实际使用 runsc、每 Pod 512 进程限制、删除工作区 Pod 后文件仍可读。 报告保存于 Linux `/etc/webup-local/smoke-report.json` 和宿主机 `.runtime/local-cluster/smoke-report.json`。验收只操作随机 UUID 的测试项目,不删除用户工作区。开发文件保存在 K3s PVC,前端编辑器与 AI Worker 共用同一网关;没有把用户 shell 命令放在 Windows 宿主机执行。 ## PostgreSQL / Redis 真实自动化测试 独立验收已部署 `platform-reviews` 命名空间和受限 RBAC。可运行 `wsl -d WebUp-Local -u root --exec python3 '/mnt/k/web dev/webup.run/scripts/local/smoke-code-review.py'` 复验真实隔离复制和 npm 构建 / 测试;详情见 [代码验收](CODE-REVIEWS.md)。 专用测试容器 `webup-test-postgres` / `webup-test-redis` 已在同一 WSL 发行版部署,分别只映射回环端口 15432 / 16379,Redis 启用密码。测试数据库为 `webup_integration`,与预览 H2 文件库分开。测试会清理该测试数据库中的业务表,不触碰预览中的用户、模型和钱包。 ```powershell wsl -d WebUp-Local -u root --exec python3 '/mnt/k/web dev/webup.run/scripts/local/start-test-services.py' .\scripts\local\run-real-tests.ps1 wsl -d WebUp-Local -u root --exec python3 '/mnt/k/web dev/webup.run/scripts/local/check-database-persistence.py' ``` 该脚本只接受固定的本机测试库 / Redis 地址,从被忽略的 `services.env` 导入环境,并在运行结束后恢复原环境变量。首次部署需要拉取 ECR Public 官方镜像 `public.ecr.aws/docker/library/postgres:17` 与 `public.ecr.aws/docker/library/redis:7.4`。 最新真实 PostgreSQL / Redis 全量测试 100 项通过、无跳过。持久化检查实际重启专用测试 PostgreSQL,非空用户、钱包、账本、任务数据与迁移记录保持一致;预览控制面的 H2 数据库不参与该重启。 ## 本地私有文件 `.runtime/` 和 `.tools/` 已被 Git 忽略。网关令牌在 Linux `/etc/webup-local/gateway.env`(0600)与宿主机 `.runtime/local-cluster/gateway.env`;宿主机目录仅当前账户和 SYSTEM 可访问。不要分享这些文件、预览账号文件、数据库文件或 kubeconfig。预览日志只记录任务 ID 和状态,不记录模型密钥。 本地 H2 / 内存短期存储仍属于预览配置。正式域名 DNS / 证书、对象存储与支付另行验收,不能用本次隔离工作区和数据库测试通过代替。