详细安装步骤

前提条件

已安装glibc 2.34及以上版本。

操作步骤

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

进入解压后的目录。

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

解压后文件目录如下：

        
         
           
           
             ├── 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

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

        
             ./encrypt

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

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

配置config.yaml文件。

打开配置文件。
1

vi config.yaml

按“i”进入编辑模式，修改配置文件。

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

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

按“Esc”键退出编辑模式，输入:wq!，按“Enter”键保存并退出文件。

执行embeddings文件，进行文档的向量化和入库操作（首次使用或删除chroma_db文件夹后需要执行该步骤）。

        
             ./embeddings

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

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

执行以下命令启动DevKit AI服务。

        
             nohup ./server > ./uvicorn.log 2>&1 &
cat ./uvicorn.log

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

升级

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

卸载

根据端口号查询服务进程号并停止server进程。可使用同类工具（如lsof、netstat等）查询对应的服务进程号，请根据实际需求选择即可。
```
ss -tulpn | grep :{port}
kill -9 {pid}
```
- {port}：待卸载的服务侦听的端口号。
- {pid}：查询出来的服务进程号。
使用rm命令删除工具文件夹即可。

父主题： 安装部署DevKit AI