自托管部署

自托管部署智汇 AI

从单机 Docker Compose 到 Kubernetes 多节点高可用,完整覆盖企业级私有化部署。 Apache 2.0 开源,数据 100% 在你的基础设施。

方式一:Docker Compose 单机版(5 分钟)

适合个人开发者、小团队、PoC 验证。一台服务器即可运行全部服务。

环境要求

CPU:2 核(推荐 4 核)
内存:4 GB RAM(推荐 8 GB)
磁盘:20 GB SSD(推荐 50 GB)
系统:Linux / macOS / Windows WSL2
软件:Docker 24+ / Docker Compose v2+
GPU:不需要(默认走云端 API,本地模型可接 Ollama)

部署步骤

# 1. 克隆仓库
git clone https://github.com/ihui-ai/ihui-ai.git
cd ihui-ai

# 2. 配置环境变量
cp .env.example .env
# 编辑 .env,必填项:
# - DATABASE_URL=postgresql://ihui:ihui@postgres:5432/ihui
# - REDIS_URL=redis://redis:6379
# - JWT_SECRET=<随机 32 字符串>
# - OPENAI_API_KEY=sk-...(可选,不填则用统一积分)

# 3. 一键启动
docker compose up -d

# 4. 查看日志
docker compose logs -f web api ai-service

# 5. 访问
open http://localhost:8801
# 管理员:admin(口令由部署环境注入,首次登录后立即改密)

服务端口

8801 — Web 前端(Next.js 16)
3001 — API 后端(Fastify 5)
8000 — AI Service(FastAPI)
5432 — PostgreSQL 18
6379 — Redis 7

方式二:Kubernetes Helm Chart(高可用)

适合企业生产环境,支持水平扩展、滚动升级、自动备份、监控告警。

集群要求

Kubernetes 1.28+
至少 3 节点(控制面 + 2 工作节点)
每节点 4 核 / 8 GB RAM
StorageClass(默认提供 local-path,生产建议用云盘)
Ingress Controller(Nginx / Traefik / ALB)
cert-manager(自动 HTTPS)

Helm 部署

# 1. 添加 Helm 仓库
helm repo add ihui https://charts.ihui.ai
helm repo update

# 2. 创建命名空间
kubectl create namespace ihui

# 3. 配置 values.yaml
cat > values.yaml <<EOF
image:
  registry: registry.cn-shenzhen.aliyuncs.com
  repository: ihui/ihui-ai
  tag: latest

ingress:
  enabled: true
  hostname: ihui.example.com
  tls: true

postgres:
  enabled: true
  persistence:
    size: 50Gi

redis:
  enabled: true
  persistence:
    size: 10Gi

# 生产环境必填
secrets:
  jwtSecret: "<随机 32 字符串>"
  openaiApiKey: "sk-..."

# 水平扩展
web:
  replicas: 2
api:
  replicas: 3
aiService:
  replicas: 2
EOF

# 4. 安装
helm install ihui ihui/ihui-ai \
  -n ihui \
  -f values.yaml

# 5. 查看
kubectl get pods -n ihui
kubectl get ingress -n ihui

核心配置项

环境变量

必填

说明

DATABASE_URL

是

PostgreSQL 连接串

REDIS_URL

是

Redis 连接串(缓存 + 队列)

JWT_SECRET

是

JWT 签名密钥(≥ 32 字符)

OPENAI_API_KEY

否

OpenAI 密钥,不填则用统一积分

AI_SERVICE_URL

是

AI Service 内部地址

S3_ENDPOINT

否

对象存储(不填用本地磁盘)

运维与监控

监控

内置 Prometheus metrics(/metrics)
Grafana Dashboard 模板(/deploy/grafana)
健康检查:/api/health
日志:JSON 格式,对接 ELK / Loki

备份

PostgreSQL:pg_dump 每日全量
Redis:RDB 快照 + AOF
对象存储:S3 跨区复制
恢复演练:每月 1 次

下一步

API 参考团队协作返回快速开始

方式一:Docker Compose 单机版(5 分钟)

适合个人开发者、小团队、PoC 验证。一台服务器即可运行全部服务。

环境要求

CPU:2 核(推荐 4 核)
内存:4 GB RAM(推荐 8 GB)
磁盘:20 GB SSD(推荐 50 GB)
系统:Linux / macOS / Windows WSL2
软件:Docker 24+ / Docker Compose v2+
GPU:不需要(默认走云端 API,本地模型可接 Ollama)

部署步骤

# 1. 克隆仓库
git clone https://github.com/ihui-ai/ihui-ai.git
cd ihui-ai

# 2. 配置环境变量
cp .env.example .env
# 编辑 .env,必填项:
# - DATABASE_URL=postgresql://ihui:ihui@postgres:5432/ihui
# - REDIS_URL=redis://redis:6379
# - JWT_SECRET=<随机 32 字符串>
# - OPENAI_API_KEY=sk-...(可选,不填则用统一积分)

# 3. 一键启动
docker compose up -d

# 4. 查看日志
docker compose logs -f web api ai-service

# 5. 访问
open http://localhost:8801
# 管理员:admin(口令由部署环境注入,首次登录后立即改密)

服务端口

8801 — Web 前端(Next.js 16)
3001 — API 后端(Fastify 5)
8000 — AI Service(FastAPI)
5432 — PostgreSQL 18
6379 — Redis 7

方式二:Kubernetes Helm Chart(高可用)

适合企业生产环境,支持水平扩展、滚动升级、自动备份、监控告警。

集群要求

Kubernetes 1.28+
至少 3 节点(控制面 + 2 工作节点)
每节点 4 核 / 8 GB RAM
StorageClass(默认提供 local-path,生产建议用云盘)
Ingress Controller(Nginx / Traefik / ALB)
cert-manager(自动 HTTPS)

Helm 部署

# 1. 添加 Helm 仓库
helm repo add ihui https://charts.ihui.ai
helm repo update

# 2. 创建命名空间
kubectl create namespace ihui

# 3. 配置 values.yaml
cat > values.yaml <<EOF
image:
  registry: registry.cn-shenzhen.aliyuncs.com
  repository: ihui/ihui-ai
  tag: latest

ingress:
  enabled: true
  hostname: ihui.example.com
  tls: true

postgres:
  enabled: true
  persistence:
    size: 50Gi

redis:
  enabled: true
  persistence:
    size: 10Gi

# 生产环境必填
secrets:
  jwtSecret: "<随机 32 字符串>"
  openaiApiKey: "sk-..."

# 水平扩展
web:
  replicas: 2
api:
  replicas: 3
aiService:
  replicas: 2
EOF

# 4. 安装
helm install ihui ihui/ihui-ai \
  -n ihui \
  -f values.yaml

# 5. 查看
kubectl get pods -n ihui
kubectl get ingress -n ihui

开发文档

开发文档

自托管部署智汇 AI

方式一:Docker Compose 单机版(5 分钟)

环境要求

部署步骤

方式二:Kubernetes Helm Chart(高可用)

集群要求

Helm 部署

核心配置项

运维与监控

监控

备份

下一步

自托管部署智汇 AI

方式一:Docker Compose 单机版(5 分钟)

环境要求

部署步骤

方式二:Kubernetes Helm Chart(高可用)

集群要求

Helm 部署

核心配置项

运维与监控

监控

备份

下一步