WeKnora 0.8.0 升级实战RAG 知识库从旧版本平滑升级的完整避坑指南【免费下载链接】WeKnoraOpen-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.项目地址: https://gitcode.com/GitHub_Trending/we/WeKnora上周有朋友把 WeKnora 升到 0.8.0容器一起Agent 的技能执行全报错——旧版 Local 沙箱被移除Docker 沙箱又默认关闭双双属于破坏性变更。如果你现在跑在 0.7.x 或更早版本这篇带你把 RAG 知识库的升级做一遍备份、数据库迁移、沙箱配置切换不踩坑。0.8.0 值不值得升30 秒算清收益类别内容新增技能沙箱运行时Docker / E2B / Cube 三后端、跨会话长期记忆、进程内 Office 解析、文档自动打标、LiteLLM / Exa / Metaso 等新接入变更破坏性Local 宿主进程沙箱后端被移除Docker 沙箱默认关闭修复OIDC ID token 签名校验、分块合并丢内容、注册密码被清洗损坏等判断标准很简单你在用 Agent 技能功能就必须升且要同步改沙箱配置否则技能全挂只用 RAG 问答和文档管理则是一次稳定升级数据无损。升级前自检 5 步备份 PostgreSQL唯一不能跳过的步骤确认文件存储卷位置compose 默认把/data/files挂到data-files卷查一下是否用了旧版 Local 沙箱配置系统设置 → 沙箱确认.env里SYSTEM_AES_KEY还在丢失则已加密的 API Key 无法解密先读一遍 CHANGELOG.md 的 Breaking Changes 小节下面这条命令负责落盘一份数据库备份并记下卷的位置出问题时全靠它回滚pg_dump -U postgres -h localhost -p 5432 WeKnora backup_$(date %F).sql docker volume ls | grep weknora_data-files成功长这样得到一个非空.sql文件卷名出现在输出里。跟着命令走停服、迁移、重启 按真实执行顺序拆步不按模块罗列。第 1 步停应用但别停数据库在做什么把写入流量隔离数据库保活随时可以回滚。docker compose stop app docreader frontend成功长这样三个容器变 Exitpostgres 仍然 Up。第 2 步把版本更新到位镜像用户拉新镜像源码构建用户更新代码仓库还没 clone 过的话先git clone https://gitcode.com/GitHub_Trending/we/WeKnora。docker compose pull # 源码构建用户改跑git pull origin main成功长这样docker images里出现新的 weknora-app 0.8.0 镜像。第 3 步执行数据库迁移镜像部署不用手动做docker-compose.yml 里AUTO_MIGRATE默认 true启动时会自动跑完 000080–000090 共 11 个迁移文件沙箱配置、长期记忆、技能目录等。源码部署需手动执行先确认连接环境变量正确再跑 scripts/migrate.shexport DB_HOSTlocalhost DB_PORT5432 DB_USERpostgres export DB_PASSWORDpostgres DB_NAMEWeKnora ./scripts/migrate.sh up成功长这样脚本打印Migration command completed successfully./scripts/migrate.sh version显示 90。第 4 步切换沙箱配置用技能才需要在做什么旧 Local 配置在新版失效要重建为 Docker / E2B / Cube 之一想用本机 daemon 就打开 Docker 后端并挂载 socket等同宿主机 root仅私有化单机。echo WEKNORA_SANDBOX_DOCKER_ENABLEDtrue .env再到 docker-compose.yml 里把docker.sock挂载行取消注释。成功长这样.env里出现该变量挂载行已打开。第 5 步拉起服务执行恢复流程应用容器健康检查会探测/health通过才算真正就绪docker compose up -d成功长这样容器全部 Runningapp 约一分钟内转 healthy。升完快速验证4 个信号这条命令一次确认服务状态和接口存活docker compose ps curl -sf http://localhost:8080/health看到 ps 全绿、/health返回 OK说明服务起来了登录管理端看到「系统设置」里的沙箱配置和技能目录入口说明新迁移落库了./scripts/migrate.sh version显示 90说明数据库到最新版往知识库传一份文档、问答能引用到它说明 RAG 链路通了踩坑速查3 个高频故障⚠️坑 1技能执行全部报「沙箱未配置」类错误原因0.8.0 移除了 Local 后端Docker 后端默认关闭。 解决echo WEKNORA_SANDBOX_DOCKER_ENABLEDtrue .env后docker compose up -d重启应用。坑 2升级后模型 API Key 全变空原因.env丢了SYSTEM_AES_KEY加密字段无法解密。 解决找回原来那把 32 字节主密钥写回.env再重启别换新的。坑 3up 完版本还是旧的原因docker compose up默认复用本地旧镜像不会自动拉新。 解决先docker compose pull再up -d两步都不能省。把新版用爽两个最有感知的新功能技能沙箱让 Agent 在会话里跑 shell、写文件打开 Docker 后端环境变量或「系统设置 → 网络安全」二选一建一个沙箱配置镜像、CPU/内存、TTL网络策略建议默认拒绝 白名单把配置绑到工作区从技能目录装一个技能会话里直接shell_exec知识库自动打标解析完顺手把标签打上先在知识库里建好一组标签打开知识库设置里的自动打标解析后模型只从既有标签里挑不新建、不覆盖手动标签到文档列表看标签是否挂上批量操作同样支持下一步文档与社区沙箱协议细节看 docs/sandbox-docker-backend.md各功能完整指南在官方文档站 website-docs/遇到本文没覆盖的问题直接去项目 Issue 区提问。【免费下载链接】WeKnoraOpen-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.项目地址: https://gitcode.com/GitHub_Trending/we/WeKnora创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
WeKnora 0.8.0 升级实战：RAG 知识库从旧版本平滑升级的完整避坑指南
WeKnora 0.8.0 升级实战RAG 知识库从旧版本平滑升级的完整避坑指南【免费下载链接】WeKnoraOpen-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.项目地址: https://gitcode.com/GitHub_Trending/we/WeKnora上周有朋友把 WeKnora 升到 0.8.0容器一起Agent 的技能执行全报错——旧版 Local 沙箱被移除Docker 沙箱又默认关闭双双属于破坏性变更。如果你现在跑在 0.7.x 或更早版本这篇带你把 RAG 知识库的升级做一遍备份、数据库迁移、沙箱配置切换不踩坑。0.8.0 值不值得升30 秒算清收益类别内容新增技能沙箱运行时Docker / E2B / Cube 三后端、跨会话长期记忆、进程内 Office 解析、文档自动打标、LiteLLM / Exa / Metaso 等新接入变更破坏性Local 宿主进程沙箱后端被移除Docker 沙箱默认关闭修复OIDC ID token 签名校验、分块合并丢内容、注册密码被清洗损坏等判断标准很简单你在用 Agent 技能功能就必须升且要同步改沙箱配置否则技能全挂只用 RAG 问答和文档管理则是一次稳定升级数据无损。升级前自检 5 步备份 PostgreSQL唯一不能跳过的步骤确认文件存储卷位置compose 默认把/data/files挂到data-files卷查一下是否用了旧版 Local 沙箱配置系统设置 → 沙箱确认.env里SYSTEM_AES_KEY还在丢失则已加密的 API Key 无法解密先读一遍 CHANGELOG.md 的 Breaking Changes 小节下面这条命令负责落盘一份数据库备份并记下卷的位置出问题时全靠它回滚pg_dump -U postgres -h localhost -p 5432 WeKnora backup_$(date %F).sql docker volume ls | grep weknora_data-files成功长这样得到一个非空.sql文件卷名出现在输出里。跟着命令走停服、迁移、重启 按真实执行顺序拆步不按模块罗列。第 1 步停应用但别停数据库在做什么把写入流量隔离数据库保活随时可以回滚。docker compose stop app docreader frontend成功长这样三个容器变 Exitpostgres 仍然 Up。第 2 步把版本更新到位镜像用户拉新镜像源码构建用户更新代码仓库还没 clone 过的话先git clone https://gitcode.com/GitHub_Trending/we/WeKnora。docker compose pull # 源码构建用户改跑git pull origin main成功长这样docker images里出现新的 weknora-app 0.8.0 镜像。第 3 步执行数据库迁移镜像部署不用手动做docker-compose.yml 里AUTO_MIGRATE默认 true启动时会自动跑完 000080–000090 共 11 个迁移文件沙箱配置、长期记忆、技能目录等。源码部署需手动执行先确认连接环境变量正确再跑 scripts/migrate.shexport DB_HOSTlocalhost DB_PORT5432 DB_USERpostgres export DB_PASSWORDpostgres DB_NAMEWeKnora ./scripts/migrate.sh up成功长这样脚本打印Migration command completed successfully./scripts/migrate.sh version显示 90。第 4 步切换沙箱配置用技能才需要在做什么旧 Local 配置在新版失效要重建为 Docker / E2B / Cube 之一想用本机 daemon 就打开 Docker 后端并挂载 socket等同宿主机 root仅私有化单机。echo WEKNORA_SANDBOX_DOCKER_ENABLEDtrue .env再到 docker-compose.yml 里把docker.sock挂载行取消注释。成功长这样.env里出现该变量挂载行已打开。第 5 步拉起服务执行恢复流程应用容器健康检查会探测/health通过才算真正就绪docker compose up -d成功长这样容器全部 Runningapp 约一分钟内转 healthy。升完快速验证4 个信号这条命令一次确认服务状态和接口存活docker compose ps curl -sf http://localhost:8080/health看到 ps 全绿、/health返回 OK说明服务起来了登录管理端看到「系统设置」里的沙箱配置和技能目录入口说明新迁移落库了./scripts/migrate.sh version显示 90说明数据库到最新版往知识库传一份文档、问答能引用到它说明 RAG 链路通了踩坑速查3 个高频故障⚠️坑 1技能执行全部报「沙箱未配置」类错误原因0.8.0 移除了 Local 后端Docker 后端默认关闭。 解决echo WEKNORA_SANDBOX_DOCKER_ENABLEDtrue .env后docker compose up -d重启应用。坑 2升级后模型 API Key 全变空原因.env丢了SYSTEM_AES_KEY加密字段无法解密。 解决找回原来那把 32 字节主密钥写回.env再重启别换新的。坑 3up 完版本还是旧的原因docker compose up默认复用本地旧镜像不会自动拉新。 解决先docker compose pull再up -d两步都不能省。把新版用爽两个最有感知的新功能技能沙箱让 Agent 在会话里跑 shell、写文件打开 Docker 后端环境变量或「系统设置 → 网络安全」二选一建一个沙箱配置镜像、CPU/内存、TTL网络策略建议默认拒绝 白名单把配置绑到工作区从技能目录装一个技能会话里直接shell_exec知识库自动打标解析完顺手把标签打上先在知识库里建好一组标签打开知识库设置里的自动打标解析后模型只从既有标签里挑不新建、不覆盖手动标签到文档列表看标签是否挂上批量操作同样支持下一步文档与社区沙箱协议细节看 docs/sandbox-docker-backend.md各功能完整指南在官方文档站 website-docs/遇到本文没覆盖的问题直接去项目 Issue 区提问。【免费下载链接】WeKnoraOpen-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.项目地址: https://gitcode.com/GitHub_Trending/we/WeKnora创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
