部署与交付

阶段一：需求确认（1 次沟通）

需要你们说明四件事：

1. 网络条件：服务器是否在内网、有没有外网出口、客户端机器能否访问服务器；
2. 规模：成员数、预计记忆量、并发检索量；
3. 基础设施：操作系统、是否已有 PostgreSQL、是否已有反向代理与证书；
4. 合规要求：是否涉及等保、是否有审计与日志留存要求。

我们会据此给出一版部署方案与报价。

阶段二：License 与交付物

方案确认后提供：

交付物	内容
离线安装包	服务端镜像 + 客户端各平台安装包 + 依赖镜像
License 文件	组织名、席位、有效期，离线签名，程序内置公钥验签
部署文档	Compose 编排、环境变量、初始化步骤、验收清单
运维手册	备份、监控、升级、故障排查

License 与组织绑定。席位变更需要重新签发，走维保流程。

阶段三：部署

标准形态是一套 Docker Compose：

反向代理（你们的 nginx / 网关，带证书）
  ├── 应用（Hono 服务端）
  ├── PostgreSQL 17 + pgvector
  └── 对象存储（可选：MinIO 或你们已有的 OSS 兼容存储）

关键步骤：

1. 导入镜像（离线环境用 docker load）；
2. 初始化数据库并执行迁移（迁移只增不改，可重复执行）；
3. 配置环境变量：数据库连接、对外地址、License 路径；
4. 导入 License，启动服务，访问 /healthz 确认存活；
5. 配置反向代理与证书（内部 CA 也行，客户端信得过即可）。

客户端侧的向量检索能力在私有化环境同样可用——不依赖外网，模型文件随安装包提供。

阶段四：成员接入

管理员先建组织与空间树，再邀请成员。成员侧三步：

1. 安装客户端（离线包）；
2. 绑定组织：内网地址 + 绑定票 / 长期密钥；
3. 接入 AI 客户端（与公有版完全一致的 MCP 配置，只是指向内网地址）。

{
  "mcpServers": {
    "xiaobenben": {
      "command": "C:\\Users\\用户名\\.xiaobenben\\bin\\xbb.exe",
      "args": ["mcp"],
      "env": { "XBB_API_BASE": "https://xbb.你们内网域名" }
    }
  }
}

环境变量名以部署文档为准。私有化形态下不要让客户端去连公有云的默认地址。

阶段五：验收

建议按这张清单逐项确认：

• 服务端 /healthz 返回正常；
• 管理员能登录 Web 界面，看到空间树与成员；
• 成员绑定成功，xbb cloud 显示内网组织；
• 成员写入一条记忆，部门空间可见范围内能被同事检索到；
• 指派与签收可走通（到达 → 查看 → 签收）；
• 断网测试：拔掉外网后系统仍完整可用；
• 备份与恢复演练通过（备份文件能在异地恢复出可用的库）。

升级

升级包同样离线。建议做法：

1. 先在预生产（如果有）或单台测试机验证；
2. 备份数据库；
3. 替换镜像、执行迁移（迁移只增，失败可回滚镜像）；
4. 客户端可选升级——协议向后兼容，不必强制全员同时升级。

维保期内提供升级包与升级支持。

我们不会做的事

• 不进入你们的内网，不持有生产访问凭据（需要远程协助时由你们开通道并全程在场）；
• 不代做运维（备份、监控、容量）——私有化的边界就是”系统在你们手上”；
• 不承诺”过等保”，只提供产品侧的配合材料。

相关

• 定价详情
• 功能说明
• 常见问题