--- title: openEuler Intelligence 智能助手部署指南-官方技术文章-鲲鹏社区 description: openEuler Intelligence 智能助手部署指南 keywords: Euler,Intelligence,智能助手部署指南,官方技术文章,鲲鹏社区,产品概述,组件介绍,软件要求 url: https://www.hikunpeng.com/developer/techArticles/20251209-7?envFlag=1 section: (其他) --- # openEuler Intelligence 智能助手部署指南-官方技术文章-鲲鹏社区 URL: https://www.hikunpeng.com/developer/techArticles/20251209-7?envFlag=1 描述: openEuler Intelligence 智能助手部署指南 关键词: Euler,Intelligence,智能助手部署指南,官方技术文章,鲲鹏社区,产品概述,组件介绍,软件要求 官方技术文章 [了解详情](https://www.hikunpeng.com/zh/developer/techArticles) openEuler Intelligence 部署指南 openEuler Intelligence 部署指南 openEuler 发表于 2025/12/09 0 ## 产品概述 openEuler Intelligence 是一款智能问答工具，使用 openEuler Intelligence 可以解决操作系统知识获取的便捷性，并且为OS领域模型赋能开发者及运维人员。作为获取操作系统知识，使能操作系统生产力工具 (如 A-Ops / A-Tune / x2openEuler / EulerMaker / EulerDevOps / StratoVirt / iSulad 等)，颠覆传统命令交付方式，由传统命令交付方式向自然语义进化，并结合智能体任务规划能力，降低开发、使用操作系统特性的门槛。 本指南提供基于自动化脚本的openEuler Intelligence系统部署说明，支持一键自动部署和手动分步部署两种方式。 ### 组件介绍 | 组件 | 端口 | 说明 | | --- | --- | ---| | euler-copilot-framework | 8002 (内部端口) | 智能体框架服务 | | euler-copilot-web | 8080 | 智能体前端界面 | | euler-copilot-rag | 9988 (内部端口) | 检索增强服务 | | authhub-backend-service | 11120 (内部端口) | 鉴权服务后端 | | authhub-web-service | 8000 | 鉴权服务前端 | | mysql | 3306 (内部端口) | MySQL数据库 | | redis | 6379 (内部端口) | Redis数据库 | | minio | 9000 (内部端口) 9001(外部部端口) | minio数据库 | | mongo | 27017 (内部端口) | mongo数据库 | | postgres | 5432 (内部端口) | 向量数据库 | | secret_inject | 无 | 配置文件安全复制工具 | ### 软件要求 | 类型 | 版本要求 | 说明 | | --- | --- | ---| | 操作系统 | openEuler 22.03 LTS 及以上版本 | 无 | | K3s | >= v1.30.2，带有 Traefik Ingress 工具 | K3s 提供轻量级的 Kubernetes 集群，易于部署和管理 | | Helm | >= v3.15.3 | Helm 是一个 Kubernetes 的包管理工具，其目的是快速安装、升级、卸载 openEuler Intelligence 服务 | | python | >=3.9.9 | python3.9.9 以上版本为模型的下载和安装提供运行环境 | ### 硬件规格 | 硬件资源 | 最小配置 | 推荐配置 | | --- | --- | ---| | CPU | 4 核心 | 16 核心及以上 | | RAM | 4 GB | 64 GB | | 存储 | 32 GB | 64G | | 大模型名称 | deepseek-llm-7b-chat | DeepSeek-R1-Llama-8B | | 显存 (GPU) | NVIDIA RTX A4000 8GB | NVIDIA A100 80GB * 2 | 关键说明： - 纯CPU环境，建议通过调用 OpenAI 接口或使用自带的模型部署方式来实现功能。 - 如果k8s集群环境，则不需要单独安装k3s，要求version >= 1.28 ### 部署视图 ### 域名配置 需准备以下两个服务域名： - authhub认证服务：authhub.eulercopilot.local - openEuler Intelligence web服务：www.eulercopilot.local ``` # 本地Windows主机中进行配置 # 打开 C:\Windows\System32\drivers\etc\hosts 添加记录 # 替换127.0.0.1为目标服务器的IP 127.0.0.1 authhub.eulercopilot.local 127.0.0.1 www.eulercopilot.local ``` ## 快速开始 ### 1. 资源获取 - 获取部署脚本openEuler Intelligence 的官方Git仓库 切换至dev分支点击下载ZIP, 并上传至目标服务器 ``` unzip euler-copilot-framework.tar -d /home ``` - 资源清单下载地址EulerCopilot 资源仓库镜像文件# 使用脚本自动下载所有镜像（需在联网环境执行） ``` # 使用脚本自动下载所有镜像（需在联网环境执行） cd /home/euler-copilot-framework/deploy/scripts/9-other-script/ # 执行镜像下载（版本号可替换） ./save_images.sh 0.9.5 # 自动保存到目录/home/eulercopilot/images # 上传至目标服务器 scp /home/eulercopilot/images/* root@target-server:/home/eulercopilot/images/ ``` - 模型部署文件：bge-m3-Q4_K_M.gguf, deepseek-llm-7b-chat-Q4_K_M.gguf, ollama-linux-arm64.tgz/ollama-linux-amd64.tgz - 工具包：helm-v3.15.0-linux-arm64.tar.gz/helm-v3.15.0-linux-amd64.tar.gz, k3s-airgap-images-arm64.tar.zst/k3s-airgap-images-amd64.tar.zst,k3s-arm64/k3s-amd64, k3s-install.sh - 网络要求： 手动下载需确保存在可访问外网文件的Windows环境，全部下载完成后传输至离线环境；脚本下载需在联网服务器执行，仅完成镜像下载，完成传输至离线环境 - 确保目标服务器存在以下目录 ``` /home/eulercopilot/ ├── images/ # 存放镜像文件 ├── models/ # 存放模型文件 └── tools/ # 存放工具包 ``` ### 2. 部署openEuler Intelligence #### 一键部署 ``` cd /home/euler-copilot-framework/deploy/scripts ``` ``` bash deploy.sh ``` ``` # 输入0进行一键自动部署 ============================== 主部署菜单 ============================== 0) 一键自动部署 1) 手动分步部署 2) 重启服务 3) 卸载所有组件并清除数据 4) 退出程序 ============================== 请输入选项编号（0-3）: 0 ``` #### 手动分步部署 ``` # 选择1 -> 1 进入手动分步部署 ============================== 主部署菜单 ============================== 0) 一键自动部署 1) 手动分步部署 2) 重启服务 3) 卸载所有组件并清除数据 4) 退出程序 ============================== 请输入选项编号（0-3）: 1 ``` ``` # 输入选项编号（0-9），逐步部署 ============================== 手动分步部署菜单 ============================== 1) 执行环境检查脚本 2) 安装k3s和helm 3) 安装Ollama 4) 部署Deepseek模型 5) 部署Embedding模型 6) 安装数据库 7) 安装AuthHub 8) 安装EulerCopilot 9) 返回主菜单 ============================== 请输入选项编号（0-9）: ``` 关键说明： 1. 安装部署前需要预先准备好部署所需的资源 2. 在部署过程中，您需要输入 Authhub 域名和 openEuler Intelligence 域名, 不输入则使用默认域名`authhub.eulercopilot.local`,`www.eulercopilot.local`。 #### 重启服务 ``` # 输入选项重启服务 ============================== 服务重启菜单 ============================== 可重启的服务列表： 1) authhub-backend 2) authhub 3) framework 4) minio 5) mongo 6) mysql 7) pgsql 8) rag 9) rag-web 10) redis 11) web 12) 返回主菜单 ============================== 请输入要重启的服务编号（1-12）: ``` #### 卸载所有组件 ``` sudo ./deploy.sh # 选择2进行完全卸载 ============================== 主部署菜单 ============================== 0) 一键自动部署 1) 手动分步部署 2) 卸载所有组件并清除数据 3) 退出程序 ============================== 请输入选项编号（0-3）: 2 ``` 关键说明： - 在部署过程中，您需要输入 Authhub 域名和 openEuler Intelligence 域名, 不输入则使用默认域名`authhub.eulercopilot.local`,`www.eulercopilot.local`。 - 资源不足时可参考 FAQ 中的评估资源可用性解决 - 查看组件日志 ``` kubectl logs -n euler-copilot ``` - 查看服务状态 ``` kubectl get pod -n euler-copilot ``` - 大模型配置修改并更新openEuler Intelligence ``` cd /home/euler-copilot-framework/deploy/chart/euler-copilot ``` ``` vim values.yaml ``` ``` helm upgrade euler-copilot -n euler-copilot . ``` ## 验证安装 恭喜您，openEuler Intelligence已成功部署！为了开始您的体验，请在浏览器中输入`https://您的openEuler Intelligence域名`链接访问 openEuler Intelligence 的网页界面： 首次访问时，您需要点击页面上的立即注册按钮来创建一个新的账号，并完成登录过程。 本页内容