From 54851fc191d5681311963773194a499199d3d7b3 Mon Sep 17 00:00:00 2001 From: WangLX <519407855@qq.com> Date: Tue, 11 Aug 2026 14:26:15 +0800 Subject: [PATCH] feat: configure farm client identity and token --- compose/.env.example | 2 + compose/docker-compose.backend.yml | 2 + docs/BACKEND-DEPLOYMENT.md | 5 +- docs/CLIENT-WORKSTATION-HARDWARE-BASELINE.md | 128 +++++++++++++++++++ scripts/configure-backend-env.sh | 7 + scripts/create-local-env.sh | 2 + 6 files changed, 144 insertions(+), 2 deletions(-) create mode 100644 docs/CLIENT-WORKSTATION-HARDWARE-BASELINE.md diff --git a/compose/.env.example b/compose/.env.example index d70b37f..154e986 100644 --- a/compose/.env.example +++ b/compose/.env.example @@ -68,6 +68,8 @@ CDK_CODE_PEPPER=replace-with-a-random-value MLKJ_INTEGRATION_KEY=replace-with-a-random-value MLKJ_INTEGRATION_SECRET=replace-with-a-random-value PRINT_CLIENT_SHARED_TOKEN=replace-with-a-random-value +PRINT_DEFAULT_TARGET_CLIENT_ID=farm-workstation-001 +PRINT_ALLOWED_CLIENT_ID=farm-workstation-001 OSS_PUBLIC_ENDPOINT=http://127.0.0.1:9000 CORS_ALLOWED_ORIGINS=http://localhost:8080,http://127.0.0.1:8080 diff --git a/compose/docker-compose.backend.yml b/compose/docker-compose.backend.yml index 06a998f..f2690d5 100644 --- a/compose/docker-compose.backend.yml +++ b/compose/docker-compose.backend.yml @@ -15,6 +15,8 @@ services: MLKJ_INTEGRATION_KEY: ${MLKJ_INTEGRATION_KEY:?MLKJ_INTEGRATION_KEY is required} MLKJ_INTEGRATION_SECRET: ${MLKJ_INTEGRATION_SECRET:?MLKJ_INTEGRATION_SECRET is required} PRINT_CLIENT_SHARED_TOKEN: ${PRINT_CLIENT_SHARED_TOKEN:?PRINT_CLIENT_SHARED_TOKEN is required} + PRINT_DEFAULT_TARGET_CLIENT_ID: ${PRINT_DEFAULT_TARGET_CLIENT_ID:?PRINT_DEFAULT_TARGET_CLIENT_ID is required} + PRINT_ALLOWED_CLIENT_ID: ${PRINT_ALLOWED_CLIENT_ID:?PRINT_ALLOWED_CLIENT_ID is required} OSS_PROVIDER: minio OSS_ENDPOINT: http://minio:9000 OSS_BUCKET_NAME: ${MINIO_BUCKET:?MINIO_BUCKET is required} diff --git a/docs/BACKEND-DEPLOYMENT.md b/docs/BACKEND-DEPLOYMENT.md index 2a9ab48..9b4ab4c 100644 --- a/docs/BACKEND-DEPLOYMENT.md +++ b/docs/BACKEND-DEPLOYMENT.md @@ -18,10 +18,11 @@ cd /srv/ai-soulmate-local-deployment ./scripts/configure-backend-env.sh \ compose/.env \ /srv/ai-soulmate/sources/ai-soulmate-server \ - 192.168.3.102 + 192.168.3.102 \ + farm-workstation-001 ``` -脚本保留已有基础设施密码,补齐后端密钥,文件权限保持为 `600`,并且不会把密钥打印到终端。Tripo Key 默认留空;健康检查不依赖 Tripo,联调 Tripo 前再通过受控方式注入已轮换的新 Key。 +脚本保留已有基础设施密码,补齐后端密钥和打印客户端允许的 `client_id`,文件权限保持为 `600`,并且不会把密钥打印到终端。农场端使用的 `AI_SOULMATE_CLIENT_ID` 必须与此处第四个参数一致。Tripo Key 默认留空;健康检查不依赖 Tripo,联调 Tripo 前再通过受控方式注入已轮换的新 Key。 ## 重建 MinIO 配置 diff --git a/docs/CLIENT-WORKSTATION-HARDWARE-BASELINE.md b/docs/CLIENT-WORKSTATION-HARDWARE-BASELINE.md new file mode 100644 index 0000000..046539f --- /dev/null +++ b/docs/CLIENT-WORKSTATION-HARDWARE-BASELINE.md @@ -0,0 +1,128 @@ +# AI SoulMate Client 工作站硬件基线报告 + +- 采集时间:2026-08-10 15:37(Asia/Shanghai) +- 采集对象:AI SoulMate Client(农场端)工作站 +- 主机名:`HP` +- 采集方式:通过 Tailscale + SSH 执行 Windows 本机只读命令 +- 使用阶段:本地部署适配、功能跑通与轻量压力测试 + +## 1. 结论 + +这台工作站可以用于 AI SoulMate Client 农场端的功能部署和低并发验证,但不适合本地三维模型推理,也不适合作为高并发或长期生产环境的性能代表机。 + +当前主要限制是 **2 核 4 线程 CPU 和 8GB 单条内存**。Windows 在采集时只剩约 2.56GiB 可用内存,而 Client 还需要运行 PostgreSQL、Java 后端、前端/Nginx 和容器运行时。因此本次应采用轻量资源限制、避免在工作站本地反复构建镜像,并优先把内存升级到 16GB。 + +当前判定: + +- 功能跑通:可以开始,但需先启用 WSL2 并安装 Docker Desktop。 +- Client 低并发 POC:可以,需限制容器资源并持续观察内存。 +- Client 容量结论:暂不能给出,需部署后按固定场景压测。 +- Tripo 3D:继续调用外部 API;本机不承担模型推理。 +- 客户生产方案:不能直接照搬这台工作站的配置与测试数字。 + +## 2. 实测硬件清单 + +| 项目 | 实测结果 | 适配判断 | +| --- | --- | --- | +| 整机 | Lenovo Baiying `NUC13 Yes`,x64 物理机 | 小型农场端工作站形态 | +| 操作系统 | Windows 11 家庭中文版,64 位,版本 `10.0.26200` | 可使用 WSL2 + Docker Desktop | +| BIOS | `YSDLP03.107` | 已开启 CPU 虚拟化能力 | +| CPU | AMD Athlon Gold 3150C with Radeon Graphics,2 核 4 线程,标称最大 2.4GHz | 功能验证可用;构建和并发能力较弱 | +| 虚拟化 | Firmware virtualization = `True`,SLAT = `True` | 满足 WSL2 的硬件前提 | +| 内存 | 1 × 8GB DDR4-2666,实际配置频率 2400MHz,系统可识别约 7.45GiB | 当前最大风险;建议升级到 16GB | +| GPU | AMD Radeon Vega 3 集成显卡,系统报告 512MiB 显存,1920×1080 | 只用于显示;无 CUDA,不承担本地 3D 推理 | +| 系统盘 | Netac G537N2 256G SATA SSD,物理容量约 238.5GiB | POC 可用;镜像、日志和模型文件需限额 | +| SSD 健康 | Windows 报告 `Healthy / OK` | 未见直接故障信号,但不是完整 SMART/寿命检测 | +| 有线网卡 | Realtek PCIe GbE Family Controller | 建议正式运行时使用千兆有线网络 | +| 无线网卡 | Realtek 8821CE 802.11ac | 当前可用,吞吐和稳定性不宜作为生产基线 | + +## 3. 存储与当前资源 + +| 盘符 | 总容量 | 可用空间 | 当前用途建议 | +| --- | ---: | ---: | --- | +| `C:` | 约 150.05GiB | 约 110.49GiB | Windows 与应用程序 | +| `D:` | 约 87.32GiB | 约 87.23GiB | 优先用于 Client 数据、Docker 数据和部署文件 | + +采集瞬间 CPU 负载约 27%,可用物理内存约 2.56GiB。瞬时值不能代表稳定负载,但说明 8GB 内存余量较小。部署时应保证磁盘至少保留 20GiB 可用空间,并设置日志轮转和 Docker 镜像清理流程。 + +## 4. 网络与远程维护 + +| 项目 | 状态 | +| --- | --- | +| 局域网 WLAN 地址 | `192.168.3.162` | +| Tailscale 地址 | `100.111.151.72` | +| Tailscale 主机名 | `ai-soulmate-workstation` | +| SSH | 已启用并验证密钥登录 | +| 中心服务器 Tailscale | `100.81.206.1`(`ai-soulmate-lab`) | +| 中心服务器业务地址 | `192.168.3.102`,已通过 Tailscale 子网路由访问 | + +农场端即使换到其他网络,Tailscale 地址通常仍保持不变;局域网地址可能变化。远程运维应优先使用: + +```powershell +ssh -i "$env:USERPROFILE\.ssh\id_ed25519_ai_soulmate_workstation" hedon@100.111.151.72 +``` + +不要把 SSH 22 端口直接暴露到公网。局域网和 Tailscale 防火墙规则应继续限制来源范围。 + +## 5. 容器运行前置状态 + +| 检查项 | 当前状态 | 下一步 | +| --- | --- | --- | +| BIOS 虚拟化 | 已启用 | 无需修改 BIOS | +| SLAT | 支持 | 满足 WSL2 前提 | +| `VirtualMachinePlatform` | 未启用 | 启用后重启 | +| `Microsoft-Windows-Subsystem-Linux` | 未启用 | 启用后安装/更新 WSL2 | +| Docker CLI | 未安装 | WSL2 就绪后安装 Docker Desktop | +| Docker Engine | 未运行 | 安装后验证 `hello-world` 与 Compose | + +以上两行是硬件采集时的初始状态。随后已完成前置环境安装并复核: + +- `HypervisorPresent=True`。 +- WSL 与 `VirtualMachinePlatform` 均为 `Enabled`。 +- WSL 版本 `2.7.11.0`,默认 WSL 版本为 `2`。 +- Docker Desktop `4.85.0`,Docker Engine `29.6.2`,Compose `v5.3.1`。 +- Docker 使用 Linux 引擎,报告可用内存约 3.55GiB、4 个逻辑 CPU。 +- 已通过 `docker run --rm hello-world`,并配置镜像源 `https://docker.m.daocloud.io/`。 + +因此,工作站已经具备运行 Client Linux 容器的基础条件;Client 应用镜像和本地 PostgreSQL 尚未启动。 + +当前尚未进入 Client 容器启动阶段。现阶段只是完成了远程维护通道、Client 本地部署分支和工作站硬件验收。 + +## 6. Client 部署资源建议 + +在 8GB 内存不升级的前提下,建议采用以下 POC 起始预算: + +| 组件 | CPU 上限起点 | 内存上限起点 | 说明 | +| --- | ---: | ---: | --- | +| Client PostgreSQL | 0.5 CPU | 512MiB | 只存农场端本地业务数据 | +| Client Java 后端 | 1.0 CPU | 1024MiB | JVM 堆建议先限制在 512MiB 左右 | +| Client 前端/Nginx | 0.25 CPU | 128MiB | 使用生产静态文件,不运行 Vite 开发服务器 | +| WSL2/容器总预算 | 不超过 1.5 CPU | 约 3GiB | 为 Windows、SSH、Tailscale 和打印程序保留余量 | + +这些值只是防止工作站失去响应的起始保护值,不是性能调优结论。镜像构建的峰值内存会明显高于运行时,优先在中心服务器或开发机完成构建,再把固定版本镜像传到工作站。 + +## 7. 风险与优先级 + +| 优先级 | 风险 | 影响 | 处理建议 | +| --- | --- | --- | --- | +| P0 | 仅 8GB 内存 | Docker、Java、数据库与 Windows 争用内存,可能卡顿或 OOM | 最优先升级到 16GB;升级前严格限制资源 | +| P0 | WSL2 与虚拟机平台未启用 | Docker Desktop 无法运行 Linux 容器 | 启用功能并重启后再安装 Docker | +| P1 | 2 核 4 线程低功耗 CPU | 构建慢,多任务和并发能力有限 | 避免本机构建;低并发逐级加压 | +| P1 | 单块 256GB SSD | Client 数据、镜像、日志共享容量且无冗余 | 使用 `D:`、限制日志并备份业务数据 | +| P1 | 当前使用 Wi-Fi | 文件上传和打印任务可能受无线抖动影响 | 能接网线时改用千兆以太网 | +| P1 | 集成 GPU、无 CUDA | 无法代表本地 AI 推理工作站 | Tripo 继续走 API,本机只运行业务 Client | +| P2 | 未采集温度与完整 SMART | 暂不能判断长时间满载散热与 SSD 寿命 | 压测阶段补采温度、磁盘延迟与错误计数 | + +## 8. 推荐实施顺序 + +1. 启用 WSL2 和虚拟机平台,重启工作站。 +2. 安装并验证 WSL2、Docker Desktop 和 Docker Compose。 +3. 把 Client 源码与脱敏环境模板部署到工作站,真实密钥只保存在工作站 `.env`。 +4. 采用固定版本镜像启动 PostgreSQL、Client 后端和前端。 +5. 验证工作站到中心服务器 `192.168.3.102:8080` 的 API 访问。 +6. 完成登录、任务获取、模型/文件下载、打印任务和断线恢复测试。 +7. 记录空闲资源基线,再进行低并发、逐级加压和长稳测试。 + +## 9. 报告边界 + +本报告不记录序列号、MAC 地址、账号、密钥或环境变量秘密。本次只使用 Windows 系统可读取的硬件和健康状态,没有拆机,也没有执行内存压力测试、完整 SSD SMART 检测、温度采集或长时间负载测试。因此“SSD Healthy”只表示当前 Windows 存储状态未报告故障,不等同于生产级寿命保证。 diff --git a/scripts/configure-backend-env.sh b/scripts/configure-backend-env.sh index 6da986c..b7fa6ec 100755 --- a/scripts/configure-backend-env.sh +++ b/scripts/configure-backend-env.sh @@ -4,6 +4,7 @@ set -Eeuo pipefail env_file="${1:-compose/.env}" source_directory="${2:-/srv/ai-soulmate/sources/ai-soulmate-server}" public_host="${3:-}" +client_id="${4:-farm-workstation-001}" for required_command in git grep mktemp openssl; do if ! command -v "$required_command" >/dev/null 2>&1; then @@ -24,6 +25,10 @@ if [[ -z "$public_host" || ! "$public_host" =~ ^[A-Za-z0-9.-]+$ ]]; then printf 'Provide the approved LAN IPv4 address or DNS name as argument 3.\n' >&2 exit 1 fi +if [[ -z "$client_id" || ! "$client_id" =~ ^[A-Za-z0-9._-]+$ ]]; then + printf 'Provide a client ID using letters, numbers, dot, underscore, or hyphen as argument 4.\n' >&2 + exit 1 +fi source_branch="$(git -C "$source_directory" branch --show-current)" source_commit="$(git -C "$source_directory" rev-parse HEAD)" @@ -95,6 +100,8 @@ ensure_secret CDK_CODE_PEPPER ensure_secret MLKJ_INTEGRATION_KEY ensure_secret MLKJ_INTEGRATION_SECRET ensure_secret PRINT_CLIENT_SHARED_TOKEN +set_value PRINT_DEFAULT_TARGET_CLIENT_ID "$client_id" +set_value PRINT_ALLOWED_CLIENT_ID "$client_id" set_value OSS_PUBLIC_ENDPOINT "http://${public_host}:9000" set_value CORS_ALLOWED_ORIGINS "http://${public_host},http://${public_host}:8080,http://${public_host}:8081,http://localhost:8080,http://127.0.0.1:8080" diff --git a/scripts/create-local-env.sh b/scripts/create-local-env.sh index bd5b60d..65cadac 100755 --- a/scripts/create-local-env.sh +++ b/scripts/create-local-env.sh @@ -93,6 +93,8 @@ CDK_CODE_PEPPER=$(random_secret) MLKJ_INTEGRATION_KEY=$(random_secret) MLKJ_INTEGRATION_SECRET=$(random_secret) PRINT_CLIENT_SHARED_TOKEN=$(random_secret) +PRINT_DEFAULT_TARGET_CLIENT_ID=farm-workstation-001 +PRINT_ALLOWED_CLIENT_ID=farm-workstation-001 OSS_PUBLIC_ENDPOINT=http://127.0.0.1:9000 CORS_ALLOWED_ORIGINS=http://localhost:8080,http://127.0.0.1:8080