> **让文档活起来：RAG、Agent 推理与自动 Wiki 一体化的知识框架** WeKnora 是腾讯开源的 LLM 驱动知识框架，支持多种数据源、文档格式和主流大语言模型，具备企业级文档理解、语义检索和自主推理能力。 ## 架构说明 本移植版内置以下服务： | 服务 | 镜像 | 说明 | |------|------|------| | frontend | `wechatopenai/weknora-ui:v0.5.2` | 前端界面（NGINX 反向代理） | | weknoraapp | `wechatopenai/weknora-app:v0.5.2` | 后端 API 服务 | | docreader | `wechatopenai/weknora-docreader:v0.5.2` | 文档解析服务（gRPC） | | postgres | `paradedb/paradedb:v0.23.4-pg17` | PostgreSQL 17 + pgvector 向量检索 | | redis | `redis:7-alpine` | 缓存与消息队列 | ## 自动登录 本移植版通过三阶段 inject 脚本实现了**免密自动登录**： 1. **request 阶段** — 用户首次注册时，自动抓取邮箱和密码 2. **response 阶段** — 注册成功后，将凭据持久化存储 3. **browser 阶段** — 后续访问登录页时，自动填充已保存的邮箱和密码 > 首次使用需在登录页注册账号，之后再次访问即可自动登录。 ## 部署参数说明 ### 基础参数 | 参数 | 类型 | 必填 | 默认值 | 说明 | |------|------|------|--------|------| | `ENABLE_GRAPH_RAG` | bool | 否 | `false` | 是否启用 GraphRAG（知识图谱）功能 | | `MAX_FILE_SIZE_MB` | int | 否 | `50` | 上传文件最大大小（MB） | | `SSRF_WHITELIST` | string | 否 | `*.heiyu.space` | SSRF 白名单，逗号分隔（如 `*.example.com, 10.0.0.0/8`） | ### GraphRAG 参数（启用 GraphRAG 时需配置） | 参数 | 类型 | 必填 | 默认值 | 说明 | |------|------|------|--------|------| | `NEO4J_URI` | string | 否 | — | Neo4J 连接地址（如 `bolt://host:7687`） | | `NEO4J_USERNAME` | string | 否 | — | Neo4J 用户名 | | `NEO4J_PASSWORD` | secret | 否 | — | Neo4J 密码 | ### Langfuse 可观测性参数（启用时需配置） | 参数 | 类型 | 必填 | 默认值 | 说明 | |------|------|------|--------|------| | `LANGFUSE_ENABLED` | bool | 否 | `false` | 是否启用 Langfuse 追踪 | | `LANGFUSE_HOST` | string | 否 | — | Langfuse 服务地址（如 `https://langfuse.example.com`） | | `LANGFUSE_PUBLIC_KEY` | string | 否 | — | Langfuse 公钥 | | `LANGFUSE_SECRET_KEY` | secret | 否 | — | Langfuse 密钥 | ### 链路追踪参数 | 参数 | 类型 | 必填 | 默认值 | 说明 | |------|------|------|--------|------| | `OTEL_EXPORTER_OTLP_ENDPOINT` | string | 否 | — | Jaeger OTLP 端点（如 `jaeger:4317`） | > **注意**：WeKnora 的 OpenTelemetry 链路追踪目前仅支持 gRPC 协议导出。如果配置了 `OTEL_EXPORTER_OTLP_ENDPOINT` 但在 Jaeger 中看不到数据，请确认端点使用的是 gRPC（默认 4317 端口），而非 HTTP（4318 端口）。Langfuse 追踪独立于 OTEL，启用 `LANGFUSE_ENABLED=true` 即可工作。 ## SSRF 白名单说明 WeKnora 内置 SSRF 防护，会阻止对内网 IP 的请求。如果 LLM 服务部署在内网（如 `*.example.com` 解析到私有 IP），需将其域名加入 `SSRF_WHITELIST`： - 支持格式：精确域名（`example.com`）、通配符（`*.example.com`）、IP/CIDR（`10.0.0.0/8`） - 多个规则用逗号分隔 - 默认值 `*.heiyu.space` 已包含懒猫微服常用域名 ## 数据持久化 以下目录会持久化存储： | 路径 | 说明 | |------|------| | `/lzcapp/var/postgres/data` | PostgreSQL 数据 | | `/lzcapp/var/redis/data` | Redis 数据 | | `/lzcapp/var/files` | 上传文件 | | `/lzcapp/var/docreader-tmp` | 文档解析临时文件 | ## 注意事项 1. **首次启动**：后端服务会等待 PostgreSQL 和 Redis 就绪后再启动，首次初始化数据库可能需要较长时间。 2. **GraphRAG**：启用 GraphRAG 前请确保 Neo4J 服务已正确部署并可访问，并填写 `NEO4J_URI`、`NEO4J_USERNAME`、`NEO4J_PASSWORD`。 3. **Langfuse**：启用 Langfuse 前请确保 Langfuse 服务已正确部署并可访问，并填写 `LANGFUSE_HOST`、`LANGFUSE_PUBLIC_KEY`、`LANGFUSE_SECRET_KEY`。 4. **SSRF 白名单**：内网部署的 LLM 服务域名需加入 `SSRF_WHITELIST`，否则请求会被 SSRF 防护拦截。 ## 参考链接 - 项目主页：https://github.com/Tencent/WeKnora - 常见问题：https://github.com/Tencent/WeKnora/blob/main/docs/QA.md - 许可证：MIT License