# 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 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。