企业官网建设流程全解析

3种AIri容器化部署方案实战：从Docker到Kubernetes企业级指南

【免费下载链接】airi💖🧸 Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-sama's altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.项目地址: https://gitcode.com/GitHub_Trending/ai/airi

AIri是一个基于大型语言模型的开源虚拟AI角色项目，旨在创建能够与用户实时语音对话、玩游戏、聊天的数字伴侣。作为自托管、用户所有的Grok伴侣，AIri支持Web、macOS、Windows多平台部署，具备强大的实时语音聊天和游戏交互能力。本文将为您提供从Docker单机部署到Kubernetes生产环境的完整部署指南，涵盖容器化部署策略、环境准备、实战操作和运维监控全流程。

核心关键词：AIri容器化部署、Docker多阶段构建、Kubernetes编排、生产环境配置长尾关键词：AIri虚拟角色部署方案、Docker容器化最佳实践、Kubernetes生产环境配置、AIri健康检查配置、容器资源优化策略

部署策略选择：三种方案对比

在开始部署AIri之前，您需要根据团队规模、技术栈和运维能力选择合适的部署方案。AIri项目提供了灵活的部署选项，从简单的Docker Compose到复杂的Kubernetes编排，满足不同场景的需求。

方案一：Docker单机部署 ⚙️

适合个人开发者和小型团队快速启动AIri服务。使用Docker Compose编排数据库、Redis缓存和AIri API服务，5分钟内即可完成部署。

方案二：Docker Swarm集群部署 🚀

适合中小型团队需要高可用性的场景。利用Docker Swarm的简单编排能力，实现服务副本和负载均衡，无需复杂的Kubernetes配置。

方案三：Kubernetes生产部署 🔧

适合企业级生产环境，需要自动化扩缩容、服务发现、监控告警等高级功能。AIri的微服务架构天然适合Kubernetes环境。

环境准备与依赖检查

系统要求

• Docker 20.10+ 或 containerd 1.6+
• 内存：至少4GB（推荐8GB+）
• 存储：至少10GB可用空间
• 网络：稳定的互联网连接（用于模型下载）

工具安装

# 安装Docker和Docker Compose curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh sudo systemctl enable --now docker # 验证安装 docker --version docker compose version

项目克隆与准备

# 克隆AIri项目仓库 git clone https://gitcode.com/GitHub_Trending/ai/airi cd airi # 检查项目结构 ls -la apps/

方案一：Docker单机部署实战

工作原理简析

AIri采用多阶段Docker构建策略，前端使用Nginx作为静态资源服务器，后端API服务基于Node.js构建。数据库使用PostgreSQL，缓存使用Redis，形成完整的微服务架构。

实战操作步骤

1. 构建前端Web应用镜像

# 进入前端项目目录 cd apps/stage-web # 查看Dockerfile配置 cat Dockerfile

AIri前端Dockerfile采用两阶段构建：

• 构建阶段：使用Node.js环境编译Vue.js应用
• 生产阶段：使用Nginx Alpine镜像提供静态文件服务

2. 启动完整服务栈

# 返回项目根目录 cd ../.. # 启动Docker Compose服务 docker compose -f apps/server/docker-compose.yml up -d

查看服务状态：

# 检查所有容器运行状态 docker ps # 查看服务日志 docker compose -f apps/server/docker-compose.yml logs -f

3. 验证部署结果

# 测试API服务健康状态 curl http://localhost:6112/livez curl http://localhost:6112/readyz # 测试数据库连接 docker exec -it proj-airi-server-db-1 psql -U postgres -d postgres

环境变量配置

AIri支持通过环境变量进行灵活配置，关键配置项包括：

• VITE_ENABLE_POSTHOG: 分析工具开关
• 数据库连接参数
• Redis连接配置
• API密钥和模型提供商设置

方案二：Docker Swarm集群部署

工作原理简析

Docker Swarm提供简单的容器编排能力，通过服务副本和负载均衡实现高可用性。AIri的微服务架构可以轻松扩展到多节点集群。

实战操作步骤

1. 初始化Swarm集群

# 初始化Swarm集群 docker swarm init # 添加工作节点（在其他服务器执行） docker swarm join --token <token> <manager-ip>:2377

2. 创建Docker Stack配置

创建docker-stack.yml文件：

version: '3.8' services: db: image: ghcr.io/tensorchord/vchord-postgres:pg18-v1.0.0 environment: - POSTGRES_DB=postgres - POSTGRES_USER=postgres - POSTGRES_PASSWORD=${DB_PASSWORD} volumes: - db_data:/var/lib/postgresql deploy: replicas: 1 placement: constraints: - node.role == manager redis: image: redis:7-alpine volumes: - redis_data:/data deploy: replicas: 1 api: build: context: . dockerfile: apps/server/Dockerfile environment: - DATABASE_URL=postgresql://postgres:${DB_PASSWORD}@db:5432/postgres - REDIS_URL=redis://redis:6379 ports: - "6112:3000" deploy: replicas: 3 update_config: parallelism: 1 delay: 10s restart_policy: condition: on-failure volumes: db_data: redis_data:

3. 部署Stack服务

# 设置环境变量 export DB_PASSWORD=your-secure-password # 部署服务栈 docker stack deploy -c docker-stack.yml airi-stack # 查看服务状态 docker service ls docker stack ps airi-stack

方案三：Kubernetes生产部署

工作原理简析

Kubernetes提供完整的容器编排解决方案，包括自动扩缩容、服务发现、配置管理、存储编排等能力。AIri在Kubernetes中可以充分发挥其微服务架构的优势。

实战操作步骤

1. 创建命名空间和配置

# 创建专用命名空间 kubectl create namespace airi-production # 创建ConfigMap存储配置 kubectl create configmap airi-config --from-file=config/ -n airi-production

2. 创建Secret存储敏感信息

# 创建数据库密码Secret kubectl create secret generic airi-secrets \ --from-literal=db-password=your-secure-password \ --from-literal=redis-password=your-redis-password \ -n airi-production

3. 部署PostgreSQL数据库

创建postgresql-deployment.yaml：

apiVersion: apps/v1 kind: Deployment metadata: name: postgresql namespace: airi-production spec: replicas: 1 selector: matchLabels: app: postgresql template: metadata: labels: app: postgresql spec: containers: - name: postgresql image: ghcr.io/tensorchord/vchord-postgres:pg18-v1.0.0 env: - name: POSTGRES_PASSWORD valueFrom: secretKeyRef: name: airi-secrets key: db-password ports: - containerPort: 5432 volumeMounts: - name: postgresql-data mountPath: /var/lib/postgresql/data resources: requests: memory: "512Mi" cpu: "250m" limits: memory: "1Gi" cpu: "500m" livenessProbe: exec: command: - pg_isready - -U - postgres initialDelaySeconds: 30 periodSeconds: 10 readinessProbe: exec: command: - pg_isready - -U - postgres initialDelaySeconds: 5 periodSeconds: 5 volumes: - name: postgresql-data persistentVolumeClaim: claimName: postgresql-pvc

4. 部署AIri API服务

创建airi-api-deployment.yaml：

apiVersion: apps/v1 kind: Deployment metadata: name: airi-api namespace: airi-production spec: replicas: 3 selector: matchLabels: app: airi-api template: metadata: labels: app: airi-api spec: containers: - name: airi-api image: airi-api:latest env: - name: DATABASE_URL value: "postgresql://postgres:$(DB_PASSWORD)@postgresql:5432/postgres" - name: REDIS_URL value: "redis://redis:6379" envFrom: - secretRef: name: airi-secrets ports: - containerPort: 3000 livenessProbe: httpGet: path: /livez port: 3000 initialDelaySeconds: 30 periodSeconds: 10 readinessProbe: httpGet: path: /readyz port: 3000 initialDelaySeconds: 5 periodSeconds: 5 resources: requests: memory: "512Mi" cpu: "250m" limits: memory: "1Gi" cpu: "500m"

5. 创建Service和Ingress

apiVersion: v1 kind: Service metadata: name: airi-service namespace: airi-production spec: selector: app: airi-api ports: - port: 80 targetPort: 3000 type: LoadBalancer --- apiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: airi-ingress namespace: airi-production annotations: nginx.ingress.kubernetes.io/rewrite-target: / spec: rules: - host: airi.yourdomain.com http: paths: - path: / pathType: Prefix backend: service: name: airi-service port: number: 80

运维监控与性能优化

健康检查配置

AIri内置了完整的健康检查端点，确保服务可用性：

• /livez: 存活检查，返回简单JSON状态
• /readyz: 就绪检查，验证数据库和Redis连接

监控告警设置

Prometheus监控配置

apiVersion: monitoring.coreos.com/v1 kind: ServiceMonitor metadata: name: airi-monitor namespace: airi-production labels: release: prometheus spec: selector: matchLabels: app: airi-api endpoints: - port: web interval: 30s path: /metrics

Grafana仪表板配置

创建AIri性能监控仪表板，关键指标包括：

• API请求延迟（P50、P95、P99）
• 数据库连接池使用率
• Redis缓存命中率
• 服务错误率

性能优化建议

1. 资源分配策略

resources: requests: memory: "1Gi" cpu: "500m" limits: memory: "2Gi" cpu: "1000m"

2. 水平自动扩缩容

apiVersion: autoscaling/v2 kind: HorizontalPodAutoscaler metadata: name: airi-hpa namespace: airi-production spec: scaleTargetRef: apiVersion: apps/v1 kind: Deployment name: airi-api minReplicas: 3 maxReplicas: 10 metrics: - type: Resource resource: name: cpu target: type: Utilization averageUtilization: 70 - type: Resource resource: name: memory target: type: Utilization averageUtilization: 80

3. 网络策略优化

apiVersion: networking.k8s.io/v1 kind: NetworkPolicy metadata: name: airi-network-policy namespace: airi-production spec: podSelector: matchLabels: app: airi-api policyTypes: - Ingress - Egress ingress: - from: - podSelector: matchLabels: role: frontend ports: - protocol: TCP port: 3000

常见问题排查

问题1：数据库连接失败

症状: API服务无法启动，日志显示数据库连接超时解决方案：

# 检查数据库服务状态 kubectl get pods -n airi-production -l app=postgresql # 查看数据库日志 kubectl logs -f postgresql-pod-name -n airi-production # 测试网络连通性 kubectl exec -it airi-api-pod -n airi-production -- nc -zv postgresql 5432

问题2：内存不足

症状: Pod频繁重启，OOMKilled错误解决方案：

1. 增加内存限制
2. 优化Node.js内存配置
3. 启用内存监控告警

问题3：服务发现失败

症状: 服务间通信超时解决方案：

# 检查Service DNS解析 kubectl exec -it airi-api-pod -n airi-production -- nslookup postgresql.airi-production.svc.cluster.local # 验证网络策略 kubectl get networkpolicies -n airi-production

下一步学习路径

进阶部署方案

1. GitOps持续部署: 使用ArgoCD或Flux实现声明式部署
2. 服务网格集成: 集成Istio或Linkerd实现高级流量管理
3. 多集群部署: 实现跨区域的高可用部署架构

性能调优方向

1. 数据库优化: PostgreSQL连接池调优和索引优化
2. 缓存策略: Redis集群部署和缓存预热机制
3. CDN加速: 静态资源CDN分发优化

安全加固措施

1. 网络策略: 实施零信任网络策略
2. 密钥管理: 集成外部密钥管理系统
3. 审计日志: 完善操作审计和安全监控

监控告警体系

1. 自定义指标: 实现业务级监控指标
2. 告警规则: 配置智能告警规则和降噪策略
3. 容量规划: 基于历史数据的容量预测和规划

通过本文的三种部署方案，您可以根据实际需求选择最适合的AIri容器化部署策略。无论是个人开发测试还是企业生产环境，AIri的容器化架构都能提供稳定可靠的服务体验。建议从Docker单机部署开始，逐步过渡到Kubernetes生产环境，享受容器化技术带来的部署便利和运维效率提升。

【免费下载链接】airi💖🧸 Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-sama's altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.项目地址: https://gitcode.com/GitHub_Trending/ai/airi