WeKnora升级指南旧版本平滑迁移到0.1.4的完整路线【免费下载链接】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 做文档问答手头版本又停在旧版这次 WeKnora 版本迁移到 0.1.4 值得动手多知识库操作让你按业务线拆分知识集合租户管理把多组织隔离落到系统里同时 0.1.3 引入的认证加固还修掉了 XSS 与 CSP 策略两个安全漏洞。本文带你判断该走哪条升级路线备份、迁移、验证、回滚一步步走通。升级路线怎么选先别急着跑命令确认一下你的源版本。WeKnora 0.1.4 升级是否要绕道取决于你现在的版本你当前的版本到 0.1.4 怎么走说明0.1.3直接升级一条命令的数据库迁移即可0.1.2先升 0.1.3再升 0.1.40.1.3 改了安全架构必须经过0.1.0先升 0.1.3再升 0.1.4同上判断不了版本跑一下迁移脚本自带的版本检查下面第 2 步有命令或直接翻 CHANGELOG.md 对照你仓库里的提交记录。动手前的数据保底⚠️ 认证机制在 0.1.3 起才引入旧库升级后所有请求都要过登录校验。备份没做完之前别动生产环境。升级要碰数据库结构、二进制和前端三样东西任何一样出错都可能让你回不去。所以先用三分钟做备份导数据库快照。一条命令把 PostgreSQL 完整导出成 SQL 文件这是回滚时最值钱的东西pg_dump -U ${DB_USER} -h ${DB_HOST} -p ${DB_PORT} ${DB_NAME} backup_$(date %F).sql拷知识库文件。原始文档都躺在knowledge目录里向量重建慢但文件丢了就没法重建tar czf kb_backup.tar.gz /data/weknora/knowledge存一份配置。config/config.yaml里是你手填的模型、存储和认证参数cp config/config.yaml /root/config.yaml.bak升级失败怎么回滚顺序和备份正好相反先停掉服务把备份 SQL 灌回数据库再把代码切回旧版本重新部署。systemctl stop weknora-server weknora-docreader psql -U ${DB_USER} -d ${DB_NAME} -f backup_$(date %F).sql git checkout 旧版本tag make build只要数据库快照是升级前导出的回滚后数据不会少一行知识库目录如果动过同样从kb_backup.tar.gz解回原位。逐步执行从拉代码到上线整条升级链路是更新代码 → 迁移数据库 → 改配置 → 重建前端。每步之间都有明确的产出中途失败时你知道问题出在哪一段。1. 更新代码。先把服务停在低峰期然后拉到最新版本git clone https://gitcode.com/GitHub_Trending/we/WeKnora cd WeKnora git pull origin main2. 迁移数据库。这是 WeKnora 数据库迁移的核心一步。仓库自带的 scripts/migrate.sh 会按migrations/versioned/里的编号文件顺序执行支持up/down/version等模式。建议先看一眼当前停在哪个版本export DB_HOSTlocalhost DB_PORT5432 export DB_USERpostgres DB_PASSWORDpostgres DB_NAMEWeKnora ./scripts/migrate.sh version ./scripts/migrate.sh up 走中转路线0.1.0/0.1.2 → 0.1.3 → 0.1.4的话每升一版都要各跑一次migrate.sh up两次迁移都成功才算走完。如果你用的是 ParadeDB还有一条 SQL 需要手动执行psql -U ${DB_USER} -d ${DB_NAME} -f migrations/paradedb/01-migrate-to-paradedb.sql3. 改配置。编辑config/config.yaml给 0.1.3 起的新认证机制补上密钥块auth: enabled: true jwt: secret: your-secure-jwt-secret expires_in: 86400⚠️ 从 0.1.0/0.1.2 上来的用户改完配置后必须初始化一个管理员账号否则新认证机制会挡住所有登录请求./bin/weknora admin create --username admin --password ${ADMIN_PASSWORD}0.1.4 才引入的多租户开关按需再加tenant: enable_multi_tenant: true default_tenant: default4. 重建前端。0.1.4 动了设置页和菜单组件旧的前端产物和新 API 不匹配必须重新打包再发布到部署目录cd frontend npm install npm run build cp -r dist/* /var/www/weknora/frontend/升级做没做对别只看进程活着这三件事全过才算升级完成服务状态systemctl status weknora-server和weknora-docreader都显示 active登录可用打开登录页前端入口在 frontend/src/views/auth/Login.vue用新认证机制走一遍完整登录业务闭环新建一个知识库、传一份 PDF、发一次提问确认解析、入库、检索整条链路响应正常。卡住时先查这两条高频故障症状大概率原因处理命令升级后无法登录管理员凭证没初始化或密码忘了./bin/weknora admin reset-password --username admin --new-password ${NEW_PASSWORD}知识库数据不显示旧索引未重建./bin/weknora knowledge reindex --all还是不行仓库根目录的 README.md 和 docs/api/README.md 里有完整的接口与排障说明也可以直接去项目 Issue 区提问。升级红利性能。向量库查询慢的话给chunks表补一个向量索引检索耗时立竿见影CREATE INDEX idx_chunk_embedding ON chunks USING ivfflat (embedding vector_cosine_ops) WITH (lists 100);同时在配置里挂上 Redis 缓存重复问答就不用每次都打到数据库。安全。三件事服务部署在内网、防火墙只放行 80前端和 8080API、每月检查一次新版本。定期拉代码能帮你跟上后续的安全修复这也是 WeKnora 升级最划算的长期收益。新功能。升级完最大的体感是 WeKnora 多知识库左侧导航进 知识库列表按业务线建库聊天界面里随时切换上下文企业侧还可以用租户接口做组织隔离SDK 调用示例在 client/ 目录里照着抄就行。一句话收尾备份到位、按路线走、三条验收都过这次迁移就算稳了。后续版本发布后照着同样的备份—迁移—验证节奏再来一遍即可详细文档见仓库内 README_CN.md。【免费下载链接】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），仅供参考