部署准备
一、系统要求
| 项 | 要求 | 说明 |
|---|---|---|
| 操作系统 | CentOS 8+ / RHEL 8+ / Ubuntu 22.04+ | 麒麟 / 统信请按对应 RHEL/Ubuntu 基线评估 |
| CPU 架构 | x86_64（amd64） / arm64 | |
| 内核 | Linux 5.13+ | uname -r |
| CPU | 8 核及以上 | |
| 内存 | 16 GB 及以上 | |
| 磁盘 | 200 GB 及以上可用空间 | 数据盘建议 SSD |
二、软件依赖
| 软件 | 版本要求 | 验证命令 |
|---|---|---|
| Docker Engine | 24.x 及以上 | docker --version |
| Docker Compose | v2.x（非 v1） | docker compose version |
| 基础工具 | tar、openssl | tar --version && openssl version |
| cgroup v2 | 已启用（unified 层级） | stat -fc %T /sys/fs/cgroup/ 输出 cgroup2fs，或 `mount |
三、离线包说明
| 项 | 详情 |
|---|---|
| 文件名 | chatkit-offline-release-1.0.xx-linux-amd64-xxxxxxxx.tar.gz |
| 大小 | 约 4 GB |
| 包含内容 | 全部微服务镜像 + AI 运行时（ai-infra-rs）+ 部署脚本 |
| 推荐存放位置 | 数据盘（如 /data/），不要放系统盘 / |
四、LLM 模型信息（后台配置）
FinClaw 依赖外部 LLM 提供商进行推理。需要提前从模型提供商获取以下关键信息，部署完成后在管理后台（Admin）中配置：
| 项 | 说明 | 示例 |
|---|---|---|
| 提供商 | LLM 提供商（支持 openai / anthropic / deepseek / qwen / ollama / litellm / custom 等） | deepseek |
| 模型名称 | 模型标识 | deepseek-v4-flash |
| API Key | API 密钥 | sk-xxxxxxxx... |
| Base URL | 自定义服务地址（按需） | https://api.deepseek.com/v1 |
五、端口要求
FinClaw 默认使用 261xx ~ 264xx 区间端口，对外入口为 API Gateway（26100）。
| 用途 | 端口 | 是否需要对外开放 |
|---|---|---|
| API Gateway（统一入口） | 26100 | ✅ 必须 |
| 其他服务 | 261xx – 265xx | ❌ 内部 |
完整端口与服务对照见 部署组件。