部署准备
一、系统要求
| 项 | 要求 | 说明 |
|---|---|---|
| 操作系统 | CentOS 8+ / RHEL 8+ / Ubuntu 22.04+ | 暂不支持 ARM64，麒麟 / 统信请按对应 RHEL/Ubuntu 基线评估 |
| CPU 架构 | x86_64（amd64） | 不支持 aarch64 |
| 内核 | Linux 4.18+ | 需支持 cgroup v2 与现代 Docker |
| CPU | 8 核及以上 | 单机部署生产环境推荐 16 核 |
| 内存 | 16 GB 及以上 | 单机部署生产环境推荐 32 GB |
| 磁盘 | 100 GB 及以上可用空间 | 数据盘建议 SSD |
二、软件依赖
| 软件 | 版本要求 | 验证命令 |
|---|---|---|
| Docker Engine | 24.x 及以上 | docker --version |
| Docker Compose | v2.x（非 v1） | docker compose version |
| 基础工具 | tar、openssl | tar --version && openssl version |
三、离线包说明
| 项 | 详情 |
|---|---|
| 文件名 | chatkit-offline-release-1.0.xx-linux-amd64-xxxxxxxx.tar.gz |
| 大小 | 约 4 GB |
| 包含内容 | 全部微服务镜像 + AI 运行时（ai-infra-rs）+ 部署脚本 |
| 推荐存放位置 | 数据盘（如 /data/），不要放系统盘 / |
四、LLM 运行时凭证
FinClaw 依赖外部 LLM 提供商进行推理，部署前需准备以下环境变量：
| 变量 | 说明 | 示例 |
|---|---|---|
LLM_PROVIDER | LLM 提供商 | deepseek、openai |
LLM_MODEL | 模型名称 | deepseek-chat、gpt-4o-mini |
LLM_API_KEY | API 密钥 | sk-xxxxxxxx... |
LLM_BASE_URL | 自定义 Base URL（按需） | https://api.deepseek.com/v1 |
五、端口要求
FinClaw 默认使用 261xx ~ 264xx 区间端口，对外入口为 API Gateway（26100）。
| 用途 | 端口 | 是否需要对外开放 |
|---|---|---|
| API Gateway（统一入口） | 26100 | ✅ 必须 |
| 其他服务 | 261xx – 265xx | ❌ 内部 |
完整端口与服务对照见 部署组件。