在 Olares 上安装和使用 Dify 共享版

[shentuteng]

以下教程讲带您了解

1. 为 Olares 系统中多个账户安装 Dify 共享版的方法
2. 从 Dify（0.15.3）版本升级到 Dify 共享版（1.1.0）的步骤
3. 从本地安装 Dify 插件的方法

Dify 共享版 安装

新上线的 ”Dify 共享版“ 移植了Dify 1.1.0 版本。Dify 共享版 支持一个 Olares 集群上的所有用户共用一套 Dify 知识库和Agent，为 Olares 系统中多个子账户安装 Dify 共享版 的步骤如下：

注意
该版本与之前的 0.15.3 版本不兼容，因此需要手动导出知识库、应用 DSL，卸载原 Dify For Cluster 和 Dify 后才能安装 Dify 共享版。不兼容的原因是

1. Dify 1.0.0版本后，引入了插件系统替换了原来的模型提供商组件和节点里的工具。这导致原有的模型供应商配置和工作流需要安装新版下的插件才能正常使用
2. Dify 共享版 使用了Olares 数据库中间件，并优化了多人共享的实现逻辑，因此原数据库无法直接迁移。

1. 管理员安装。

   • 请确认您的 Olares 系统已升级至1.11.6版本以上。可参考升级指南：更新 Olares | Olares
   • 打开应用商店，找到 Dify 共享版，点击安装，等待应用安装完。（如果已安装老版本的Dify，需要卸载后才能安装，卸载前请注意导出您的 Dify数据）
     
     

     Dify 共享版 首次启动需要比较长的时间，安装完成后需等待10分钟左右才能打开正常进入注册页面。

   • 设置管理账号和密码
     
     

2. 其他用户安装。管理员安装完成后，让每个 Olares 子账户通过应用商店安装 Dify 共享版（如果已安装老版本的Dify，需要卸载后才能安装）

3. 添加成员。

   • 管理员用户登陆后，点击右上角设置 > 成员。点击添加按钮，输入拟邀请成员的邮箱和角色
     
     
     

   成员邮箱处建议输入子账户的olares id，如tester00001@olares.cn。点击发送邀请后，可以看到邀请注册的Token地址。

   

   • 由于我们没有配置邮箱服务，Dify无法发送邀请链接。因此，管理员需要手动发送地址给子账户进行注册。

     发送前，请确保tester00001@olares.cn子账户的用户已经从应用市场安装了 Dify 共享版

   • 复制上述的邀请注册地址，修改/activate?前的URL为子账户的Dify地址，例如https://a45f345b.tester00001.olares.cn/activate?email=tester00001%40olares.cn&token=48c60dd5-5ebc-49e2-84f3-d486ace774c7

   • 将修改后的邀请地址发送给用户，

4. 子账户激活 Dify。 tester00001@olares.cn子账户的用户点击邀请地址后，输入密码后即可激活该账号。
   

   

如何从Dify旧版本（0.15.3）升级到 Dify 共享版（1.1.0）

注意
由于兼容性问题，从Dify 0.15.3 版本升级到 Dify 共享版后

1. 您需要重新创建所有账号，原账号体系的信息无法保留
2. 您需要重新配置所有模型的API-Key、Dify系统设置，原配置无法保留
3. 您可以找回知识库中的所有文档，但会失去所有已处理的知识库Chunk，您需要在新版本中重新构建知识库
4. 您可以导出工作室中创建的App，但会失去所有的日志和对话历史记录，您需要在新版本中导入原App，部分工具插件可能需要重新配置

如果您在 Olares 1.11.5 及以前的版本已经安装和使用Dify了，请你按照以下顺序进行Dify的升级

1. 导出应用

   如果您当前有多个子账户共同使用Dify，请确保每个用户都已将自己的Dify数据导出后再卸载

   打开工作室，点击应用卡片右下角的扩展按钮，选择 导出DSL。浏览器会自动下载一个.yml文件（如长篇故事生成.yml），这个文件记录了改应用的全部配置。分别导出每个应用的DSL。
   

   

2. 下载知识库中的文档。
   如果你已经备份了知识库中所有文档的原始文件，可略过此步骤。
   如果你使用的外部知识库，或者你的知识库数据源全部来自Notion或者web站点，也可以略过此步骤。
   

   
   
   如果你在本地已经无法找到知识库中某些文档的原始文件，您可以打开 文件管理器 > 缓存 > 你的设备名称 > difyfusion > volumes > app > storage > upload_files，这里有所有上传到知识库的文档的原始文件。点击右键可下载原始文件。
   
   
   

   此处保存的文件名称已修改为Dify系统内部名称，您需要根据文档上传时间、格式等信息手工查找

3. 手动记录必要模型配置和系统设置

4. 卸载Dify
   在应用商店 > 我的 Olares 中卸载Dify 和 Dify For Cluster
   

   

5. 安装新版Dify
   参照上文教程安装 Dify 共享版

6. 导入应用

   • 打开 工作室，选择导入DSL文件。选择第1步导出的yml文件上传
     

     

   • Dify会自动检测导入的应用中使用的插件，如果缺失，会提示安装。勾选所有需要安装的插件，点击安装即可。即使这一步选择关闭，或者安装失败，您的应用配置仍然会被导入，只是没有安装成功的插件节点需要重新配置。
     

     

     由于目前国内访问Dify的Marketplace很不稳定，您很有可能遇到以下错误。此时您需要从本地安装插件

     

   • 如果您的应用配置了知识库，您需要重建完知识库后，重新设置。

7. 重建知识库

   • 您需要新建知识库，并重新上传文档或配置链接来重建知识库。

从本地安装 Dify 插件

注意
Dify 1.0.0 之后的版本在运行时依赖插件，但在容器中访问官方 https://marketplace.dify.ai/ 的插件资源非常不稳定，特别是在国内环境下。因此建议大家先手动下载所需的插件安装包，使用本地安装的方式安装必须的插件。

1. 下载插件安装包到本地

   • 使用代理或其他方式访问 https://marketplace.dify.ai/ ，找到所需的安装包。
   • 点击右上角下载按钮，下载一个.difypkg结尾的压缩文件。
     
     

2. 从本地安装插件

   • 点击插件页面，点击右上角安装插件，在下拉菜单中选择 本地插件。上传 .difypkg 文件完成后，点击安装
     

     
     

   • 安装完成后就可以像之前一样在设置页面配置模型API-Key等，或者在工作流中调用相应的Tools了