chore: initialize local deployment baseline

This commit is contained in:
wlx committed 2026-08-05 18:17:58 +08:00
commit 9e2196d69f
30 files changed
+1436

No files matched your search

+58
View File
@@ -0,0 +1,58 @@
# 本地部署目标架构
## 第一阶段:中心适配服务器
```text
浏览器 / 管理员
|
HTTPS 443
|
统一网关(Nginx 或客户现有网关)
|--------------------|
平台前端 AI SoulMate 管理端
|--------------------|
平台后端
|----------|----------|
PostgreSQL Redis 本地 S3 兼容对象存储
平台后端 ---- HTTPS 出站 ---- Tripo API
```
除 Tripo 调用外,数据库、缓存、对象文件、平台服务和管理端均位于客户局域网。默认只对业务网开放网关的 `443`;PostgreSQL、Redis 和对象存储管理端口不直接暴露。
## 第二阶段:农场工作站
```text
中心平台后端 -- HTTPS / 设备身份认证 --> 农场端工作站
|
本地任务缓存 / 客户端数据库
|
打印机 / Moonraker
```
农场端主动发起心跳、拉取任务和上报状态,中心端不直接访问打印机网络。后续需要补齐设备级凭证、幂等任务、断网重试、升级和审计能力。
## 服务职责
| 服务 | 第一阶段位置 | 说明 |
| --- | --- | --- |
| `ai-soulmate-server` | 中心服务器 | 前端与 FastAPI 后端 |
| `mlkj-admin` AI SoulMate 部分 | 中心服务器 | 必须支持 AI-only 模式,不能强依赖其他业务库 |
| PostgreSQL | 中心服务器 | 使用独立数据库/角色,定期备份 |
| Redis | 中心服务器 | 只在容器网络开放,启用持久化与认证 |
| 本地对象存储 | 中心服务器 | 通过统一存储接口接入,不继续绑定阿里 `oss2` |
| 统一网关 | 中心服务器 | TLS、路由、上传限制、访问日志和基础限流 |
| Tripo | 外部服务 | 当前为必要出站依赖,指标必须与本地容量分开 |
| `ai-soulmate-client` | 后续农场工作站 | 靠近打印机,暂不纳入中心服务器 POC |
## 网关判断
网关能力需要保留,但不建议直接部署现有 `nginx-server`:它面向现有公网域名和固定容器名,目前也没有完整覆盖管理端与农场端。私有版应在本仓库维护环境无关的路由模板;如果客户已有负载均衡或企业网关,则由其替代 Nginx。
## 安全边界
- 禁止把数据库、Redis 和对象存储管理端口映射到公网。
- Tripo、短信、支付等外部能力按现场需求逐项启用,默认关闭非必要集成。
- 平台用户、管理员和农场设备使用不同身份体系与凭证。
- 所有密码和 API Key 在部署时注入,不构建进镜像、不写入 Git。
- 管理端、备份和监控访问应限制到管理网或 VPN。
+66
View File
@@ -0,0 +1,66 @@
# 容量与压测方案
## 目标
压测用于回答“在某个明确硬件、软件版本、配置和业务模型下,能够稳定承载多少负载”,而不是只给出一个脱离场景的并发数。
必须分开衡量:
1. 本地平台容量:网关、后端、数据库、Redis 和对象存储。
2. 外部依赖体验:Tripo 的排队、生成、轮询、下载、限流和错误。
3. 农场端能力:后续工作站接入后的任务吞吐、断线恢复和打印机处理速度。
## 测试场景
| 编号 | 场景 | 主要瓶颈 |
| --- | --- | --- |
| S01 | 健康检查、登录、用户与模型列表读取 | 网关、API、数据库连接池 |
| S02 | 管理端搜索、分页、统计查询 | SQL、索引、CPU、数据库缓存 |
| S03 | 文件预签名、上传和下载 | 网络、对象存储、磁盘 I/O |
| S04 | 任务创建、状态轮询、结果持久化 | API、Redis、数据库写入 |
| S05 | Tripo 提交与轮询 | 外部 API 延迟/限流、本地状态机 |
| S06 | 读写、文件和任务的业务比例混合负载 | 整机资源争用 |
| S07 | 后续中心到农场端任务分发与状态回传 | 设备队列、网络、幂等与重试 |
S05 必须同时报告“本地处理耗时”和“Tripo 外部等待耗时”,不能用 Tripo 的波动推导本地服务器极限。
## 负载方法
- 先做 5 分钟预热,再保持 15–30 分钟稳态,最后观察 5 分钟恢复。
- 从低负载开始,以 `1、2、5、10、15、20…` 并发逐级增加;接近瓶颈后缩小步长。
- 每个稳态档位重复至少 3 次,报告中位数以及最好/最差值,不只保留一次结果。
- 使用固定的脱敏数据集、对象大小分布和业务操作比例。
- 文件场景至少区分小文件、典型模型文件和大文件;记录客户端与服务器网络速率。
- 在 32GB、64GB 或不同磁盘方案之间对比时,只改变一个主要变量。
## 必采指标
- 业务:吞吐量、成功率、错误码、p50/p95/p99、超时、队列长度。
- 主机:CPU/Load、可用内存、Swap in/out、磁盘吞吐/IOPS/await/利用率、网络吞吐与丢包。
- 容器:CPU、内存、重启次数、健康状态、限额和 OOM。
- PostgreSQL:活跃/等待连接、连接池、慢 SQL、锁等待、缓存命中、事务率。
- Redis:命令延迟、连接、内存、eviction、持久化状态。
- 对象存储:上传/下载吞吐、首字节时间、错误率、磁盘占用。
- Tripo:提交/轮询/下载分别耗时,API 限流、错误、外部排队时长。
## 停止与失效条件
以下任一情况出现时停止继续加压,保留现场数据并定位瓶颈:
- 发生 OOM、持续 Swap 抖动、容器反复重启或数据错误;
- 错误率持续超过该场景 SLA(初始探索可用 1% 作为警戒线);
- p95/p99 持续恶化且负载降低后不能恢复;
- CPU 长时间接近满载,或磁盘等待/队列持续增长;
- 数据库连接池耗尽、锁等待累积或任务队列只增不减;
- 外部 API 进入限流,此时记录为外部边界,不继续推高调用。
## 单次运行产物
每次运行必须保存:
- `benchmark/run-metadata.template.yml` 对应的完整元数据;
- 压测脚本版本、开始/结束时间、场景和并发曲线;
- 原始请求结果与监控快照(放 `results/raw/`);
- 瓶颈分析和客户可读结论(放 `results/reports/`);
- 本次结论的适用范围、已知限制和下一步验证。
+183
View File
@@ -0,0 +1,183 @@
# AI SoulMate 本地部署跨电脑交接说明
## 2026-08-05 本次接管更新
- 已从用户提供的压缩包恢复部署仓库,确认 Git 分支为 main,但此前没有任何 commit,也没有远端。
- 已新增 Ubuntu 22.04 运行手册、源码版本核对说明、Docker 官方仓库安装脚本、随机密钥生成脚本和源码基线采集脚本。
- 已新增 PostgreSQL、Redis、MinIO 基础设施 POC Compose;三个宿主机端口只绑定到 127.0.0.1,并带持久化、健康检查、资源上限和日志轮换。
- 接管前当前工作区只有另一个指向 Gitee/Spring Boot 的 ai-soulmate-server 本地仓库,不能作为内部 FastAPI 仓库的发布基线。
- 已只读核对并浅克隆四个内部远端:server develop6@9a6f7a5、client master@9ebb082、admin main@40bd686、nginx master@6f552f4;server/client 与旧交接基线不同。
- server 默认分支使用 Hunyuan3D/Bailian 而不是需求描述的 Tripo,因此发布分支选择仍是业务改造前的阻断项。
- 四个仓库存在被 Git 跟踪的真实环境文件,server 还含支付/私钥类值;所有相关凭据必须先轮换,具体值未复制到部署仓库。
- 当前 ai-soulmate-server 的 Dockerfile 只有开发目标,开发 Compose 使用源码 bind mount,而且 backend-java/.env 已被源码仓库跟踪;部署前必须审查并轮换其中凭据。
- 下一安全动作是在服务器运行 collect-host-facts.sh,完成系统更新和 Docker 安装,然后重新克隆四个源码仓库并生成 source-check 报告。
- 首次 Git commit 会在本次接管检查完成后创建;远端仍需用户在 Gitea 建立空的私有仓库后再配置和推送。
更新时间:2026-08-05
这份文档用于在另一台电脑继续本地部署适配。它记录事实、已完成事项和下一步顺序;不要把文档中的示例 IP、密码或 API Key 当成生产配置。
## 一句话状态
服务器已经可以通过 SSH 访问,但业务系统尚未部署;本地部署 Git 仓库只在当前电脑创建过,尚未建立远端、尚未完成首个提交。换电脑时需要复制或重新建立该仓库。
## 已确认事实
### 服务器
- Ubuntu 22.04.2 LTS,x86_64,内核 5.19.0-32-generic。
- 网卡 `enp1s0` 已拿到 `192.168.3.102`,SSH 已成功连接。
- `openssh-server` 已安装并可以连接。
- `ufw status verbose` 显示 `inactive`,目前没有 UFW 规则阻断 SSH。
- 尚未确认 SSH 公钥登录是否完成;尚未关闭密码登录。
- 尚未完成系统更新、Docker、Compose、PostgreSQL、Redis、对象存储和网关部署。
- 应在路由器或网络设备上为服务器做 DHCP 地址保留,避免重启后 IP 变化。
### 样机硬件
- HP ZCentral 4R Workstation。
- Intel Xeon W-2225,4 核 8 线程。
- 32GiB ECC DDR4,单条内存,约 1TB 单块 Samsung NVMe。
- Swap 2GiB,单盘无冗余。
- 适合 POC、适配和容量边界测试,不可直接作为生产高可用承诺。
### 源码版本基线
| 仓库 | 当前提交 |
| --- | --- |
| `ai-soulmate-server` | `24769465d3ac2cb840c5266c8c0def2aacb641aa` |
| `ai-soulmate-client` | `170847159a787c7b52e3f9f792d72ea67cbd7fa4` |
| `mlkj-admin` | `40bd686128010fbbc6c33f6156a7a3cda5336b3a` |
| `nginx-server` | `6f552f4b37505ec055cdd179fe9cc5a6825a4189`,仅做过远端检查 |
完整清单见 [`inventory/source-baselines.yml`](../inventory/source-baselines.yml)。
## 当前部署目标
中心服务器先运行:
```text
统一网关 → 平台前端 / AI SoulMate 管理端 → 平台后端
├→ PostgreSQL
├→ Redis
├→ 本地 S3 兼容对象存储
└→ Tripo 外部 API
```
后续农场工作站运行 `ai-soulmate-client`,通过 HTTPS 心跳、拉取任务和上报状态,不把打印机直接暴露给中心服务器。
Tripo 当前仍是外部 API,因此目标是本地化业务平台和数据基础设施,不是当前阶段的完全离线部署。
## 换电脑时重建 Git 仓库
### 推荐:复制现有部署目录
把当前电脑的整个目录复制到新电脑,包含未提交文件但不需要复制 `.git`:
```text
/Users/max/AI SoulMate/开发/ai-soulmate-local-deployment
```
在新电脑进入目录后检查:
```bash
git status
git branch --show-current
```
如果没有 `.git`,重新初始化:
```bash
git init -b main
```
### 需要长期留档时
先在 Gitea 创建一个空的私有仓库,例如 `MLKJ/ai-soulmate-local-deployment`,再在新电脑执行:
```bash
git add .
git commit -m "chore: initialize local deployment baseline"
git remote add origin <GITEA_REPOSITORY_URL>
git push -u origin main
```
远端 URL、账号和访问令牌不要写入文档或 `.env`。如果部署目录没有复制过来,必须先恢复本目录中的 `README.md`、`docs/`、`inventory/`、`benchmark/`、`scripts/`、`compose/` 和 `decisions/`,再执行上述提交。
## 新电脑接管顺序
### A. 先固定 SSH 访问
在新电脑生成或准备 SSH 密钥,把公钥加入服务器 `hp` 用户:
```bash
ssh-keygen -t ed25519 -a 64 -f ~/.ssh/id_ed25519_ai_soulmate
cat ~/.ssh/id_ed25519_ai_soulmate.pub | ssh hp@192.168.3.102 \
'umask 077; mkdir -p ~/.ssh; cat >> ~/.ssh/authorized_keys'
```
确认密钥登录成功后,才考虑关闭密码登录。修改 SSH 配置前保留当前会话,并先用 `sudo sshd -t` 检查配置。
### B. 记录并更新服务器
在服务器上执行:
```bash
whoami
hostnamectl
ip -br addr
sudo systemctl is-active ssh
df -hT /
free -h
lscpu
sudo timedatectl set-timezone Asia/Shanghai
sudo apt update
sudo apt install -y git curl ca-certificates gnupg jq unzip rsync tmux htop nvme-cli smartmontools
sudo apt upgrade -y
```
如果出现 `/var/run/reboot-required`,记录后再重启,并重新确认服务器 IP。
### C. 安装容器运行时
使用 Docker 官方 Ubuntu 仓库安装 Docker Engine、Buildx 和 Compose plugin。安装前确认网络、DNS、NTP 和磁盘空间;不要使用来源不明的一键安装脚本。
安装后至少验证:
```bash
docker version
docker compose version
sudo systemctl is-active docker
```
### D. 再开始业务改造
不要直接把当前四个仓库用现有 Compose 上线。必须先完成:
1. 平台后端和管理端的 OSS provider 抽象,并验证本地 S3 兼容对象存储。
2. 管理端 `ai-soulmate-only` 模式,避免强制连接其他业务数据库。
3. 生产前端构建和不可变镜像,去除源码 bind mount。
4. 初始化/迁移、备份/恢复、健康检查和密钥注入。
5. 网关路由、TLS、上传限制和管理入口隔离。
具体路线见 [`IMPLEMENTATION-ROADMAP.md`](IMPLEMENTATION-ROADMAP.md),压测规则见 [`BENCHMARK-PLAN.md`](BENCHMARK-PLAN.md)。
## 不要做的事情
- 不要把 SSH、PostgreSQL、Redis 或对象存储管理端口暴露到公网。
- 不要把真实密码、Tripo Key、OSS Key、证书或客户数据提交到 Git。
- 不要把 Tripo 的端到端延迟直接当作本地服务器并发能力。
- 不要在单盘、32GB POC 样机上直接承诺生产高可用或客户 SLA。
- 不要在没有备份恢复演练前导入唯一生产数据。
## 接管清单
- [ ] 新电脑已恢复部署仓库目录。
- [ ] Git 仓库已初始化并完成首次提交。
- [ ] 已创建私有远端并推送 `main`。
- [ ] Mac/新电脑使用密钥登录服务器。
- [ ] 服务器 IP 已固定或完成 DHCP 保留。
- [ ] 已完成系统更新和硬件基线采集。
- [ ] 已安装并验证 Docker Compose。
- [ ] 已完成 P1/P2 源码改造后再创建正式 Compose。
+110
View File
@@ -0,0 +1,110 @@
# Ubuntu 22.04 本地部署运行手册
这台 HP ZCentral 4R 是 POC 和适配样机。当前目标是跑通中心服务、管理端、PostgreSQL、Redis、本地对象存储和 Tripo 出站调用;它不是生产高可用承诺。
## 0. 先确认网络和 SSH
在服务器本地控制台或当前 SSH 会话记录:
~~~bash
hostnamectl
nmcli device status
ip -br addr
sudo systemctl is-active ssh
df -hT /
free -h
~~~
在路由器上为有线网卡做 DHCP reservation,或者使用网络管理员批准的静态地址。不要凭 enp1s0、eno1 这样的示例名修改连接。保留当前密码 SSH 会话,直到另一台电脑用 Ed25519 密钥成功登录。
## 1. 固化主机基线
~~~bash
cd /srv/ai-soulmate-local-deployment
chmod +x scripts/*.sh
./scripts/collect-host-facts.sh \
> results/raw/host-facts-$(date +%Y%m%d-%H%M%S).txt
~~~
原始文件默认不进 Git。审阅后只把脱敏结论写入 results/reports/,不要记录 IP、MAC、序列号、UUID 或客户数据。
## 2. 安装 Docker 和工具
~~~bash
cd /srv/ai-soulmate-local-deployment
sudo TIMEZONE_NAME=Asia/Shanghai RUN_UPGRADE=1 \
./scripts/bootstrap-ubuntu-22.04.sh
~~~
脚本使用 Docker 官方 apt 仓库,不修改网络地址、不自动打开防火墙端口,也不会替代现场重启决策。若出现 /var/run/reboot-required,先记下结果,再重启并重新确认 IP、SSH、磁盘和 Docker。
## 3. 放置并核对源码
源码与部署仓库分开,例如:
~~~bash
sudo mkdir -p /srv/ai-soulmate/sources
sudo chown -R "$USER":"$USER" /srv/ai-soulmate
cd /srv/ai-soulmate/sources
git clone http://39.106.119.229:3000/MLKJ/ai-soulmate-server
git clone http://39.106.119.229:3000/MLKJ/ai-soulmate-client
git clone http://39.106.119.229:3000/MLKJ/mlkj-admin
git clone http://39.106.119.229:3000/MLKJ/nginx-server
~~~
如果仓库已经存在,不要直接覆盖用户改动;逐个执行 git status --short、git remote -v 和 git rev-parse HEAD。完成后生成核对报告:
截至 2026-08-05,server 默认分支是 develop6,但其 AI provider 与需求描述不一致;client 的旧交接 SHA 也不是默认分支 HEAD。克隆完成不代表发布分支已经选定,必须由仓库负责人确认 release branch/tag 后再继续。
~~~bash
cd /srv/ai-soulmate-local-deployment
SOURCE_ROOT=/srv/ai-soulmate/sources \
./scripts/record-source-baseline.sh \
> inventory/source-check-$(date +%F-%H%M%S).yml
~~~
## 4. 先启动基础设施
~~~bash
cd /srv/ai-soulmate-local-deployment
./scripts/create-local-env.sh compose/.env
docker compose --env-file compose/.env \
-f compose/docker-compose.infra.yml config
docker compose --env-file compose/.env \
-f compose/docker-compose.infra.yml pull
docker compose --env-file compose/.env \
-f compose/docker-compose.infra.yml up -d
docker compose --env-file compose/.env \
-f compose/docker-compose.infra.yml ps
./scripts/verify-infra.sh compose/.env
~~~
PostgreSQL、Redis 和 MinIO 只绑定到 127.0.0.1。未来业务容器使用 postgres:5432、redis:6379 和 minio:9000,不要把 .env 中的宿主机端口当作容器间地址。MinIO 控制台需要时使用 SSH 隧道,不开放公网管理端口。
## 5. 业务部署门槛
当前 ai-soulmate-server 的 Dockerfile 只有开发目标,开发 Compose 还挂载源码;压缩包中的 ai-soulmate-server-master 没有可验证的 Git 历史。先完成以下改造,再写应用 Compose:
1. 平台和管理端引入统一对象存储接口,同时保留 Alibaba OSS provider,并让 MinIO 等本地 S3 provider 通过预签名上传、下载、分片、CORS、权限、元数据和恢复测试。
2. mlkj-admin 增加 AI SoulMate-only profile,不能初始化无关业务库、默认账号或固定密码。
3. 为后端、平台前端和管理端生成生产镜像;禁止源码 bind mount,固定基础镜像版本并记录 digest。
4. 添加迁移、健康检查、资源上限、日志轮换、备份恢复和回滚流程。
5. 再决定是否使用 nginx-server。它只承担环境无关的 TLS、路由、上传限制、访问日志和限流;若现场已有企业网关,优先复用企业网关。
## 6. 验收顺序
按 S01 到 S07 的场景逐级验收:健康检查和登录 → 管理端查询 → 对象上传下载 → 任务创建与轮询 → Tripo 出站 → 混合负载 → 工作站任务下发。Tripo 的提交、轮询、下载、外部排队和限流时间必须单独记录,不能作为本地并发能力。
每次压测使用固定数据集和请求比例,从并发 1, 2, 5, 10, 15, 20... 逐级增加;每个稳定档位至少重复三次,保存元数据、脱敏报告和原始日志位置。出现 OOM、持续 swap、容器重启、数据错误、队列增长或外部 API 限流时停止加压。
## 7. Git 留档
~~~bash
cd /srv/ai-soulmate-local-deployment
git add .
git commit -m "chore: initialize local deployment baseline"
git remote add origin <GITEA_REPOSITORY_URL>
git push -u origin main
~~~
远端仓库需要先在 Gitea 创建为空的私有仓库。不要把账号密码、访问令牌或真实 .env 写进 URL、文档或 Git;当前部署仓库只有在产生首个 commit 后才算完成留档。
+67
View File
@@ -0,0 +1,67 @@
# 本地部署改造路线
## P0:冻结基线
- [x] 记录现有三个源码仓库提交。
- [x] 记录样机 CPU、内存、磁盘、操作系统和网络状态。
- [ ] 为四个源码仓库建立本地部署开发分支和对应需求清单。
- [ ] 确认数据库版本、现有数据量、OSS 对象量和允许停机窗口。
验收:任何一次测试都能关联到硬件、源码、配置和数据集版本。
## P1:平台后端与对象存储解耦
- [ ] 将阿里 OSS 调用收敛为对象存储接口。
- [ ] 实现 Alibaba OSS 与本地 S3 兼容存储两个 provider。
- [ ] 验证预签名上传/下载、分片上传、CORS、文件元数据和清理任务。
- [ ] 将 Tripo 封装为 provider,保留外部 API,并为未来私有端点预留配置。
- [ ] 移除生产 Compose 中的源码 bind mount,构建不可变镜像。
验收:切换存储 provider 不需要修改业务代码;对象迁移后原有 URL 使用场景可回归。
## P2:管理端 AI-only 模式
- [ ] 增加 `ai-soulmate-only` 配置或 profile。
- [ ] 非 AI SoulMate 数据源和模块在该模式下不初始化。
- [ ] 管理端对象存储改用同一 provider/兼容接口。
- [ ] 清理默认账号、测试数据和固定密码。
验收:只配置 AI SoulMate 数据库即可启动管理端并完成核心管理功能。
## P3:可交付单机编排
- [ ] 编排网关、前后端、管理端、PostgreSQL、Redis 和对象存储。
- [ ] 所有镜像固定版本或 digest,服务带健康检查与资源限制。
- [ ] 提供初始化、升级、回滚、备份、恢复和日志收集脚本。
- [ ] 将持久化目录与容器生命周期分离,定义磁盘容量告警。
- [ ] 默认只开放 `22`(受限管理)和 `443`(业务)端口。
验收:在干净 Ubuntu 22.04 主机上按文档可重复安装、重启和恢复。
## P4:样机 POC
- [ ] 激活有线网络并分配固定地址,校准 NTP,验证 DNS 与 Tripo 出站访问。
- [ ] 导入脱敏数据库和对象样本,执行数据库迁移。
- [ ] 回归登录、模型生成、上传下载、订单/任务和管理端流程。
- [ ] 完成一次备份恢复演练和宿主机重启演练。
验收:核心业务链路跑通,重启无数据丢失,备份能够在空环境恢复。
## P5:农场工作站接入
- [ ] 将前端改为生产构建,不使用 Vite 开发服务器。
- [ ] 每台设备使用独立身份和可撤销凭证,替换全局客户端令牌。
- [ ] 实现任务幂等、断线续传、失败重试和本地队列上限。
- [ ] 验证 Moonraker/打印机协议、升级和远程诊断。
验收:中心短暂断网后任务不重复、不丢失,恢复后状态最终一致。
## P6:容量测试与客户档位
- [ ] 先测本地只读、写入、文件和混合负载。
- [ ] 再测包含 Tripo 的端到端链路,并剥离外部等待时间。
- [ ] 分别测试当前 32GB 和内存升级后的配置。
- [ ] 将稳定并发、瓶颈、资源余量和推荐参数写入版本化报告。
验收:每个客户硬件档位都由可复现的测试数据支撑,并明确适用业务模型与 SLA。
+51
View File
@@ -0,0 +1,51 @@
# POC 样机硬件基线
基线日期:2026-08-05。数据来自现场命令截图;首次联网部署前应运行 `scripts/collect-host-facts.sh` 生成机器可读基线并复核。
## 已确认配置
| 项目 | 当前配置 |
| --- | --- |
| 设备 | HP ZCentral 4R Workstation |
| 操作系统 | Ubuntu 22.04.2 LTS |
| 内核/架构 | Linux 5.19.0-32-generic,x86_64 |
| CPU | Intel Xeon W-2225,4 核 8 线程,单路,最高约 4.6GHz |
| NUMA | 1 个节点 |
| 内存 | 32GiB ECC DDR4,单条,标称 3200 MT/s,配置 2933 MT/s |
| Swap | 2GiB |
| 磁盘 | 单块约 1TB Samsung NVMe,根分区 ext4 |
| 可用空间 | 根分区约 882GiB 可用(截图时) |
| 网络 | `enp1s0` 与 `eno1` 均为 DOWN,尚未形成网络基线 |
为避免泄露现场资产信息,本仓库不记录主机序列号、UUID、磁盘序列号、MAC 地址和真实 IP。
## 适用范围
这台机器适合:
- 单机容器化适配与功能回归;
- PostgreSQL、Redis、对象存储和业务服务共机时的容量边界测试;
- 识别 CPU、内存、磁盘和外部 API 的首个瓶颈;
- 为后续不同硬件档位建立对照基线。
它不代表生产高可用能力:只有一块系统/数据盘,任一磁盘故障都会影响全部服务;4 核 CPU 也会让数据库、对象存储与应用争抢资源。
## 部署前动作
1. 接通有线网络,确定固定 IP、DNS、NTP、默认路由和 Tripo 所需出站策略。
2. 更新 Ubuntu 22.04 安全补丁,记录 BIOS、内核与 Docker 版本。
3. 确认 NVMe SMART/健康状态;生产方案必须设计独立数据盘、备份目标或冗余。
4. 将 Swap 调整视为防 OOM 保护而非可用内存,压测报告必须记录 swap in/out。
5. 若条件允许,增加同规格 ECC 内存至 64GB,再做一组对照测试;不要把升级后的结论套用到 32GB 配置。
6. 压测期间关闭无关桌面应用,固定电源/性能策略,并记录所有参数变化。
## 当前风险
| 风险 | 对测试的影响 | 处理方式 |
| --- | --- | --- |
| 单块 NVMe | 数据库、对象存储、日志相互争抢 I/O | 监测磁盘延迟和利用率;容量报告明确单盘条件 |
| 单条 32GB 内存 | 内存容量和带宽可能先成为瓶颈 | 记录内存/Swap;增加 64GB 对照组 |
| 4 核 8 线程 | 共机服务容易发生 CPU 争用 | 设置容器资源上限并逐级加压 |
| 网卡未启用 | 无法验证局域网和 Tripo 端到端链路 | 部署前先完成网络基线与出站测试 |
| 无冗余 | 不适合据此宣称生产可用性 | 将 POC 容量与生产可靠性方案分开 |
+29
View File
@@ -0,0 +1,29 @@
# 安全与发布阻断项
## P0:凭据轮换
四个远端仓库的当前检出版本中存在被 Git 跟踪的非示例 .env 或 .env.server。ai-soulmate-server 的 Compose 还包含真实或疑似真实的支付密钥、私钥和固定数据库密码。
这些值必须视为已泄露:
1. 先在支付、短信、邮件、数据库、Redis、对象存储、JWT 和外部 AI 服务侧轮换或撤销。
2. 从当前源码和后续镜像中移除真实值,只保留变量名与安全示例。
3. 检查 Git 历史和镜像层;历史清理需要团队协调,不能在共享仓库上直接强推。
4. 用服务器本地 0600 权限的 .env、Docker secrets 或客户密钥系统注入。
部署仓库不保存任何发现到的真实值。
## P0:选择发布基线
ai-soulmate-server 默认分支 develop6 的 3D 集成是 Hunyuan3D/Bailian,不是用户描述的 Tripo;旧交接 SHA 也不是任何远端分支的当前 tip。ai-soulmate-client 的旧交接 SHA 位于 fix/client-login-403,而默认 master 已前进。
在用户或仓库负责人明确 server/client 的发布分支或 tag 前,不开始业务代码改造,也不生成应用镜像。选择后应创建 local-deployment 分支并把 SHA 写入 inventory。
## P1:开发配置不能上线
- server 使用 Uvicorn reload、Vite 开发服务器、源码 bind mount、latest 镜像和对外数据库/Redis 端口。
- client 前端仍使用 Vite 开发服务器和源码 bind mount,数据库使用固定密码并对宿主机开放。
- admin 同时强依赖四个数据源,尚未验证 AI SoulMate-only 模式。
- nginx 绑定现有公网域名、证书路径和固定 upstream,不能直接交付给内网客户。
应用 Compose 必须等到生产镜像、最小权限、健康检查、资源上限、迁移、备份恢复、端口收敛和凭据注入全部完成。
+38
View File
@@ -0,0 +1,38 @@
# 源码版本核对
## 为什么要重新核对
压缩包中的 inventory/source-baselines.yml 记录了上一台电脑看到的四个提交。只读远端核对后,server 默认分支是 develop6@9a6f7a5,client 默认分支是 master@9ebb082;两者均与旧记录不同。admin 和 nginx 与旧记录一致。另一个本地 ai-soulmate-server 目录指向不同的 Gitee/Spring Boot 代码库,不能与内部 FastAPI 仓库混用。
因此,当前状态是“交接资料已恢复,源码基线尚未复核”,不是“源码已经可以部署”。
server 默认分支还使用 Hunyuan3D/Bailian,而用户描述的是 Tripo。必须先由仓库负责人明确 server/client 的发布分支或 tag,再创建本地部署适配分支;默认分支不能自动视为发布版本。
## 在服务器上复核
把四个源码仓库放在同一个目录,例如 /srv/ai-soulmate/sources,然后执行:
~~~bash
cd /srv/ai-soulmate-local-deployment
SOURCE_ROOT=/srv/ai-soulmate/sources \
./scripts/record-source-baseline.sh \
> inventory/source-check-$(date +%F-%H%M%S).yml
~~~
提交前检查:
~~~bash
git diff -- inventory/source-check-*.yml
git status --short
~~~
报告可以提交,但真实 .env、Token、证书、用户数据和原始日志不能提交。脚本会标记仓库是否跟踪任何非示例 .env 文件;一旦为 true,先审查历史并轮换凭据,再做远端推送。
## 当前四个仓库的边界
| 仓库 | 当前行动 |
| --- | --- |
| ai-soulmate-server | 先完成本地 PostgreSQL、Redis、S3 provider 和生产镜像适配 |
| ai-soulmate-client | 后续放到靠近打印机的工作站,先做设备凭证、离线队列和幂等重试 |
| mlkj-admin | 只启用 AI SoulMate 数据源和模块,移除无关初始化与默认账号 |
| nginx-server | 只参考网关职责,不直接复制公网域名和路由;应用镜像完成后再决定是否使用 |