ZAI服务安装 分享链接 /book/zentaopms/1774.html?releaseID=17

一、快速开始

1. 检查部署条件和安装依赖
2. 使用docker compose快速搭建ZAI服务（包含其所依赖的数据库）
3. 为禅道安装ZAI插件
4. 配置禅道ZAI插件（配置禅道ZAI插件与ZAI服务的连接）

需要下载的安装包，点击名称下载即可

1.zaicompose

2.zai服务Linux包

3.zai服务Windows包

4.zaiwindows依赖的postgresql包

• docker compose部署方式： 需要docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin，需要glibc>=2.31
• linux手动部署方式：glibc >=2.31
• windows手动部署方式 os-release >= win10

ldd --version

docker pull hub.zentao.net/app/zai:latest 
docker pull pgvector/pgvector:pg16

unzip zaicompose.zip 
cd zaicompose 
# vim template/appsettings.json 
# vim template/init.json

# cd zaicompose 
docker compose up -d 
# 显示容器状态 # 
docker compose ps 
# 停止服务并删除数据 # 
docker compose down -v

例如：http://x.x.x.x:5000/system/models 访问您在 appsettings.json 中编辑启用的大模型列表（也可在ZAI控制台中图形化编辑）。

配置禅道ZAI插件

使用初始化程序自动化获取禅道插件配置字段，也可通过ZAI控制台图形化手动配置禅道插件。

使用初始化程序自动化获取配置字段

# cd zaicompose
./zaiiniter init
# ./zaiiniter -u <your zai service address> -p <your zai service port>

保存输出，例如

appID: jb9iFHJLFK
appToken: 0TElvU6meuHOsiZZNOsWF3knAWl57kS1

将appID和appToken填入禅道中。其中应用ID填 appID 密钥填 appToken 主机填ZAI服务所在的IP或网址，端口填ZAI服务所在的端口（默认5000）。

使用ZAI控制台图形化获取禅道连接字段

也可以使用ZAI控制台图形化界面手动的获取与禅道的连接字段。

postgresql安装

sudo apt-get install postgresql postgresql-contrib 
sudo systemctl status postgresql.service
sudo apt-get install postgresql-server-dev-14 
sudo apt-get install gcc g++ make 
cd /tmp 
wget https://github.com/pgvector/pgvector/archive/refs/tags/v0.8.0.tar.gz 
tar -zxf pgvector-0.8.0.tar.gz 
cd pgvector-0.8.0 
sudo make && sudo make install

sudo -u postgres psql 
postgres=# CREATE ROLE user1 WITH LOGIN PASSWORD '123456'; CREATE ROLE 
postgres=# CREATE DATABASE zai OWNER user1; 
CREATE DATABASE 
postgres=# \c zai 
You are now connected to database "zai" as user "postgres". 
zai=# CREATE EXTENSION IF NOT EXISTS vector; 
CREATE EXTENSION 
zai=# \q

tar zxf zai_linux_x64.tar.gz 
cd zai_linux_x64

cd zai_linux_x64 
vim appsettings.json  
vim init.json 

• ConnectionStrings：数据库连接字符串  （重要）
  • Default: Host=数据库地址(localhost); Port=数据库端口(5432) Database=zai; Username=user1; Password=123456;
  • RabbitMQ: 不填
  • Redis：Redis 连接字符串 默认空为不启用
• ServerSettings.BaseUrl：暴露给用户访问的服务器地址  （重要）（本机ip）
• Kestrel.Endpoints.Http.Url：后端HTTP 服务地址和端口 （重要）（服务地址与ServerSettings.BaseUrl相同）
• LlmProviderSettings：LLM 提供商设置（OpenAI格式）
  • Endpoint：LLM 提供商 API 端点 （重要）
  • Key：LLM 提供商 API 密钥 （重要）
  • DefaultChatModel：默认聊天模型 （重要）

cd zai_linux_x64 
sudo ./zai

C:\pgsql\bin\initdb.exe -D C:\pgsql\data

listen_addresses = '*'

 C:\pgsql\bin\pg_ctl.exe -D C:\pgsql\data -l C:\pgsql\logs\logfile start

配置数据库

C:\pgsql\bin\psql.exe postgres 
postgres=# CREATE ROLE user1 WITH LOGIN PASSWORD '123456'; CREATE ROLE 
postgres=# CREATE DATABASE zai OWNER user1; 
CREATE DATABASE 
postgres=# \c zai 
zai 
zai=# CREATE EXTENSION IF NOT EXISTS vector; 
CREATE EXTENSION

# 编辑 appsettings.json 
# 编辑 init.json

• ConnectionStrings：数据库连接字符串  （重要）
  • Default: Host=数据库地址(localhost); Port=数据库端口(5432) Database=zai; Username=user1; Password=123456;
  • RabbitMQ: 不填
  • Redis：Redis 连接字符串 默认空为不启用
• ServerSettings.BaseUrl：暴露给用户访问的服务器地址  （重要）（本机ip）
• Kestrel.Endpoints.Http.Url：后端HTTP 服务地址和端口 （重要）（服务地址与ServerSettings.BaseUrl相同）
• LlmProviderSettings：LLM 提供商设置（OpenAI格式）
  • Endpoint：LLM 提供商 API 端点 （重要）
  • Key：LLM 提供商 API 密钥 （重要）
  • DefaultChatModel：默认聊天模型 （重要）

.\zai.exe

• ConnectionStrings：数据库连接字符串  （重要）（docker compose部署保持默认）
  • Redis：Redis 连接字符串 默认空为不启用
• ServerSettings.BaseUrl：暴露给用户访问的服务器地址  （重要）（docker compose部署保持默认）
• Kestrel.Endpoints.Http.Url：后端HTTP 服务地址和端口 （重要）（服务地址与ServerSettings.BaseUrl相同）（docker compose部署保持默认）
• LlmProviderSettings：LLM 提供商设置（OpenAI格式）
  • Endpoint：LLM 提供商 API 端点 （重要）
  • Key：LLM 提供商 API 密钥 （重要）
  • DefaultChatModel：默认聊天模型 （重要）
• DefaultChatModelMaxToken：默认聊天模型上下文窗口
• DefaultEmbeddingModel：默认向量化模型
• DefaultEmbeddingModelMaxToken：默认向量化模型上下文窗口
• Models：模型信息
  • Abilities：支持功能
• MailSettings：邮件设置
• Logging：日志设置

如果你想要指定zai或pgvector暴露的端口及其他，你需要修改docker-compose.yml。下面是一个修改pgvector暴露的端口的示例：

如果修改了pg暴露的端口，appsettings.json需要同步更新