ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

WeKnora Docker快速拉起:5分钟RAG知识库

WeKnora Docker快速拉起:5分钟RAG知识库 WeKnora Docker快速拉起5分钟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 把原始文档变成可检索的 RAG、能自主推理的 Agent 和自维护的 Wiki。跟着本文复制命令你大约 5 分钟就能拿到一个可访问的 WeKnora 服务并学会按需改配置。跑起来之前确认三件事项目要求镜像Docker Docker Compose v2docker compose version能跑通内存建议 8GB 可用最低 4GB磁盘20GB 起ParadeDB 和解析镜像都不小网络需拉取 5 个基础镜像离线场景见后文模型服务Ollama 或远程 LLM不阻塞启动默认OLLAMA_OPTIONALtrue没配好只会告警服务照常起来你之后在界面里填模型配置即可。三步拉通全链路克隆仓库并进入目录git clone https://gitcode.com/GitHub_Trending/we/WeKnora cd WeKnora生成 .env 配置模板里已带可运行的默认值DB_DRIVERpostgres、STORAGE_TYPElocal想换端口或密码再改cp .env.example .env拉镜像并启动核心服务docker compose pull docker compose up -d核心链路就绪后访问 http://localhost前端API 在 http://localhost:8080。验证健康检查curl -f http://localhost:8080/health嫌分步麻烦的话启动脚本 一条命令搞定它会顺带检查/安装 Ollama、自动补建.env./scripts/start_all.sh启动脚本的-c环境体检、-s停止、-l列出容器三个参数排障时都会用到。组件一览谁在干什么默认 profile 只起核心服务其余组件按需通过--profile叠加。服务镜像端口一句话职责frontendwechatopenai/weknora-ui80Web 界面Nginx 反向代理到 appappwechatopenai/weknora-app8080主应用RAG、Agent、APIpostgresparadedb/paradedb:v0.22.2-pg17容器内 5432业务库 默认向量库ParadeDBredisredis:7.0-alpine容器内 6379流处理与任务队列Asynq缓存挂了重建即可恢复docreaderwechatopenai/weknora-docreader仅内网 50051gRPC 文档解析不映射到宿主机minio--profile miniominio/minio9000/9001对象存储STORAGE_TYPEminio时启用neo4j--profile neo4jneo4j:2025.10.17474/7687知识图谱NEO4J_ENABLEtrue时启用langfuse--profile langfuselangfuse/langfuse:33000可观测性自带全套 ClickHouse/MinIO按场景改配置仓库是只读参考所有改动都走.env、覆盖文件或 profile不碰源码。我要热重载调试只起基础设施app 和 frontend 放宿主机本地跑改代码不用重建镜像docker compose -f docker-compose.dev.yml up -d该 开发 compose 文件 只暴露 postgres/redis 等依赖容器名带-dev后缀与正式部署互不冲突。我要在无外网的机器上跑联网机器上先拉全再打包docker compose pull docker save wechatopenai/weknora-app:latest wechatopenai/weknora-ui:latest wechatopenai/weknora-docreader:latest -o weknora-images.tar离线机器加载后跳过拉取docker load -i weknora-images.tar ./scripts/start_all.sh --no-pull我要上生产并限制资源写一个覆盖文件my-override.yml不改主 compose 文件services: app: deploy: resources: limits: cpus: 2 memory: 4Gdocker compose -f docker-compose.yml -f my-override.yml up -d.env里再补两行SYSTEM_AES_KEYopenssl rand -hex 16 生成API Key 等敏感字段落盘加密的主密钥丢了不可恢复、DISABLE_REGISTRATIONtrue关闭自助注册。我要知识图谱或独立向量库docker compose --profile neo4j up -d # 再在 .env 设 NEO4J_ENABLEtrue docker compose --profile qdrant up -d # 配 RETRIEVE_DRIVERqdrant 后同样启动 app排障速查前端 80 端口被占→ 端口冲突 →FRONTEND_PORT8081写入.env后docker compose up -dapp 容器反复重启→ 依赖健康检查未通过 →docker compose ps看 postgres/docreader 是否healthy再看docker compose logs -f appOllama 报连接失败→ 模型服务未启动或地址不对 → 把.env的OLLAMA_BASE_URL指向可用端点http://host.docker.internal:11434是容器访问宿主机的写法界面里图片/附件加载不出→ 存储后端不可达 → local 存储确认 app 容器/data/files卷minio 场景设APP_EXTERNAL_URL为公网可达地址docker compose up报 .env 变量缺失→ 模板未生成 →cp .env.example .env补齐必填项DB_DRIVER、STORAGE_TYPE不确定哪一环出问题→ 环境未知 →./scripts/start_all.sh -c一次性输出 Docker、Ollama、磁盘、内存、容器状态可观测与备份各留一条命令链路追踪直接docker compose --profile langfuse up -d访问 http://localhost:3000.env补上LANGFUSE_PUBLIC_KEY/LANGFUSE_SECRET_KEY重启 app 即接入。数据库备份一行docker compose exec postgres pg_dump -U postgres -d WeKnora weknora-backup.sql用户名库名以你的.env为准。下一步服务起来后打开 http://localhost注册账号、进初始化向导配好模型就能上传第一批文档。更多细节看 README_CN.md、config/config.yamlapp 容器内挂载为/app/config/config.yaml改切分策略、检索阈值都在此文件以及docs/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),仅供参考
返回列表