WeKnora一键部署教程：Linux环境下Docker快速安装指南

1.

引言

你是不是也遇到过这样的情况：公司内部文档堆积如山，想要快速找到某个技术方案或者产品说明，却要在成百上千个文件中翻来覆去地搜索？或者作为研究人员，需要从大量论文中提取关键信息，却苦于没有高效的检索工具？

今天我要介绍的WeKnora，正是为了解决这些问题而生的。

它是一个基于大语言模型的智能知识库系统，能够理解文档内容，实现精准的语义检索和智能问答。

最棒的是，它支持完全本地化部署，确保你的数据安全可控。

本教程将手把手教你在Linux服务器上使用Docker快速部署WeKnora。

无论你是使用Ubuntu还是CentOS，跟着步骤走，30分钟内就能搭建起属于自己的智能知识库系统。

2.

环境准备

在开始部署之前，我们需要确保系统环境满足基本要求。

WeKnora的部署相对简单，但一些前置条件的准备很重要。

2.1

系统要求

首先确认你的Linux系统版本。

WeKnora支持主流的Linux发行版：

#
查看系统版本
-r

硬件方面，建议配置：

• CPU：4核以上（支持AVX指令集）
• 内存：8GB以上（16GB更佳）
• 磁盘：至少20GB可用空间

2.2

Docker安装与配置

如果你的系统还没有安装Docker，可以按照以下步骤安装：

#
sudo
https://download.docker.com/linux/ubuntu/gpg
sudo
/usr/share/keyrings/docker-archive-keyring.gpg
设置稳定版仓库
signed-by=/usr/share/keyrings/docker-archive-keyring.gpg]
https://download.docker.com/linux/ubuntu
$(lsb_release
/etc/apt/sources.list.d/docker.list
>
hello-world

对于CentOS系统，安装步骤类似：

#
卸载旧版本
https://download.docker.com/linux/centos/docker-ce.repo
安装Docker
Compose安装
WeKnora使用Docker
Compose进行多容器管理，需要单独安装：
#
Compose
"https://github.com/docker/compose/releases/download/v2.24.0/docker-compose-$(uname
-s)-$(uname
端口检查
确保以下端口没有被其他服务占用：
8080：前端Web界面
8081：后端API服务
5432：PostgreSQL数据库
6379：Redis缓存
可以使用以下命令检查端口占用情况：
#
检查端口占用
:5432
如果发现端口冲突，可以在后续配置中修改端口映射。
3.
快速部署WeKnora
环境准备就绪后，我们就可以开始部署WeKnora了。
整个过程分为几个简单的步骤。
3.1
获取项目代码
首先从GitHub克隆WeKnora项目：
#
创建部署目录
克隆项目（如果网络较慢，可以使用镜像源）
git
https://github.com/Tencent/WeKnora.git
WeKnora
如果GitHub访问较慢，也可以下载ZIP包并解压：
wget
https://github.com/Tencent/WeKnora/archive/refs/heads/main.zip
unzip
配置环境变量
WeKnora使用环境变量文件进行配置，我们先复制示例文件：
#
复制环境变量模板
.env
现在编辑.env文件，配置必要的参数：
#
使用nano或vim编辑配置文件
.env
主要需要关注的配置项包括：
#
数据库配置
POSTGRES_PASSWORD=your_secure_password
服务端口配置（如果默认端口被占用，可以修改这些值）
大模型配置（初期可以先使用默认值，后续再调整）
INIT_LLM_MODEL_NAME=qwen2.5-7b-instruct
对于初学者，建议先使用默认配置，确保系统能够正常启动。
后续可以根据实际需求调整模型配置和其他参数。
3.3
启动服务
配置完成后，使用提供的脚本一键启动所有服务：
#
chmod
./scripts/start_all.sh
这个过程可能会花费一些时间，因为需要下载多个Docker镜像并启动相关容器。
首次启动时，Docker会下载基础镜像，具体时间取决于网络速度。
启动完成后，可以使用以下命令检查服务状态：
#
查看容器运行状态
weknora-app
如果一切正常，你应该看到所有容器都处于运行状态。
4.
常见问题与解决方案
在部署过程中，可能会遇到一些常见问题。
这里我总结了一些典型问题及其解决方法。
4.1
端口冲突问题
如果发现端口被占用，可以修改.env文件中的端口配置：
#
BACKEND_PORT=8083
修改后需要重新启动服务：
./scripts/start_all.sh
--stop
./scripts/start_all.sh
4.2
数据库初始化失败
有时候数据库表没有正确创建，可以手动初始化：
#
进入数据库容器
/docker-entrypoint-initdb.d/00-init-db.sql
4.3
内存不足问题
如果系统内存较小，可能会遇到容器启动失败的情况。
可以尝试调整Docker资源限制：
#
编辑Docker配置
}
重启Docker服务使配置生效：
sudo
systemctl
磁盘空间不足
如果磁盘空间不足，可以清理不必要的Docker资源：
#
docker
验证部署效果
服务启动后，我们需要验证WeKnora是否正常工作。
5.1
访问Web界面
打开浏览器，访问你的服务器IP和配置的端口（默认是8080）：
http://你的服务器IP:8080
如果一切正常，你应该能看到WeKnora的登录界面。
首次使用需要注册账号，点击"立即注册"并填写相关信息。
5.2
创建知识库
登录成功后，按照以下步骤创建你的第一个知识库：
点击右上角的"新建知识库"
输入知识库名称和描述
配置相关模型设置（初期可以使用默认配置）
上传测试文档（支持PDF、Word、TXT等格式）
5.3
测试问答功能
上传文档后，系统会自动处理并建立索引。
处理完成后，你可以尝试提问：
在问答界面输入相关问题
观察系统是否能从上传的文档中提取正确答案
测试多轮对话功能
6.
总结
通过本教程，你应该已经成功在Linux服务器上部署了WeKnora知识库系统。
整个过程虽然涉及多个步骤，但按照指南操作，基本上不会遇到太大问题。
WeKnora的强大之处在于它能够理解文档的语义内容，而不仅仅是关键词匹配。
这意味着你可以用自然语言提问，系统会从上传的文档中找到最相关的信息并生成准确的回答。
在实际使用中，你可能会发现一些需要优化的地方，比如调整模型参数、配置更合适的检索策略等。
这些都可以在系统运行稳定后逐步进行。
记得定期备份重要的知识库数据，特别是当你上传了大量有价值文档后。
备份可以通过导出知识库内容或者直接备份数据库来实现。
希望这个教程能帮助你快速搭建起自己的智能知识库系统。
如果在使用过程中遇到其他问题，可以查阅WeKnora的官方文档或者社区讨论。
/>
获取更多AI镜像
想探索更多AI镜像和应用场景？访问
CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。