WeKnora 部署实战十分钟跑通你的第一个 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/WeKnoraWeKnora 是一个开源的 AI 知识管理平台。这篇是面向想把它部署在自己服务器上的读者的 WeKnora 部署教程任务只有一个让 RAG先从知识库里检索相关内容再让大模型基于它作答问答在你的机器上真正跑起来。不讲理论铺垫每步都有确认点。它能解决什么问题如果你有一堆文档但不好用WeKnora 把它变成三件能直接用的东西可查询的 RAG 问答上传文档提问系统从知识库定位相关内容后作答附引用出处。知识图谱增强从文档里抽取实体和关系复杂的多跳问题也能答得准。多渠道接入Web 界面、API、MCP Server以及飞书、钉钉、Slack 等 IM 机器人嵌进现有工作流。 部署前确认这台机器开跑前先对照这张表缺什么补什么项目要求内存最低 4 GB推荐 8 GB 以上磁盘至少 20 GB 可用空间CPU4 核以上支持 AVX2 指令集Docker20.10 及以上Docker Compose2.0 及以上系统Ubuntu 20.04、CentOS 8 或 macOS 12从零跑通第一次第一步拿到代码。这是唯一一步联网命令之后全部在本地进行。git clone https://gitcode.com/GitHub_Trending/we/WeKnora cd WeKnora第二步生成配置文件。下面这条命令把模板复制成实际使用的配置模板里自带一套完整默认值不改也能起。cp .env.example .env如果你想用自己的大模型只需编辑.env里 D 段模型相关的变量。第三步一条命令启动所有容器。脚本会先自检环境、拉取镜像、再拉起服务期间留意输出里的[SUCCESS]提示。./scripts/start_all.sh --all第四步确认服务真的起来了。跑下面三条命令分别看环境诊断、容器状态和健康接口都通过才算成功。./scripts/start_all.sh --check docker compose ps curl http://localhost:8080/health到这里浏览器打开http://localhost注册账号上传第一批文档部署就算完成了。⚙️ 初次部署后值得改的 5 个参数都在config/config.yaml或.env里改完重启容器生效全部可回退chunk_size分块大小文档切成多大一块。默认 512长技术文档可以考虑调小。chunk_overlap分块重叠相邻块重叠多少。默认 50保持约 10% 重叠避免答案在块边界断上下文。embedding_top_k检索候选数每次检索拉多少候选。默认 30召回不够时提到 50。max_rounds对话轮数问答时保留几轮上下文。默认 5按业务在 3 到 10 之间调。CONCURRENCY_POOL_SIZE并发池文档解析并行跑多少个任务。默认 5生产环境可上调到 32。分块参数调完可以在文档列表里直接查看切块效果确认粒度符合预期⚠️ 常见的坑和它们的解法现象原因解决前端打不开80/8080 端口被占或容器没起齐docker compose ps看状态腾出端口数据库连接失败PostgreSQL 启动比应用慢等健康检查通过用docker compose logs -f app看启动顺序知识图谱不可用用错了变量名ENABLE_GRAPH_RAG自 v0.1.6 起已废弃改用NEO4J_ENABLEtrue并配NEO4J_URIbolt://neo4j:7687向量检索超时向量库资源不足给向量库容器调大内存限制文件上传失败对象存储凭证没配检查.env中 MinIO 相关变量 上生产之前要处理的三件事安全把.env里的JWT_SECRET、SYSTEM_AES_KEY默认值换成自己生成的随机串开启多租户 RBAC 与审计日志对外只暴露 80/443数据库、Redis 和 MinIO 只允许内网访问有证书就启用 TLS。扩展数据量小于 10 GB 时单节点 PostgreSQL 加单套向量库够用规模上去后转 PostgreSQL 主从加向量库集群Redis 给 2 到 4 GB 内存用 LRU 淘汰策略超时设 300 秒。监控打开 Langfuse 并按 10% 采样LANGFUSE_ENABLEDtrue、LANGFUSE_SAMPLE_RATE0.1观察延迟与错误率日常用docker stats盯容器资源再看 PostgreSQL 慢查询日志定位检索瓶颈。收尾接下来去哪部署只是开始往知识库传文档、提问、调分块才是日常。想回炉时一条命令停止./scripts/start_all.sh --stop。深入配置按这三份文档走docs/QA.md常见问答与停库、清库操作docs/KnowledgeGraph.md知识图谱Neo4j开启方法docs/Langfuse集成.md监控接入细节docs/RBAC说明.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），仅供参考 WeKnora 部署实战：十分钟跑通你的第一个 RAG 知识库
WeKnora 部署实战十分钟跑通你的第一个 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/WeKnoraWeKnora 是一个开源的 AI 知识管理平台。这篇是面向想把它部署在自己服务器上的读者的 WeKnora 部署教程任务只有一个让 RAG先从知识库里检索相关内容再让大模型基于它作答问答在你的机器上真正跑起来。不讲理论铺垫每步都有确认点。它能解决什么问题如果你有一堆文档但不好用WeKnora 把它变成三件能直接用的东西可查询的 RAG 问答上传文档提问系统从知识库定位相关内容后作答附引用出处。知识图谱增强从文档里抽取实体和关系复杂的多跳问题也能答得准。多渠道接入Web 界面、API、MCP Server以及飞书、钉钉、Slack 等 IM 机器人嵌进现有工作流。 部署前确认这台机器开跑前先对照这张表缺什么补什么项目要求内存最低 4 GB推荐 8 GB 以上磁盘至少 20 GB 可用空间CPU4 核以上支持 AVX2 指令集Docker20.10 及以上Docker Compose2.0 及以上系统Ubuntu 20.04、CentOS 8 或 macOS 12从零跑通第一次第一步拿到代码。这是唯一一步联网命令之后全部在本地进行。git clone https://gitcode.com/GitHub_Trending/we/WeKnora cd WeKnora第二步生成配置文件。下面这条命令把模板复制成实际使用的配置模板里自带一套完整默认值不改也能起。cp .env.example .env如果你想用自己的大模型只需编辑.env里 D 段模型相关的变量。第三步一条命令启动所有容器。脚本会先自检环境、拉取镜像、再拉起服务期间留意输出里的[SUCCESS]提示。./scripts/start_all.sh --all第四步确认服务真的起来了。跑下面三条命令分别看环境诊断、容器状态和健康接口都通过才算成功。./scripts/start_all.sh --check docker compose ps curl http://localhost:8080/health到这里浏览器打开http://localhost注册账号上传第一批文档部署就算完成了。⚙️ 初次部署后值得改的 5 个参数都在config/config.yaml或.env里改完重启容器生效全部可回退chunk_size分块大小文档切成多大一块。默认 512长技术文档可以考虑调小。chunk_overlap分块重叠相邻块重叠多少。默认 50保持约 10% 重叠避免答案在块边界断上下文。embedding_top_k检索候选数每次检索拉多少候选。默认 30召回不够时提到 50。max_rounds对话轮数问答时保留几轮上下文。默认 5按业务在 3 到 10 之间调。CONCURRENCY_POOL_SIZE并发池文档解析并行跑多少个任务。默认 5生产环境可上调到 32。分块参数调完可以在文档列表里直接查看切块效果确认粒度符合预期⚠️ 常见的坑和它们的解法现象原因解决前端打不开80/8080 端口被占或容器没起齐docker compose ps看状态腾出端口数据库连接失败PostgreSQL 启动比应用慢等健康检查通过用docker compose logs -f app看启动顺序知识图谱不可用用错了变量名ENABLE_GRAPH_RAG自 v0.1.6 起已废弃改用NEO4J_ENABLEtrue并配NEO4J_URIbolt://neo4j:7687向量检索超时向量库资源不足给向量库容器调大内存限制文件上传失败对象存储凭证没配检查.env中 MinIO 相关变量 上生产之前要处理的三件事安全把.env里的JWT_SECRET、SYSTEM_AES_KEY默认值换成自己生成的随机串开启多租户 RBAC 与审计日志对外只暴露 80/443数据库、Redis 和 MinIO 只允许内网访问有证书就启用 TLS。扩展数据量小于 10 GB 时单节点 PostgreSQL 加单套向量库够用规模上去后转 PostgreSQL 主从加向量库集群Redis 给 2 到 4 GB 内存用 LRU 淘汰策略超时设 300 秒。监控打开 Langfuse 并按 10% 采样LANGFUSE_ENABLEDtrue、LANGFUSE_SAMPLE_RATE0.1观察延迟与错误率日常用docker stats盯容器资源再看 PostgreSQL 慢查询日志定位检索瓶颈。收尾接下来去哪部署只是开始往知识库传文档、提问、调分块才是日常。想回炉时一条命令停止./scripts/start_all.sh --stop。深入配置按这三份文档走docs/QA.md常见问答与停库、清库操作docs/KnowledgeGraph.md知识图谱Neo4j开启方法docs/Langfuse集成.md监控接入细节docs/RBAC说明.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），仅供参考