WeKnora

环境要求

• 已安装 Docker 与 Docker Compose（支持 compose 子命令）
• 能访问网络以拉取镜像
• 本机 80 端口可用（访问地址为 http://localhost）
• 可选：本地 Ollama 环境（使用本地模型时）

安装与启动步骤

1. 1克隆项目仓库

   从 GitHub 拉取 WeKnora 源码到本地，随后所有操作都在该目录内进行。

   git clone https://github.com/Tencent/WeKnora.git

   复制

2. 2进入项目目录

   切换到刚克隆下来的 WeKnora 目录，后续命令均在此目录执行。

   cd WeKnora

   复制

3. 3生成配置文件

   从示例文件复制出 .env，并按文件内注释修改所需配置项。

   cp .env.example .env

   复制

4. 4拉取最新镜像

   使用 Docker Compose 拉取核心服务镜像，确保使用最新版本。

   docker compose pull

   复制

5. 5后台启动服务

   以守护进程方式启动核心服务，完成后即可访问 Web 界面。

   docker compose up -d

   复制

6. 6访问 Web 界面

   在浏览器打开 http://localhost 进入知识平台开始使用。

7. 7启用扩展组件(可选)

   需要知识图谱、对象存储或链路追踪时，追加 --profile 参数，多个 profile 可组合使用。

   docker compose --profile full pull && docker compose --profile full up -d

   复制

8. 8使用本地 Ollama(可选)

   如需接入本地 Ollama 模型，先启动 Ollama 服务再启动 WeKnora。

   ollama serve > /dev/null 2>&1 &

   复制

关键配置

如何确认成功

浏览器访问 http://localhost 能正常打开 WeKnora 界面，即表示核心服务启动成功。

常见问题

注意事项

• 除 .env 外，README 未列出其他必填配置项，请以 .env 文件内的注释为准。
• 默认访问地址为 http://localhost，即容器默认占用 80 端口。
• 扩展功能按需启用 profile：full 为全部功能，neo4j 为知识图谱，minio 为对象存储，langfuse 为链路追踪。