華為云 Flexus 云服務(wù)器 X 實例之 openEuler 系統(tǒng)下搭建 MaxKB 開源知識庫問答系統(tǒng)

前言

在數(shù)字化轉(zhuǎn)型的大潮中，華為云以其卓越的技術(shù)實力和穩(wěn)定的服務(wù)表現(xiàn)，成為了眾多企業(yè)和開發(fā)者信賴的云服務(wù)提供商。華為云 Flexus 云服務(wù)器 X 實例，憑借其柔性算力和高性價比，特別適合中小企業(yè)及個人開發(fā)者快速構(gòu)建高效、靈活的應(yīng)用環(huán)境。本文將詳細介紹如何利用華為云 Flexus 云服務(wù)器 X 實例搭建基于 openEuler 系統(tǒng)的 MaxKB 開源知識庫問答系統(tǒng)，為企業(yè)內(nèi)部的知識管理和信息檢索注入新的活力。

一、Flexus 云服務(wù)器 X 實例介紹

1.1 Flexus 云服務(wù)器 X 實例簡介

·官網(wǎng)地址：華為云Flexus云服務(wù)器X實例

華為云 Flexus 云服務(wù)器 X 實例是新一代面向中小企業(yè)和開發(fā)者的柔性算力云服務(wù)器。它能夠智能感知業(yè)務(wù)負載的變化，自動調(diào)整資源配置。這款服務(wù)器特別適用于中低負載的應(yīng)用場景，例如電商直播、企業(yè)網(wǎng)站建設(shè)、開發(fā)測試環(huán)境、游戲服務(wù)器以及音視頻服務(wù)等。X 實例的設(shè)計理念旨在為用戶提供更加靈活和高效的計算資源管理方式。通過智能調(diào)整，它可以更好地滿足不同業(yè)務(wù)的需求，提高資源利用率。

1.2 Flexus 云服務(wù)器 X 實例特點

·提供豐富的公共鏡像：Flexus 云服務(wù)器 X 實例提供多種公共鏡像供用戶選擇，方便快速部署各種應(yīng)用和服務(wù)。

·可靈活自定義 vCPU 內(nèi)存配比：用戶可以根據(jù)自己的需要靈活調(diào)整虛擬 CPU 和內(nèi)存的配比，以滿足不同場景的需求。

·智能感知業(yè)務(wù)動態(tài)升降配：Flexus 云服務(wù)器 X 實例能夠智能感知業(yè)務(wù)的負載情況，并根據(jù)需要自動升降配，以滿足業(yè)務(wù)的需求，提高系統(tǒng)的穩(wěn)定性和性能。

·負載范圍更高：相對于 Flexus 應(yīng)用服務(wù)器 L 實例，F(xiàn)lexus 云服務(wù)器 X 實例能夠處理更高的負載，適用于更復(fù)雜和繁忙的場景。

1.3 Flexus 云服務(wù)器 X 實例使用場景

Flexus 云服務(wù)器 X 實例針對不同的使用場景展現(xiàn)出其獨特的優(yōu)勢：

1.電商直播：利用 X 實例搭建電商交易平臺，可以有效應(yīng)對電商市場的瞬息萬變，從容處理業(yè)務(wù)壓力波動，確保交易過程順暢無阻。

2.企業(yè)建站：面向博客、論壇和企業(yè)門戶等應(yīng)用場景，X 實例幫助企業(yè)高效傳播價值信息，促進信息共享與交流，支持構(gòu)建多功能傳播和交互平臺。

3.個人開發(fā)測試：開發(fā)者在開發(fā)和測試過程中所需的環(huán)境資源可以通過 X 實例便捷獲取，不僅提高了搭建效率，而且降低了成本。

4.游戲服務(wù)器：適用于搭建游戲后臺服務(wù)器，強大的計算能力可以輕松應(yīng)對大量玩家同時在線的情況，同時支持平滑擴容，快速應(yīng)對玩家數(shù)量增長的需求，以及提供出色的網(wǎng)絡(luò)加速能力以提升用戶體驗。

二、MaxKB 介紹

2.1 MaxKB 簡介

MaxKB 是一個基于大語言模型（LLM）構(gòu)建的開源知識庫問答系統(tǒng)，專為提升企業(yè)內(nèi)部的知識管理和信息檢索效率而設(shè)計。通過集成先進的人工智能技術(shù)，MaxKB 能夠理解自然語言查詢，并從龐大的知識庫中快速準確地提取相關(guān)信息，從而幫助企業(yè)員工更高效地獲取所需的知識和答案。

2.2 MaxKB 整體架構(gòu)

·MaxKB 整體架構(gòu)如下所示：

2.3 MaxKB 主要特點

·智能化搜索：利用深度學習算法解析用戶提問的真實意圖，實現(xiàn)語義層面的匹配，而非簡單的關(guān)鍵詞匹配。

·多源數(shù)據(jù)接入：支持多種格式的數(shù)據(jù)導(dǎo)入，包括文檔、網(wǎng)頁、數(shù)據(jù)庫等，確保企業(yè)內(nèi)外部的各種知識資源能夠被充分利用。

·自定義知識庫：允許根據(jù)企業(yè)的具體需求定制化創(chuàng)建或擴展知識庫內(nèi)容，靈活適應(yīng)不同行業(yè)背景下的特殊要求。

·持續(xù)學習與優(yōu)化：隨著使用頻率增加，系統(tǒng)能夠不斷積累經(jīng)驗并自我改進，提高回答問題的準確性與時效性。

·易于集成：提供 API 接口及插件機制，方便與其他 IT 系統(tǒng)如 CRM、ERP 等進行無縫對接，形成統(tǒng)一的信息服務(wù)平臺。

·安全性保障：重視用戶隱私保護，采用加密傳輸協(xié)議，并且可以設(shè)置訪問權(quán)限控制，確保敏感資料的安全。

2.4 主要使用場景

·客戶服務(wù)：作為在線客服助手，自動響應(yīng)客戶咨詢，減少人工客服的工作負擔，同時保證 24/7 的服務(wù)可用性。

·內(nèi)部培訓(xùn)：為企業(yè)新員工提供自助式學習平臺，涵蓋公司政策、工作流程等多個方面，加速其融入過程。

·技術(shù)支持：針對 IT 部門遇到的技術(shù)難題給出專業(yè)解答，輔助故障排查和技術(shù)文檔查閱。

·產(chǎn)品推廣：向潛在客戶提供詳細的產(chǎn)品介紹和服務(wù)說明，增強銷售轉(zhuǎn)化率。

·決策支持：通過對歷史數(shù)據(jù)分析總結(jié)出有價值的趨勢洞察，幫助管理層做出更加明智的戰(zhàn)略規(guī)劃。

三、本次實踐介紹

3.1 本次實踐簡介

1.本次實踐為個人測試學習環(huán)境，旨在快速部署應(yīng)用，生產(chǎn)環(huán)境請謹慎；2.本次實踐環(huán)境為華為云 Flexus 云服務(wù)器 X 實例，使用的操作系統(tǒng)為| openEuler；3.本次實踐在 Docker 環(huán)境下搭建 MaxKB 開源知識庫問答系統(tǒng)。

3.2 部署要求

部署服務(wù)器要求：

·操作系統(tǒng)：Ubuntu 22.04 / CentOS 7.6 64 位系統(tǒng)

·CPU/內(nèi)存：2C/4GB 以上

·磁盤空間：100GB

3.3 本次環(huán)境規(guī)劃

四、購買華為云 Flexus 云服務(wù)器 X 實例

4.1 登錄華為云

進入華為云官網(wǎng)：https://activity.huaweicloud.com/，登錄自己的華為云賬號，進入華為云首頁。

4.2 進入 Flexus 云服務(wù)器 X 實例購買頁面

我們在華為云官網(wǎng)首頁，精選推薦模塊中，可以看到 Flexus 云服務(wù)器 X 實例，點擊進入 Flexus 云服務(wù)器 X 實例主頁。

點擊頁面中的“購買”選項，進入 Flexus 云服務(wù)器 X 實例購買頁面。

4.3 購買 Flexus 云服務(wù)器 X 實例配置

·鏡像選擇：本次實踐使用 openEuler 作為公共鏡像，請根據(jù)實際需求自定義選擇合適的操作系統(tǒng)鏡像。

·鏡像切換說明：參考的公共鏡像原為 Huawei Cloud EulerOS，但本次實踐中已切換至 openEuler。

·基礎(chǔ)配置參考：購買時可參考以下基礎(chǔ)配置進行選擇。

·確認配置及購買：在確認配置頁面仔細檢查 Flexus 云服務(wù)器 X 實例的各項設(shè)置，確保無誤后點擊“立即購買”，完成付款流程即可成功購買。

4.4 使用 Xshell 遠程連接

進入華為云 Flexus 云服務(wù)的控制臺，選擇 Flexus 云服務(wù)器 X 實例，可以看到已經(jīng)正在運行的 Flexus 云服務(wù)器 X 實例。

·復(fù)制 Flexus 云服務(wù)器 X 實例的彈性公網(wǎng) IP 地址

·主要填寫 Flexus 云服務(wù)器 X 實例的彈性公網(wǎng) IP 地址，輸入其登錄用戶和密碼，連接即可。

五、檢查 Docker 環(huán)境

5.1 檢查操作系統(tǒng)版本

檢查 Flexus 云服務(wù)器 X 實例的操作系統(tǒng)版本，本次實踐選擇的版本為 openEuler 22.03 LTS

[root@flexusx-51a1 ~]# cat /etc/os-releaseNAME="openEuler"VERSION="22.03 LTS"ID="openEuler"VERSION_ID="22.03"PRETTY_NAME="openEuler 22.03 LTS"ANSI_COLOR="0;31"

5.2 檢查內(nèi)核版本

檢查當前操作系統(tǒng)的內(nèi)核版本，當前內(nèi)核版本為 5.10.0-60.139.0.166.oe2203.x86_64。

[root@flexusx-51a1 ~]# uname -r5.10.0-60.139.0.166.oe2203.x86_64

5.3 檢查 Docker 版本

部署該項目需要提前安裝 Docker 環(huán)境，檢查 Docker 版本，當前安裝的 Docker 版本為26.1.3。

[root@flexusx-51a1 ~]# docker -vDocker version 26.1.3, build b72abbb

5.4 檢查 Docker 服務(wù)狀態(tài)

檢查 Docker 服務(wù)狀態(tài)，確保 Docker 服務(wù)正常。

[root@flexusx-51a1 ~]# systemctl status docker●docker.service - Docker Application Container EngineLoaded: loaded (/usr/lib/systemd/system/docker.service; enabled; vendor preset: disabled)Active: active (running) since Mon 2024-09-23 20:27:32 CST; 12min agoTriggeredBy:●docker.socketDocs: https://docs.docker.comMain PID: 18484 (dockerd)Tasks: 10Memory: 240.2MCGroup: /system.slice/docker.service└─18484 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock

5.5 檢查 Docker compose 版本

檢查 docker compose 版本，當前默認安裝版本為 v2.27.0。

[root@flexusx-51a1 ~]# docker compose versionDocker Compose version v2.27.0

六、部署 MaxKB 系統(tǒng)

6.1 拉取 MaxKB 鏡像

執(zhí)行以下命令，拉取 MaxKB 鏡像，鏡像名稱：cr2.fit2cloud.com/1panel/maxkb:latest。

[root@flexusx-51a1 ~]# docker pull cr2.fit2cloud.com/1panel/maxkbUsing default tag: latestlatest: Pulling from 1panel/maxkbDigest: sha256:d1211d7915d949a7a1a412ea4ec5f34942b8278f83a7333c9fa8d8027630a23eStatus: Image is up to date for cr2.fit2cloud.com/1panel/maxkb:latestcr2.fit2cloud.com/1panel/maxkb:latest

6.2 創(chuàng)建部署目錄

在命令行終端上，我們需要創(chuàng)建部署目錄/data/maxkb。

mkdir -p /data/maxkb && cd /data/maxkb

6.3 創(chuàng)建 MaxKB 容器

·可參考以下 docker-cli 命令，快速創(chuàng)建 MaxKB 容器。

docker run -d --name=maxkb -p 8080:8080 -v ~/.maxkb:/var/lib/postgresql/data -v ~/.python-packages:/opt/maxkb/app/sandbox/python-packages cr2.fit2cloud.com/1panel/maxkb

本次實踐使用 docker compose 方式部署 MaxKB 應(yīng)用，編輯 docker-compose.yaml 文件，可自行修改映射端口部分。

vim docker-compose.yaml

version: '3.9'services:1panel:image: cr2.fit2cloud.com/1panel/maxkbvolumes:- '~/.python-packages:/opt/maxkb/app/sandbox/python-packages'- '~/.maxkb:/var/lib/postgresql/data'ports:- '8080:8080'container_name: maxkb

執(zhí)行以下命令，使用 docker-compose.yaml 文件創(chuàng)建 MaxKB 服務(wù)。

docker compose up -d

6.4 檢查 MaxKB 容器狀態(tài)

檢查 MaxKB 容器狀態(tài)，確保 MaxKB 容器正常啟動。

[root@flexusx-51a1 maxkb]# docker compose psWARN[0000] /data/maxkb/docker-compose.yaml: `version` is obsoleteNAME IMAGE COMMAND SERVICE CREATED STATUS PORTSmaxkb cr2.fit2cloud.com/1panel/maxkb "bash -c /usr/bin/ru…" 1panel 33 seconds ago Up 33 seconds 5432/tcp, 0.0.0.0:8080->8080/tcp, :::8080->8080/tcp

6.5 檢查 MaxKB 容器日志

檢查 MaxKB 容器運行日志，確保 MaxKB 服務(wù)正常運行。

docker compose logs

七、訪問前準備工作

7.1 關(guān)閉 selinux 和防火墻

·關(guān)閉 selinux

setenforce 0sed -i 's/SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config

·停止防火墻

systemctl stop firewalldsystemctl disable firewalld

7.2 Flexus 云服務(wù)器 X 實例安全組配置

進入 Flexus 云服務(wù)器 X 實例控制臺，進行安全組規(guī)則配置。

入方向上放行 8080 端口，確認配置即可。

八、訪問 MaxKB 服務(wù)

8.1 訪問 MaxKB 初始頁

瀏覽器訪問地址：http://服務(wù)器 IP 地址:8080，將 IP 替換為自己云服務(wù)器彈性公網(wǎng) IP 地址。瀏覽器打開后，進入 MaxKB 登錄頁。

8.2 登錄 MaxKB

·默認登錄信息

·用戶名：admin

·默認密碼：MaxKB@123..

·第一次登錄，會自動提示修改登錄密碼，自定義修改即可。

九、MaxKB 配置工作

9.1 進入模型設(shè)置頁面

登錄 MaxKB 系統(tǒng)后，可以在【系統(tǒng)管理-模型設(shè)置】中添加模型，也可以在創(chuàng)建應(yīng)用時再添加模型。

9.2 查詢供應(yīng)商 API Key 信息

我們此次選擇的供應(yīng)商為義千問大模型，登錄其官網(wǎng)。在 DashScope 靈積模型服務(wù)控制臺->API Key 管理中獲取。

9.3 選擇模型

在模型設(shè)置的供應(yīng)商列表中，我們選擇通義千問，點擊“添加模型”。

·模型名稱：MaxKB 中自定義的模型名稱。

·模型類型：大語言模型。

·基礎(chǔ)模型：供應(yīng)商的 LLM 模型，支持自定義輸入，下拉選項是常用的一些大語言模型。

·API Key：需要在阿里云->DashScope 靈積模型服務(wù)->API Key 管理中獲取。

9.4 創(chuàng)建知識庫

打開【知識庫】頁面，點擊【創(chuàng)建知識庫】，進入創(chuàng)建知識庫頁面。

輸入知識庫名稱、知識庫描述、選擇通用型知識庫類型。根據(jù)如下圖所示，自定義填寫即可。

9.5 上傳文檔

上傳本地文件，上傳完畢后，確認“下一步”。

·上傳文檔要求：

·支持文本文件格式為：Markdown、TXT、PDF、DOCX、HTML；

·支持 QA 問答對格式為：Excel、CSV；

·每次最多上傳 50 個文件；

·每個文件不超過 100 MB；

·支持選擇文件夾，上傳文件夾下符合要求的文件。

·文檔規(guī)范建議：

·規(guī)范分段標識：離線文檔的分段標識要有一定規(guī)范，否則拆分出來的段落會不規(guī)整。

·段落要完整：一個分段中最好能描述一個完整的功能點或問題。

點擊“開始導(dǎo)入”，其余配置默認即可。

查看文件狀態(tài)，當如下圖所示，文件狀態(tài)顯示為“成功”時候，則文檔導(dǎo)入成功。

9.6 創(chuàng)建應(yīng)用

點擊【創(chuàng)建應(yīng)用】，輸入應(yīng)用名稱，選擇【簡易配置應(yīng)用】，點擊【創(chuàng)建】。

·應(yīng)用創(chuàng)建完成，進入簡易配置應(yīng)用的設(shè)置頁面，左側(cè)為應(yīng)用信息，右側(cè)為調(diào)試預(yù)覽界面。

·調(diào)試預(yù)覽

·完成上述設(shè)置后，可以在右側(cè)調(diào)試預(yù)覽中進行提問預(yù)覽。

·調(diào)試預(yù)覽中的提問內(nèi)容不會計入正式的對話日志，方便測試和調(diào)整應(yīng)用配置。

十、使用體驗與總結(jié)

通過在華為云 Flexus 云服務(wù)器 X 實例上搭建基于 openEuler 系統(tǒng)的 MaxKB 開源知識庫問答系統(tǒng)，我們深刻體驗到了華為云的強大性能和穩(wěn)定性。整個部署過程流暢無阻，F(xiàn)lexus 云服務(wù)器 X 實例的柔性算力確保了系統(tǒng)能夠高效處理復(fù)雜的自然語言查詢?nèi)蝿?wù)。實踐證明，華為云不僅提供了卓越的技術(shù)支持，還極大地簡化了運維工作，使得中小企業(yè)和開發(fā)者能夠輕松構(gòu)建和管理高性能的應(yīng)用。此外，華為云的高可用性和安全性進一步增強了我們對系統(tǒng)的信心，為企業(yè)的知識管理和信息檢索帶來了顯著的效率提升?？傮w而言，華為云 Flexus 云服務(wù)器 X 實例展現(xiàn)了其在現(xiàn)代云計算環(huán)境中的出色表現(xiàn)，是企業(yè)數(shù)字化轉(zhuǎn)型的理想選擇。

在華為云 828 B2B 企業(yè)節(jié)期間，F(xiàn)lexus X 實例推出了重磅優(yōu)惠活動。華為云憑借其頂級的云服務(wù)和卓越的性能穩(wěn)定性，成為推動企業(yè)業(yè)務(wù)增長的理想選擇。我們誠摯邀請各行各業(yè)的企業(yè)加入華為云大家庭，共同見證技術(shù)革新帶來的無限可能。讓我們攜手并進，共同開創(chuàng)云端的輝煌未來，共享科技進步所帶來的豐碩成果。

審核編輯 黃宇