# 10-AI知识库系统部署运维手册_V1.0.docx

10

## AI知识库系统部署运维手册

Deployment & Operations Guide

━━━━━━━━━━━━━━━━━━━━━━━━━━━━

系统部署｜环境配置｜上线运维｜监控备份｜故障恢复

## 文档目录

## 第一章 文档说明

### 1.1 编写目的

本文档用于指导系统部署、环境配置、上线、运维、监控、备份及故障恢复。

适用对象：

运维工程师

后端开发工程师

DevOps 工程师

项目实施人员

## 第二章 系统部署架构

### 2.1 总体架构

## 第三章 服务器规划

### 3.1 建议配置（生产环境）

### 3.2 环境要求

Linux（Ubuntu LTS 或 CentOS Stream）

Docker（如采用容器化）

MySQL 8.x

Redis 7.x

Nginx 最新稳定版

Git

## 第四章 环境变量配置

建议使用 .env 或配置中心统一管理。

## 第五章 数据库初始化

部署步骤：

1. 创建数据库。

2. 执行建表 SQL。

3. 初始化基础数据。

4. 创建超级管理员。

5. 验证连接。

初始化内容包括：

管理员角色

超级管理员账号

默认 Prompt

默认系统配置

默认模型配置

## 第六章 Redis 使用说明

Redis 用于：

登录验证码缓存

Token 黑名单（如采用）

高频配置缓存（可选）

建议：

开启持久化

设置合理内存上限

定期监控命中率

## 第七章 Nginx 配置建议

建议开启：

HTTPS

HTTP/2（如适用）

Gzip 压缩

SSE 长连接支持

静态资源缓存

反向代理：

## 第八章 AI 服务配置

启动前检查：

AI API Key 正确

飞书配置正确

Prompt 已初始化

默认模型已启用

启动后验证：

AI 可正常调用

飞书可正常检索

SSE 流式输出正常

## 第九章 上线流程

建议流程：

上线验证重点：

登录

AI 聊天

飞书检索

后台管理

权限控制

## 第十章 日志管理

建议分类：

建议：

日志按天滚动

保留周期可配置

重要日志集中采集（如 ELK、Loki 等）

## 第十一章 数据备份

### 11.1 数据库

建议：

每日增量备份

每周完整备份

异地备份（如有条件）

### 11.2 配置文件

备份：

环境变量

Nginx 配置

系统配置

## 第十二章 系统监控

建议监控：

告警建议：

服务不可用

AI 超时率异常

数据库连接异常

Redis 不可用

HTTPS 证书即将过期

## 第十三章 故障处理

### 13.1 飞书不可用

处理：

1. 检查飞书接口状态

2. 检查 App 凭证

3. 查看 AI 请求日志

4. 重试验证

### 13.2 AI 模型不可用

处理：

1. 检查 API Key

2. 检查模型配置

3. 查看请求日志

4. 必要时切换备用模型（如后续版本支持）

### 13.3 数据库异常

处理：

1. 检查数据库状态

2. 查看慢 SQL

3. 检查磁盘空间

4. 恢复备份（必要时）

## 第十四章 回滚方案

发生重大故障时：

1. 停止新版本服务

2. 恢复上一版本程序

3. 恢复数据库（如涉及数据结构变更）

4. 验证核心功能

5. 恢复对外服务

## 第十五章 运维检查清单

### 15.1 每日检查

☑ 服务运行状态

☑ AI 请求成功率

☑ 飞书接口状态

☑ 数据库运行状态

☑ Redis 状态

☑ 日志是否正常

### 15.2 每周检查

☑ 数据备份验证

☑ 磁盘空间检查

☑ SSL 证书检查

☑ 系统安全更新评估

## 《部署运维手册》V1.0 完成

本手册覆盖了：

系统部署架构

环境配置

数据库初始化

Redis 与 Nginx 配置建议

AI 服务部署

上线流程

日志管理

数据备份

系统监控

故障处理

回滚方案

运维巡检清单

## Table 1
| 项目名称 | AI 企业知识库问答系统 |
| --- | --- |
| 文档版本 | V1.0 |
| 适用版本 | V1.0 |

## Table 2
| 01 | 第一章 文档说明 |
| --- | --- |
| 02 | 第二章 系统部署架构 |
| 03 | 第三章 服务器规划 |
| 04 | 第四章 环境变量配置 |
| 05 | 第五章 数据库初始化 |
| 06 | 第六章 Redis 使用说明 |
| 07 | 第七章 Nginx 配置建议 |
| 08 | 第八章 AI 服务配置 |
| 09 | 第九章 上线流程 |
| 10 | 第十章 日志管理 |
| 11 | 第十一章 数据备份 |
| 12 | 第十二章 系统监控 |
| 13 | 第十三章 故障处理 |
| 14 | 第十四章 回滚方案 |
| 15 | 第十五章 运维检查清单 |

## Table 3
| Internet                       │                 HTTPS / 443                       │                  Nginx 反向代理                       │         ┌─────────────┴─────────────┐         │                           │    用户端（H5/Web）           管理后台（Admin）         │                           │         └─────────────┬─────────────┘                       │                  Backend API                       │         ┌─────────────┼─────────────┐         │             │             │      AI Service     Redis        MySQL         │         ▼  飞书知识库 API + AI 模型 API |
| --- |

## Table 4
| 服务 | CPU | 内存 | 磁盘 |
| --- | --- | --- | --- |
| Nginx | 2 核 | 2 GB | 20 GB |
| Backend | 4 核 | 8 GB | 50 GB |
| AI Service | 4 核 | 8 GB | 50 GB |
| MySQL | 8 核 | 16 GB | 200 GB SSD |
| Redis | 2 核 | 4 GB | 20 GB |

## Table 5
| 配置项 | 说明 |
| --- | --- |
| DB_HOST | 数据库地址 |
| DB_PORT | 数据库端口 |
| DB_NAME | 数据库名称 |
| DB_USER | 数据库账号 |
| DB_PASSWORD | 数据库密码 |
| REDIS_HOST | Redis 地址 |
| REDIS_PORT | Redis 端口 |
| JWT_SECRET | JWT 密钥 |
| FEISHU_APP_ID | 飞书应用 ID |
| FEISHU_APP_SECRET | 飞书密钥 |
| AI_API_URL | AI 接口地址 |
| AI_API_KEY | AI 接口密钥 |

## Table 6
| 安全建议：所有密钥均通过环境变量或密钥管理系统保存，不写入源码仓库。 |
| --- |

## Table 7
| 访问路径 | 代理目标 |
| --- | --- |
| /api/* | Backend |
| /admin/* | 管理后台 |
| / | 用户端 |

## Table 8
| 代码发布     │ 数据库升级     │ 配置环境变量     │ 启动 Redis     │ 启动 MySQL     │ 启动 Backend     │ 启动 AI Service     │ 启动 Nginx     │ 功能验证     │ 正式开放访问 |
| --- |

## Table 9
| 日志类型 | 内容 |
| --- | --- |
| 应用日志 | 系统运行日志 |
| AI 日志 | AI 请求与响应 |
| 操作日志 | 后台管理员操作 |
| 登录日志 | 登录记录 |
| 错误日志 | 异常与堆栈信息 |

## Table 10
| 指标 | 建议 |
| --- | --- |
| CPU 使用率 | <80% |
| 内存使用率 | <80% |
| MySQL 连接数 | 持续监控 |
| Redis 内存 | 持续监控 |
| AI 请求耗时 | 持续监控 |
| 飞书接口异常率 | 持续监控 |

## Table 11
| 发布要求：所有发布建议保留可回滚版本。 |
| --- |
