免费获取学习方案
ARTICLE DETAIL

资讯详情

深耕编程基础知识与建站技术分享的一线实战洞察。

校园网/企业内网部署 WeKnora:多部门文档协作知识库的完整落地手册

校园网/企业内网部署 WeKnora:多部门文档协作知识库的完整落地手册 校园网/企业内网部署 WeKnora多部门文档协作知识库的完整落地手册【免费下载链接】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 是一个开源 LLM 知识平台它把散落的文档变成可检索的向量库把文本转成机器能比对的数字坐标再交给大模型回答——也就是 RAG检索增强生成先查资料再生成答案。整套服务用 Docker 打包不依赖公网校园网/企业内网离线环境可以直接落地本文带你从零把它跑起来。部署前环境自检硬件、Docker 与端口先确认机器够不够用再看容器环境最后放通端口。三样都齐了再动代码。项目门槛说明CPU4 核起教学场景够用内存16GB 起支撑约 20 人同时在线磁盘100GB SSD 起存数据库、向量库与上传的文档规模上限参考8 核 / 32GB / 500GB约 100 人并发操作Docker 环境自检docker --version docker compose version ./scripts/check-env.sh # 项目自带的环境诊断脚本两个输出都正常才算过关如果学校没装 Docker从内网文件服务器取离线安装包安装即可。端口放行找网络管理员开入站端口用途备注80前端页面入口nginx 容器用户浏览器访问的就是它8080后端 API前端默认反向代理到它仅调试直连时需要对外开放PostgreSQL这里用的是带向量检索扩展的 ParadeDB 镜像、Redis、文档解析服务 docreader 之间全部走 compose 内部网络不用对外暴露。部署实操拿到代码、改配置、启动第一步取代码。校园网不通外网时找一台能上网的机器把仓库下载成 tar 包git clone --bare拷进机房再解包能直连内网 git 镜像的话直接git clone https://gitcode.com/GitHub_Trending/we/WeKnora cd WeKnora第二步改配置。需要动的就两处config/config.yaml和根目录的.env。# config/config.yaml server: host: 0.0.0.0 # 监听所有网卡让外网段同事能访问 port: 8080 tenant: enable_cross_tenant_access: false # 默认禁止跨空间访问多部门隔离靠它# .env决定数据库、存储与权限行为 STORAGE_TYPElocal # 内网没有对象存储就用本地盘 LOCAL_STORAGE_BASE_DIR/data/weknora_files # 教学文件落到指定目录 MAX_FILE_SIZE_MB100 # 课件、试卷包普遍偏大默认 50 偏紧 WEKNORA_TENANT_SELF_SERVICE_CREATION_ENABLEDfalse # 空间只能管理员建第三步启动。镜像是离线部署最容易被卡住的一环提前在外部机器docker save成 tar拷进来后docker load -i weknora-*.tar再跳过在线拉取./scripts/start_all.sh --no-pull # 不联网拉镜像全部用本地已有镜像 docker compose psdocker compose ps里 app 容器要等到healthy再访问页面健康检查每 30 秒探测一次/health首次启动给 60 秒缓冲。打开http://服务器IP/会进入初始化向导完成知识库模型配置第一个注册的账号即管理员。面向教学场景部门权限与文档解析部门权限怎么配WeKnora 用空间做多租户隔离每个院系一个空间成员靠邀请链接加入链接默认 7 天过期。.env里三个开关按顺序理解WEKNORA_TENANT_ENABLE_RBACtrue默认开启强制空间角色鉴权管理员/普通成员权限分离WEKNORA_TENANT_SELF_SERVICE_CREATION_ENABLEDfalse关掉普通用户自建空间空间由你统一创建WEKNORA_TENANT_ENABLE_CROSS_TENANT_ACCESSfalse数学系看不到物理实验室的库这是隔离的基本盘。生产环境再建议设DISABLE_REGISTRATIONtrue禁止陌生人自助注册。规则细节见 RBAC说明。教学文档解析与扫描件识别上传默认上限 50MB由.env的MAX_FILE_SIZE_MB控制注意 nginx 侧的client_max_body_size跟随这个值改完要重启 app 和 frontend 两个容器才生效。扫描件没有文本层的 PDF由 docreader 容器负责它把页面渲染成图片再做 OCR默认 200 DPI。扫描质量差时可在.env里调DOCREADER_PDF_RENDER_DPI300提升识别率config/config.yaml的knowledge_base.chunk_size默认 512长教案可提到 1024 减少碎片化切分image_processing.enable_multimodal控制是否用多模态模型理解文档里的图片。分块策略的完整逻辑见 CHUNKING 文档。上线验证与高频卡点三步验收清单场景操作通过标准入库教师A 上传一份教案 PDF状态从 processing 变为已完成文档列表能看到分块检索教师B 搜索拉格朗日中值定理快速命中相关章节段落问答学生提问如何理解泰勒公式基于原文生成带引用出处的回答出了问题查这里现象排查动作处理容器起不来 / 一直 health checkingdocker compose logs app多数是.env缺数据库密码或镜像没 load 全上传报 413 超时看 nginx 容器日志调大MAX_FILE_SIZE_MB后重启 app 与 frontend检索结果为空确认文档状态、知识库是否选对了检索驱动处理失败的文档重新上传即可新账号注册不了.env里DISABLE_REGISTRATION是否为 true改为 false或走邀请链接备份别忘业务数据在postgres-data卷pg_dump定期导出上传文件在data-files卷直接打包目录挂一台有内网访问权限的机器跑 crontab 每周执行一次就稳了。 一句话收尾WeKnora 在内网就是一台会查资料的问答机按这份清单走完多部门文档协作平台当天就能用起来。更多接口细节见 API 文档与初始化向导说明。【免费下载链接】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),仅供参考
返回列表