MaxKB源码部署与DeepSeek应用(ubuntu22.04)

费老劲了，值得一看！

姊妹篇：MaxKB源码部署与调试(Windows)-CSDN博客

MaxKB介绍与Docker模式部署(含社区版与专业版)-CSDN博客

目录

一、环境部署

1、安装Python

2、安装postgres14

3、安装pgvector

4、安装nodejs

二、源码准备与配置 

1、源码下载并解压

2、下载模型

3、修改配置文件

三、前台启动 

1、安装依赖

2、打包文件

3、启动前台项目

 四、后台启动

1、依赖下载

2、修改源码 

3、设置poetry

4、迁移完善代码

5、启动项目

五、系统访问

六、结合DeepSeek使用

1、安装ollama

2、安装deepseek

3、配置deepseek

4、创建应用并测试​编辑 

一、环境部署

1、安装Python

安装Python 3.11版本

参考：Python多版本管理工具——pyenv安装及使用-CSDN博客 Ubuntu环境部署

2、安装postgres14

参考：Linux系统部署Postgres数据库(ubuntu22.04)_ubuntu22.04 安装数据库管理工具-CSDN博客 

3、安装pgvector

参考：Postgres14数据库Vector拓展模块部署(Ubuntu22.04)-CSDN博客

# 创建数据库
CREATE DATABASE "maxkb"; 
# 切换使用数据库
\c "maxkb"; 
# 创建vector 扩展
CREATE EXTENSION "vector";

4、安装nodejs

参考：Linux部署NodeJS_linux部署nodejs项目-CSDN博客 

Node.js — Download Node.js®

建议用Docker部署

# Docker has specific installation instructions for each operating system.
# Please refer to the official documentation at https://docker.com/get-started/

# Pull the Node.js Docker image:
docker pull node:20-alpine

# Create a Node.js container and start a Shell session:
docker run -it --rm --entrypoint sh node:20-alpine

# Verify the Node.js version:
node -v # Should print "v20.19.2".

# Verify npm version:
npm -v # Should print "10.8.2".

二、源码准备与配置 

1、源码下载并解压

从官网https://github.com/1Panel-dev/MaxKB下载源码，上传到到/opt/文件夹中，进行解压

cd /opt/
unzip MaxKB.zip

注意/opt/maxkb/中 maxkb全部小写，方便后续与代码中配置路径一致

2、下载模型

cd /opt/maxkb/
mkdir model
cd model
git clone https://www.modelscope.cn/thomas/text2vec-base-chinese.git

3、修改配置文件

复制/opt/maxkb/maxkB/config_example.yml为/opt/maxkb/config.yml

cd /opt/maxkB/
mkdir conf
cp config_example.yml conf/config.yml

 修改conf/config.yml内容为

# 数据库链接信息
DB_NAME: maxkb
DB_HOST: localhost
DB_PORT: 5432
DB_USER: postgres1
DB_PASSWORD: postgres1
DB_ENGINE: django.db.backends.postgresql_psycopg2

DEBUG: false

TIME_ZONE: Asia/Shanghai

# 模型相关配置
# 模型路径:如果EMBEDDING_MODEL_NAME是绝对路径则无效,反之则会从https://huggingface.co/下载模型到当前目录
EMBEDDING_MODEL_PATH: /opt/maxkb/model
# 模型名称:如果模型名称是路径,则会加载目录下的模型,如果是模型名称,则会在https://huggingface.co/下载模型 模型的下载位置为EMBEDDING_MODEL_PATH
EMBEDDING_MODEL_NAME: /opt/maxkb/model/text2vec-base-chinese

三、前台启动 

务必先前台启动，并且build,因为后台使用前台的dist文件内容

1、安装依赖

cmd打开，并定位到/opt/maxkb/ui/文件夹，执行一下命令

cd /opt/maxkb/ui/

npm install --registry=https://registry.npmmirror.com

2、打包文件

非常重要，要不然后续跑代码会出问题

npm run build

3、启动前台项目

npm run dev

 四、后台启动

后端系统，需要启动 web服务、本地模型服务、和异步任务队列服务。

1、依赖下载

在项目根目录（/opt/maxkb/）执行，cmd打开执行如下命令切换目录

cd /opt/maxkb/

 maxkb项目根目录下依次执行以下命令，启动 Web 服务。

# 安装 poetry 包管理器
pip install poetry

# 配置 poetry 的源
poetry source add --priority=primary mirrors http://mirrors.aliyun.com/pypi/simple

# 安装后端需要的依赖
poetry install

下面是不使用poetry需要的包，不全，仅作参考，没啥用，也不要执行，在此仅记录遇到的坑，python自身与poetry包管理不一样，通过如下可以查看

pip list
poetry show

安装其他依赖（可不安装）

pip install django
pip install Pillow
pip install pyyaml
pip install djangorestframework
pip install drf-yasg
pip install django-filter
pip install django_apscheduler
pip install django_celery_beat
pip install psycopg2
pip install langchain
pip install pycryptodome
pip install jieba
pip install diskcache
pip install pydub
pip install python-daemon
pip install langchain_mcp_adapters
pip install langgraph
pip install psutil
pip install langchain_community
pip install langchain_openai
pip install dashscope
pip install langchain_anthropic
pip install botocore
pip install langchain_google_genai 
pip install langchain_huggingface
pip install scikit-learn
pip install langchain_ollama
pip install tencentcloud
pip install tencentcloud-sdk-python
pip install websockets
pip install docutils
pip install xinference_client
pip install zhipuai
pip install gunicorn

2、修改源码 

修改源码内容

/opt/maxkb/apps/dataset/models/data_set.py代码修改为

class Type(models.TextChoices):
    base = '0', '通用类型'

    web = '1', 'web站点类型'

    lark = '2', '飞书类型'

/opt/maxkb/apps/application/models/application.py代码改为

class VoteChoices(models.TextChoices):
    """订单类型"""
    UN_VOTE = '-1', '未投票'
    STAR = '0', '赞同'
    TRAMPLE = '1', '反对'

/opt/maxkb/apps/embedding/models/embedding.py代码改为 

class SourceType(models.TextChoices):
    """订单类型"""
    PROBLEM = '0', '问题'
    PARAGRAPH = '1', '段落'
    TITLE = '2', '标题'

3、设置poetry

cd /opt/maxkb/
poetry env activate

如果上面不行，加上下面的（做的时候遇到了坑）

poetry env use python
poetry shell

4、迁移完善代码

此步骤仅做参考吧，在这一刻一直卡了，各种尝试了，但不知道最终起作用了没(下次有机会再试看此步骤是否可以不要)

cd /opt/maxkb/apps

pip install poetry
poetry install

poetry env activate

poetry run  python manage.py makemigrations dataset
poetry run python manage.py migrate dataset

这一块折腾的心碎 ！！！

5、启动项目

cd  /opt/maxkb/
poetry run python main.py start

五、系统访问

浏览器输入：http://localhost:3000/ui/

用户名：admin 默认密码：MaxKB@123..

六、结合DeepSeek使用

1、安装ollama

ollama安装：Ubuntu22.04部署Ollama_ubuntu22.04安装卸载ollama-CSDN博客

也可通过1Panel安装

2、安装deepseek

查看已安装大模型

http://192.168.1.76:11434/api/tags

3、配置deepseek

打开MaxKB进行如下配置

4、创建应用并测试