部署md

2025-11-26 16:03:06 +08:00
parent ba53dc9c20
commit 04eb85e1dc
46 changed files with 186 additions and 23 deletions
--- a/doc/部署.md
+++ b/doc/部署.md
@@ -0,0 +1,163 @@
+# 校园新闻系统部署
+
+## 加载镜像
+
+### 镜像目录结构
+
+---docker 根目录
+ |---dify # dify的docker目录
+   |---dify 官方内容
+ |---schoolNews # schoolNews的docker目录
+   |---dify     # dify工作流的2个yml
+   |---config   # 前后端配置文件
+   |---init-db  # 数据库标记
+   |---mysql    # mysql配置
+   |---redis    # redis配置
+   |---nginx    # nginx配置
+   |---volumes  # 数据卷
+   |---images   # 镜像
+   |---docker-compose.yml # docker-compose配置
+   |---init-volumes.sh # 初始化数据卷
+
+
+### 后端服务镜像
+镜像来源由星洋智慧提供
+
+#### 镜像加载
+```bash
+# 递归查找指定目录下的所有镜像文件并加载
+find .docker/schoolNews/images -type f \( -name "*.tar" -o -name "*.tar.gz" -o -name "*.tgz" \) -exec docker load -i {} \;
+```
+
+#### 服务启动
+```bash
+cd docker/schoolNews
+docker-compose up -d
+```
+
+#### 服务停止
+```bash
+cd docker/schoolNews
+docker-compose down
+```
+
+#### 服务重启
+```bash
+cd docker/schoolNews
+docker-compose restart
+```
+
+### dify镜像启动
+> 会进行镜像拉取
+```bash
+cd docker/dify
+docker-compose up -d
+```
+
+## 配置dify工作流
+> dify登录url  本地ip:8000
+
+### 1. 注册账号
+
+![alt text](部署.assets/image.png)
+
+### 2. 导入工作流
+工作流的yaml文件在dify目录下
+![alt text](部署.assets/image-1.png)
+安装工作流所需插件。
+
+插件说明：
+1. 安思派：工作流联网搜索插件
+2. 硅基流动： LLM插件。应该替换成本地部署的模型内容
+
+![alt text](部署.assets/image-2.png)
+
+APIKEY授权
+![alt text](部署.assets/image-3.png)
+
+### 3. 创建一个测试知识库开启apikey
+> APIKEY作用：
+给后端服务提供访问dify知识库内容的key权限
+
+![alt text](部署.assets/image-4.png)
+
+![alt text](部署.assets/image-5.png)
+
+![alt text](部署.assets/image-6.png)
+
+保存好知识库的apikey，通常以dataset开头。所有知识库共用。
+
+### 4.修改动态知识库检索工作流
+
+![alt text](部署.assets/image-7.png)
+
+修改点有2个：
+1. 修改http节点post请求的url内容。替换成实际的 ip:8000
+2. 修改Authorization的值，替换为  Bearer + 空格 + 知识库的apikey
+![alt text](部署.assets/image-8.png)
+
+#### 测试
+如图即正常
+![alt text](部署.assets/image-9.png)
+![alt text](部署.assets/image-10.png)
+
+#### 发布
+要同时发布为工具，供工作流使用
+![alt text](部署.assets/image-11.png)
+
+### 5. 修改思政小帮手工作流
+#### 删除“动态知识库检索”节点，重新添加
+![alt text](部署.assets/image-12.png)
+![alt text](部署.assets/image-13.png)
+
+#### 修改节点输入、输出相关节点的引用
+修改的输入参数有2个，第1个是对话变量的datasets。表示该词对话中，使用了那些知识库。
+第2个是对话变量的query。表示用户输入的对话内容。
+![alt text](部署.assets/image-14.png)
+
+![alt text](部署.assets/image-15.png)
+
+![alt text](部署.assets/image-16.png)
+
+#### 修改知识库处理节点的引用
+直接引用“动态知识库检索”的输出内容，text即可
+![alt text](部署.assets/image-17.png)
+
+#### 测试发布
+正常对话即正确
+![alt text](部署.assets/image-18.png)
+
+#### 获取工作流apikey
+> 该apikey用于前端进行对话，指定使用该工作流
+![alt text](部署.assets/image-19.png)
+
+### 6. 配置后端dify配置
+```sql
+-- 更新dify.apiBaseUrl
+UPDATE `school_news`.`tb_sys_config` SET `config_value` = '实际ip:8000' WHERE `config_key` = 'dify.apiBaseUrl';
+
+-- 更新dify.apiKey
+UPDATE `school_news`.`tb_sys_config` SET `config_value` = '工作流的apikey' WHERE `config_key` = 'dify.apiKey';
+
+-- 更新dify.dify.knowledgeApiKey
+UPDATE `school_news`.`tb_sys_config` SET `config_value` = '知识库的apikey' WHERE `config_key` = 'dify.dify.knowledgeApiKey';
+
+-- 更新智能体配置的api_key。该api_key的编辑权限前端未开放
+UPDATE `school_news`.`tb_ai_agent_config` SET `dify_api_key`='工作流的apikey' WHERE `id` = 'agent_default_001';
+
+
+```
+
+### 7. 重启后端服务
+即可进行对话
+![alt text](部署.assets/image-20.png)
+
+## 系统配置
+### 消息模块配置
+#### 短信
+申请阿里云的短信服务，配置到后端
+![alt text](部署.assets/image-21.png)
+
+#### 邮箱
+开启邮箱服务
+![alt text](部署.assets/image-22.png)