云原生后端运维【免费下载链接】TerminusOpen-Source Personal Cloud OS for Always-On Agents项目地址https://gitcode.com/gh_mirrors/terminus2/Terminus点击查看免费下载在 Olares 1.12.6 中共享应用从服务端 客户端访问点的 v2 拆分架构切换为单一统一的共享服务端旧版v2Dify 无法原地升级只能通过先导出、再重装、后重建的路径迁移。本文覆盖迁移前的数据导出DSL 应用配置、知识库原始文档、旧应用卸载、新版应用安装、应用与知识库重建以及遗留数据清理的完整流程并解释每一步背后的架构原因与可保留数据的边界。读完本篇你可以在 Olares 上安全地完成 Dify 版本迁移且不丢失应用编排配置。为什么 Dify 不能原地升级Dify 是 Olares 上的共享应用Shared Application用于构建 AI 应用、知识库和智能体。Olares 1.12.6 之前的共享应用被拆分为一个服务端组件和一个客户端侧访问点access point。这种设计存在固有风险服务端与访问点强耦合卸载任意一个访问点都可能让共享服务端不可达从而破坏所有用户的服务。新架构用单一、统一的共享服务端取代了这种 client/server 拆分核心差异如下引自 共享应用文档v2 架构新架构服务端 客户端侧访问点单一统一的共享服务端卸载访问点可能导致服务端不可用服务端生命周期与任何访问点解耦多个访问地址与格式所有用户统一地址格式客户端与服务端分别管理管理员集中管理一个共享服务新架构下每个成员都通过https://app-id.username.platform-domain的统一 HTTPS 地址模式以自己的用户名访问同一个共享应用。对 Dify 这类自带 Web UI 的共享应用来说成员仍从 Launchpad 直接打开即可。由于新旧架构的服务拓扑完全不同v2 Dify 的应用数据目录无法被新版应用直接恢复因此只能走数据级迁移而不是版本级升级。如何确认你装的是旧版 v2 Dify打开 Market 中的应用详情页在Information面板检查Compatibility字段判断方法见 遗留共享应用迁移指南遗留 v2 共享应用通常显示Olares 1.12.3-0, 1.12.6当前新版共享应用显示Olares 1.12.6-0。在 共享应用迁移路径表 中Dify 被归类为Dify、OnlyOffice、SearXNG 或 Xinference一类导出或备份应用特定数据然后在新应用中恢复——即本篇所讲的手动迁移路径而不是 ComfyUI 那样的自动迁移工作流。迁移前须知哪些数据能带走哪些必须重建知识库Knowledge Base的检索依赖向量索引而索引由特定 Dify 版本生成无法跨版本复用新版 Dify 还使用了更高效的检索引擎。由此得出两条硬约束无法直接恢复旧应用数据不能把旧数据目录挂回新版应用无法复用旧的知识库索引已切片的 chunk 和向量检索数据都会作废。因此迁移能保留与必须重建的数据边界如下数据项能否保留迁移方式应用编排配置Workflow/Agent/Chatflow 结构能导出 DSL 文件.yml在新版中导入知识库原始文档能从旧应用存储卷中下载原始文件重新上传知识库已处理切片chunks与向量索引不能重新上传文档、重建索引日志、对话等运行时数据不能—用户账号与权限不能在新应用中重新创建模型 API Key 与系统偏好设置不能手动记录后重新配置插件Plugin部分能导入 DSL 后若缺失则重新安装第一步导出 Dify 数据在卸载旧应用之前完成重要前提如果多个用户共用同一个 Dify 实例请确保每一位用户都在卸载 v2 应用之前导出属于自己名下的应用与数据否则卸载后他人数据无法找回。1. 导出应用配置为 DSL 文件DSL 是 Dify 的应用描述格式完整承载了应用的编排结构打开 Dify进入Studio页面将鼠标悬停在目标应用卡片上点击more_horiz更多图标选择Export DSL.yml文件会自动下载到本地对每个要迁移的应用重复上述操作。2. 下载知识库中的原始文档如果知识库使用外部数据源如 Notion、网站同步或你已单独备份了原始文档可以跳过此步。否则需要从旧应用的存储卷中直接取回原始文件打开文件管理器Files依次进入Cache difyv2 volumes app storage upload_files下载其中的所有文件。提示该文件夹中的文件名是 Dify 生成的内部名称而不是原始文件名。请按上传时间、文件格式和文件大小来识别你需要哪些文件并尽早将它们重命名整理好以便导入时上传。3. 手动记录模型配置与系统设置模型 API Key 和系统偏好设置不会随应用数据迁移。建议截图或文字记录以下内容每个模型提供方Model Provider的 API Key、Base URL 与模型名系统级偏好设置每个应用中配置的模型选择与参数。如果你是通过 Olares Router 接入本地模型的见 Dify 使用教程记录重点是 Router 提供的 Base URL含/v1路径与模型名如default-chat这类配置在新版 Dify 的Settings Model Provider中按相同方式重新填写即可。第二步卸载旧版 Dify 应用打开Market进入My Olares卸载 Dify 应用不要勾选 Also remove all local data——否则上一步中存放在Cache difyv2下的原始文档会一并被删除将无法完成知识库重建。第三步安装新版 Dify 应用打开Market搜索 Dify点击应用卡片打开应用详情页检查Information面板新版本的Compatibility字段应显示Olares 1.12.6-0。如果仍显示Olares 1.12.3-0, 1.12.6说明你选中的是旧版需重新确认点击Get然后Install等待安装完成。第四步导入应用打开新版 Dify创建管理员账号进入Studio页面对每个之前导出的应用在CREATE APP卡片上点击Import DSL file选择该应用对应的.yml文件并上传。处理缺失插件如果 Dify 检测到应用依赖的插件缺失按提示安装。若某个插件被跳过或安装失败应用配置本身仍然会导入但你必须重新配置相关插件节点否则对应节点无法运行。处理知识库依赖如果应用引用了知识库需要先按下一节重建知识库然后回到该应用中重新选择新的知识库。回到Studio页面确认所有导入的应用都已显示。第五步重建知识库并验证检索在新版 Dify 中新建知识库将之前从upload_files下载的原始文档重新上传若使用外部数据源Notion、网站等则重新连接数据源。此过程会按新版 Dify 的引擎重新切片并生成新的向量索引。打开一个使用了知识库的应用实际执行一次查询确认能命中知识库内容——这是验证重建成功的唯一可靠方式。回到Settings Model Provider按第三步记录的配置重新填入模型 API Key 与 Base URL如需多用户协作此时也重新创建用户账号并分配权限。第六步清理遗留数据确认迁移成功、新版应用按预期工作之后可手动删除旧应用的数据目录以释放磁盘空间打开文件管理器Files进入Cache difyv2删除该文件夹。注意执行顺序清理必须放在最后。difyv2文件夹是原始文档的最后备份过早删除将导致知识库重建无源可依。迁移核对清单每位共享用户都已导出自己名下的应用 DSL 文件所有知识库原始文档已从Cache difyv2 volumes app storage upload_files下载模型 API Key、Base URL 与系统设置已记录卸载旧 Dify 时未勾选 Also remove all local data新应用 Compatibility 为Olares 1.12.6-0且安装成功全部应用通过Import DSL file导入缺失插件已安装或节点已重配知识库重建完成至少一次检索查询验证通过用户账号、权限与模型配置已在新应用中重建遗留Cache difyv2文件夹在迁移确认无误后已删除。参考资料共享应用架构说明v2 与新架构的完整对比、统一访问地址规则遗留共享应用迁移总览各应用ComfyUI、Dify、OnlyOffice、SearXNG、Xinference、Ollama的迁移路径选择表Dify 使用教程新版安装 Dify Shared、通过 Router 接入模型、配置知识库的完整流程Dify 使用教程1.12.6 版该版本下的旧版使用方式对照。赞分享云原生后端运维【免费下载链接】TerminusOpen-Source Personal Cloud OS for Always-On Agents项目地址https://gitcode.com/gh_mirrors/terminus2/Terminus点击查看免费下载相关推荐Olares 1.12.6 升级后操作指南共享应用迁移、Engine Base 与 *Arr 配置变更Olares 1.12.6 升级后操作指南共享应用迁移、Engine Base 与 Arr 配置变更 Olares 1.12.62026 年 7 月发布对云原生后端运维Olares 旧版 v2 共享应用迁移指南识别、数据迁移与 Engine Base 切换全攻略Olares 旧版 v2 共享应用迁移指南识别、数据迁移与 Engine Base 切换全攻略 Olares 1.12.6 重构了共享应用架构将原先服务端云原生后端运维Hyperf 2.0 升级指南从 1.1 平滑迁移到新架构的完整实操手册Hyperf 2.0 升级指南从 1.1 平滑迁移到新架构的完整实操手册 Hyperf 2.0 是框架底层逻辑发生重要调整的一个大版本AOP 扫描机制被重构后端Web框架微服务RPC框架异步编程上一篇Triton 程序调试完全指南调试算子、解释器模式与第三方工具实战下一篇PyQt-Fluent-Widgets 主题定制指南ThemeMode 明暗模式与 ThemeColor 主题色的完整实现创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
