MaxKB二次开发
一、版本组件版本系统ubuntu 22.0.4Python3.11.15Node.jsv20.20.2npm10.8.2PostgreSQL17pgvector0.8.4Redis6.0.16二、系统初始化1. 更新系统apt update apt upgrade -y安装基础工具apt install -y \ git \ curl \ wget \ vim \ build-essential \ zlib1g-dev \ libncurses5-dev \ libgdbm-dev \ libnss3-dev \ libssl-dev \ libreadline-dev \ libffi-dev \ libsqlite3-dev \ libbz2-dev \ software-properties-common软件作用常见用途git代码版本管理工具拉取 GitHub/Gitee 项目、提交代码curl网络请求工具调 API、下载脚本、测试服务接口wget文件下载工具下载软件包、模型、安装文件vimLinux 文本编辑器修改配置文件build-essentialC/C 编译环境编译源码、安装 Python 包依赖software-properties-common软件源管理工具添加 PPA 源、管理 apt 仓库三、安装 Python 3.11Ubuntu 22.04 默认 Python 3.10。我是通过deadsnakes PPA 安装1、添加 PPA 并更新源add-apt-repository ppa:deadsnakes/ppa apt update2、安装Python3.11apt install python3.11建议同时安装开发头和虚拟环境支持apt install python3.11-dev python3.11-venv3、验证是否为3.11.xpython3.11 --version四、pip安装uvUbuntu 22.04 默认没有 pip先安装apt update apt install python3-pip -y检查pip3 --version安装 uvpip3 install uv检查uv --version五、安装 PostgreSQL1、添加 PostgreSQL 官方仓库安装依赖apt update apt install -y curl ca-certificates gnupg添加 PostgreSQL GPG Keyinstall -d /usr/share/postgresql-common/pgdg curl -o /usr/share/postgresql-common/pgdg/apt.postgresql.org.asc \ --fail https://www.postgresql.org/media/keys/ACCC4CF8.asc添加 Ubuntu 22.04 jammy 仓库sh -c echo deb [signed-by/usr/share/postgresql-common/pgdg/apt.postgresql.org.asc] \ https://apt.postgresql.org/pub/repos/apt jammy-pgdg main \ /etc/apt/sources.list.d/pgdg.list更新apt update2. 安装PostgreSQL 17apt install -y postgresql-17 postgresql-client-17安装完成检查正常 psql (PostgreSQL) 17.xpsql --version查看systemctl status postgresql设置开机启动systemctl enable postgresql3、安装pgvector 扩展包apt install postgresql-17-pgvector重启服务systemctl restart postgresql4、查看 PostgreSQL 17 集群pg_lsclusters正常应该类似Ver Cluster Port Status Owner 17 main 5432 online postgres5、 创建数据库进入sudo -u postgres psql执行CREATE USER maxkb WITH PASSWORD 你的密码; CREATE DATABASE maxkb OWNER maxkb; ALTER USER maxkb CREATEDB;切换到maxkb数据库\c maxkb给 maxkb 用户授权 public schemaGRANT ALL ON SCHEMA public TO maxkb;修改 schema 所属用户ALTER SCHEMA public OWNER TO maxkb;给 maxkb 数据库全部权限GRANT ALL PRIVILEGES ON DATABASE maxkb TO maxkb;创建 pgvector 扩展CREATE EXTENSION vector;测试psql \ -h 127.0.0.1 \ -p 5432 \ -U maxkb \ -d maxkb六、安装 Redisapt install redis-server -y启动# 启动 Redis 服务 systemctl start redis-server # 设置开机自启 systemctl enable redis-server # 查看服务状态 systemctl status redis-server测试redis-cli ping返回pong七、安装 Node.jsMaxKB 前端需要。下载并运行NodeSouce安装脚本针对node.js 20curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -安装apt install -y nodejs查看node -v npm -v八、运行代码1、拉取MaxKB源码github链接https://github.com/1Panel-dev/MaxKB我是下载了zip包然后再解压安装unzipapt update apt install unzip解压unzip your_file.zip2、运行后端① 配置文件MaxKB v2没有配置文件我是参考v1的mkdir /opt/maxkb/conf cd /opt/maxkb/conf vim config.yml把下面的内容拷到config.yml并改成对应的#数据库配置B_HOST: 127.0.0.1DB_PORT: 5432DB_NAME: maxkbDB_USER: maxkbDB_PASSWORD: 你的密码DB_ENGINE: dj_db_conn_pool.backends.postgresqlDB_MAX_OVERFLOW: 80#redis配置REDIS_HOST: 127.0.0.1REDIS_PORT: 6379REDIS_PASSWORD: #前面安装redis的时候我没有设置密码REDIS_DB: 0REDIS_MAX_CONNECTIONS: 100LOCAL_MODEL_HOST: 127.0.0.1LOCAL_MODEL_PORT: 11434LOCAL_MODEL_PROTOCOL: httpLOCAL_MODEL_HOST_WORKER: 1EMBEDDING_MODEL_NAME: maxkb-embeddingEMBEDDING_MODEL_PATH: /opt/maxkb-app/model/embeddingLANGUAGE_CODE: zh-CNDEBUG: trueTIME_ZONE: Asia/ShanghaiADMIN_PATH: /adminCHAT_PATH: /chatSESSION_TIMEOUT: 28800EMBEDDING_MODEL_NAME: maxkb-embeddingEMBEDDING_MODEL_PATH: /opt/maxkb-app/model/embedding这是我从docker里面拷出来的通过网盘分享的文件max-app.zip链接: https://pan.baidu.com/s/17DHO25pqw0xbR3E25ohCmg?pwd0000 提取码: 0000② 创建虚拟环境进入 MaxKB 根目录例如cd /root/MaxKB-2删除旧环境如果之前 pip 创建过rm -rf .venv使用 uv 创建uv venv --python 3.11③ 安装依赖依赖文件/MaxKB-2/pyproject.toml uv sync安装完成查看uv pip list④ 激活环境source .venv/bin/activate看到(MaxKB-2)运行pythonpython main.py dev查看8080端口是否开启ss -tuln | grep :80803、运行前端进入cd /root/MaxKB-2/ui①安装npm install②启动(对应配置文件/env.env )npm run dev③ 启动对话(对应配置文件/env.chat)npm run chat④ 浏览器访问http://localhost:3001/用户名admin密码MaxKB123..
)
