从零开始部署Knowledge Table：面向新手的完整安装教程

【免费下载链接】knowledge-tableKnowledge Table is an open-source package designed to simplify extracting and exploring structured data from unstructured documents.项目地址: https://gitcode.com/gh_mirrors/kn/knowledge-table

Knowledge Table是一款开源工具，专为简化从非结构化文档中提取和探索结构化数据而设计。本教程将带您通过简单步骤完成部署，即使是新手也能轻松上手。

📋 准备工作：部署前的必备条件

在开始部署前，请确保您的系统已安装以下工具：

• Git（用于克隆代码仓库）
• Docker 和 Docker Compose（用于容器化部署）

如果您使用的是Ubuntu系统，可以通过以下命令快速安装依赖：

sudo apt update && sudo apt install git docker.io docker-compose -y sudo systemctl enable docker && sudo systemctl start docker

🔄 第一步：获取项目代码

1. 打开终端，执行以下命令克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/kn/knowledge-table cd knowledge-table

2. 查看项目结构确认克隆成功，核心部署文件包括：
   • 主配置文件：docker-compose.yml
   • 后端服务配置：backend/docker-compose.yml

⚙️ 第二步：配置环境变量

1. 进入后端目录并创建环境变量文件：

cd backend cp .env.example .env # 如果没有.example文件，直接创建.env

2. 使用文本编辑器打开.env文件，设置必要参数：

# 基础配置 ENVIRONMENT=dev TESTING=0 # API服务端口（保持默认即可） PORT=8000 # 数据库配置（如使用外部数据库需修改） DATABASE_URL=sqlite:///./knowledge_table.db

🚀 第三步：一键启动服务

1. 返回项目根目录，执行Docker Compose命令启动所有服务：

cd .. # 回到knowledge-table目录 docker-compose up -d --build

2. 等待部署完成（首次部署可能需要5-10分钟下载依赖），可以通过以下命令检查服务状态：

docker-compose ps

正常运行时会显示两个服务：

• frontend（前端界面，端口3000）
• backend（API服务，端口8000）

✅ 第四步：验证部署是否成功

1. 打开浏览器访问前端界面：http://localhost:3000
2. 访问API健康检查接口验证后端状态：http://localhost:8000/health
   • 成功响应应为：{"status":"healthy","timestamp":"2026-08-14T07:47:54Z"}

🔧 常见问题解决

服务启动失败怎么办？

1. 查看日志定位问题：

docker-compose logs -f backend # 查看后端日志 docker-compose logs -f frontend # 查看前端日志

2. 检查端口是否被占用：

netstat -tulpn | grep 8000 # 检查后端端口 netstat -tulpn | grep 3000 # 检查前端端口

如何更新到最新版本？

git pull origin main docker-compose down docker-compose up -d --build

📚 进阶操作：目录结构解析

项目核心目录说明，帮助您更好地了解系统架构：

• 前端代码：frontend/src/

  • 组件目录：frontend/src/components/
  • 配置文件：frontend/src/config/

• 后端代码：backend/src/app/

  • API接口：backend/src/app/api/v1/endpoints/
  • 核心服务：backend/src/app/services/
    • 文档处理：backend/src/app/services/document_service.py
    • 向量数据库：backend/src/app/services/vector_db/

通过以上步骤，您已经成功部署了Knowledge Table！接下来可以开始探索从非结构化文档中提取结构化数据的强大功能了。如有其他问题，欢迎查阅项目的CONTRIBUTING.md获取更多帮助。

【免费下载链接】knowledge-tableKnowledge Table is an open-source package designed to simplify extracting and exploring structured data from unstructured documents.项目地址: https://gitcode.com/gh_mirrors/kn/knowledge-table