Files
ai-soulmate-local-deployment/docs/CLIENT-WORKSTATION-HARDWARE-BASELINE.md

128 lines
8.3 KiB
Markdown
Raw Permalink 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.
# 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 三容器的首次部署;当前需要补充开机自启动、休眠策略和长稳验证。
- 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 15、Java 后端和前端三容器,页面、登录及 `farm-workstation-001` 心跳曾验证通过;演示打印机和演示订单已清理。
本报告生成后的最终远程检查中,工作站 Tailscale 显示离线,可能与息屏或休眠有关,但原因尚未最终确认。当前还没有 Client 镜像 digest、长稳、断线恢复或容量证据,因此不能把“首次运行成功”解释为持续在线或生产可用。
## 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 | 工作站息屏/休眠后可能离线 | Client、Tailscale 和 Docker Desktop 可能无法持续提供农场服务 | 设置接通电源不休眠、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. 设置工作站接通电源时不休眠,并验证 Tailscale、Docker Desktop 和 Client 三容器开机后自动可用。
2. 固定 Client 实际源码提交、镜像 digest 和 `.env` 配置摘要,真实密钥只保存在工作站。
3. 复核工作站到中心服务器 `192.168.3.102:8080` 的平台 API、心跳和任务同步。
4. 完成模型/文件下载、订单同步、断线恢复和重复任务幂等测试。
5. 记录空闲资源基线,再进行低并发、逐级加压和长稳测试。
6. 最后接入快造 U1,单独验证 PIN、动态 IP 发现、单机/多机打印队列和状态回传。
## 9. 报告边界
本报告不记录序列号、MAC 地址、账号、密钥或环境变量秘密。本次只使用 Windows 系统可读取的硬件和健康状态,没有拆机,也没有执行内存压力测试、完整 SSD SMART 检测、温度采集或长时间负载测试。因此“SSD Healthy”只表示当前 Windows 存储状态未报告故障,不等同于生产级寿命保证。