---
title: 详细安装步骤
description: "已安装glibc 2.34及以上版本。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengdevps/devkitai/usermanual/kunpengDevKitAI_0005.html
sourcePath: /source/zh/kunpengdevps/devkitai/usermanual/kunpengDevKitAI_0005.html
indexId: a1b4a9220228ee4517433248036305cec09e3afe6d73115fb1c3149f648a856a69
---
# 详细安装步骤

#### 前提条件

已安装glibc 2.34及以上版本。


#### 操作步骤

1. 使用SSH远程登录工具，将获取软件包中获取的DevKit AI基础包（DevKit-AI-x.x.x-Linux-Kunpeng.tar.gz）拷贝到自定义路径下。
2. 解压DevKit AI基础包（其中“x.x.x”表示版本号，请用实际情况代替）。

```
tar -xvzf DevKit-AI-
x.x.x
-Linux-Kunpeng.tar.gz
```


3. 进入解压后的目录。

```
cd DevKit-AI-
x.x.x
-Linux-Kunpeng
```


  解压后文件目录如下：

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 ├── chroma_db # 向量数据库 ├── config # 软件包下载配置文件 ├── config.yaml # 服务配置文件 ├── dangerous_patterns.yaml # 危险命令配置 ├── devkitai_cli # 命令行工具 ├── documents # 待入库的文件 ├── embeddings # 向量化文档工具 ├── encrypt # 加密工具 ├── _internal # 运行时资源文件 ├── Kunpeng DevKit License Agreement 1.0.txt ├── libcrypto.so.3 # 加密工具依赖的OpenSSL库文件(非必须，仅在需要配置加密内容如api_key时并且服务器上未安装OpenSSL时才需要) ├── Open_Source_Software_Notice.txt ├── porting_workflow_cli # 迁移工作流命令行 ├── server # Server工具 ├── skills # Skill文件存放目录 ├── store # 加密内容保存文件 ├── subagent_config # 子Agent注册配置文件存放目录 └── 鲲鹏开发套件DevKit许可协议 1.0.txt

  如本机未安装OpenSSL，需要在执行工具前导入环境变量。其中，“/path/to”表示工具文件夹实际存放路径。 export LD_LIBRARY_PATH=/path/to/DevKit-AI-x.x.x-Linux-Kunpeng:$LD_LIBRARY_PATH

4. （可选）运行encrypt工具，生成私钥密码、api_key或认证密钥的密文。使用加密私钥文件、api_key或启用用户认证的情况下需要执行该步骤。
  1 ./encrypt

  根据提示输入需要加密的内容，回显将显示加密后的密文。如需加密多个内容，可重复执行此操作。

  1 2 请输入需要加密的内容: 加密后的密文： ******************************************************

5. 配置config.yaml文件。

  a. 打开配置文件。
    1 vi config.yaml

  b. 按“i”进入编辑模式，修改配置文件。
    1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 # 服务基础核心配置 server: # 支持协议：http / https 默认https；用户需填写host值；port值默认为8000 protocol: https host: port: 8000 # HTTPS SSL证书配置 (https模式时必填，http模式自动失效) ssl: ssl_keyfile: /path/key.pem ssl_certfile: /path/cert.pem # 仅当ssl_keyfile指向加密私钥文件时填写（可选），需填入经encrypt加密后的值 ssl_keyfile_password: # 用户认证，用于鉴权 (可选)；value填写为加密后的值 key : enable: true value: # 聊天模型配置 llm: model: provider: base_url: api_key: # 词嵌入模型配置 embedding: model: provider: base_url: api_key:

    如下为示例：

**表1 参数说明**

| 参数 | 参数 | 说明 | 备注 |
| --- | --- | --- | --- |
| 服务基础核心配置 | 服务基础核心配置 | 服务基础核心配置 | 服务基础核心配置 |
| protocol | protocol | 服务协议，默认使用https。若配置为https，请在ssl字段中配置证书文件相关信息。 | Cline编程助手不支持HTTPS协议。 |
| host | host | 本机IP地址。无默认值，不建议填写0.0.0.0。 | \- |
| port | port | 服务侦听端口，默认8000。 | 如果服务器已开通防火墙，请确认服务器OS防火墙已开通服务侦听端口，请参见开启防火墙端口。 |
| ssl | ssl\_keyfile | 通过OpenSSL获取的私钥文件。文件存放路径可自定义，需配置为绝对路径，并确保安装DevKit AI用户有读权限。 | 详细操作请参见通过OpenSSL获取私钥文件与证书文件。 |
| ssl | ssl\_certfile | 通过OpenSSL获取的证书文件。文件存放路径可自定义，需配置为绝对路径，并确保安装DevKit AI用户有读权限。 | 详细操作请参见通过OpenSSL获取私钥文件与证书文件。 |
| ssl | ssl\_keyfile\_password | 仅当ssl\_keyfile指向加密私钥文件时填写（可选），需填入经encrypt加密后的值。 | 详细操作请参见通过OpenSSL获取私钥文件与证书文件。 |
| key | enable | 是否启用用户认证，若开启则需要配置value。 | \- |
| key | value | 用户认证密钥的密文，密钥为用户自定义，可通过步骤4工具生成。 | \- |
| 聊天/词嵌入模型配置 | 聊天/词嵌入模型配置 | 聊天/词嵌入模型配置 | 聊天/词嵌入模型配置 |
| model | model | 模型名称（例如：deepseek\-v4\-pro或者glm\-5.1）。 | \- |
| provider | provider | 模型provider，仅支持openai或ollama格式。 | \- |
| base\_url | base\_url | 模型的服务地址。 | \- |
| api\_key | api\_key | 模型的api\_key密文，仅openai格式需要使用，可通过步骤4工具生成。 | \- |


    由于工具共用运行时资源文件，因此无论是否使用全部功能，都需完整填写配置。

  c. 按“Esc”键退出编辑模式，输入:wq!，按“Enter”键保存并退出文件。
6. 执行embeddings文件，进行文档的向量化和入库操作（首次使用或删除chroma_db文件夹后需要执行该步骤）。
  1 ./embeddings

  显示如下内容，则表示文档已入库成功。

  1 嵌入 (Embeddings) 已完成；文档已成功存入向量数据库。

7. 执行以下命令启动DevKit AI服务。
  1 2 nohup ./server > ./uvicorn.log 2>&1 & cat ./uvicorn.log

  其中，uvicorn.log是服务框架的日志，文件存放路径和名字可自定义。如下图所示即表示DevKit AI服务已正常启动。


#### 升级

产品以压缩包形式提供，解压后即可使用，暂不支持原地升级。如需升级，可直接执行新版本的安装步骤即可。


#### 卸载

1. 根据端口号查询服务进程号并停止server进程。可使用同类工具（如lsof、netstat等）查询对应的服务进程号，请根据实际需求选择即可。

```
ss -tulpn | grep :{
port
}
kill -9 {
pid
}
```


  {port}：待卸载的服务侦听的端口号。 {pid}：查询出来的服务进程号。

2. 使用rm命令删除工具文件夹即可。