

- 1. 禅道介紹
- 1.1 关于禅道項目管理软件
- 1.2 如何獲得支持
- 1.3 各版本功能差異
- 1.4 關注我們
- 2. 安裝禅道
- 2.1. 環境搭建
- 2.1.1 搭建Ubuntu環境安裝禅道
- 2.1.2 搭建Centos環境安裝禅道
- 2.1.3 安裝PHP的ioncube擴展
- 2.2. 安裝禅道
- 2.2.1 選擇適合您的安裝方法
- 2.2.2 新版本禅道的安裝升級
- 2.2.3 Windows一鍵安裝包(新版)
- 2.2.4 Windows一鍵安裝包(舊版)
- 2.2.5 linux用一鍵安裝包(推薦)
- 2.2.6 使用源碼包安裝(各系統通用)
- 2.2.7 使用源碼包安裝(MAC系統)
- 2.2.8 基于禅道當前的一鍵安裝包(Windows和Linux)如何源碼安裝旗艦版禅道
- 2.2.9 渠成命令行安裝禅道
- 2.2.10 Docker和Kubernetes方式部署禅道
- 2.3 安裝PHP的LDAP擴展
- 2.4 在线安装雲禅道
- 2.5 安装 APCu扩展
- 2.6 安裝DuckDB引擎
- 2.7. 信創支持
- 2.7.1 OceanBase數據庫
- 2.8. 安装文檔协同服務
- 2.8.1 安装Windows协同服務
- 2.8.2 安装Linux协同服務
- 2.1. 環境搭建
- 3. 升級禅道
- 3.1. 升級禅道新版本
- 3.1.1 選擇和自己環境對應的升級方式
- 3.1.2 通過源代碼方式升級(通用)
- 3.1.3 windows一鍵安裝包的升級
- 3.1.4 linux一鍵安裝包升級
- 3.1.5 docker安裝禅道-升級禅道
- 3.1.6 舊版Docker鏡像升級說明
- 3.1.7 通過Roadrunner管理定時任務
- 3.2 如何安裝ioncube擴展
- 3.1. 升級禅道新版本
- 4. 維護配置
- 4.1. 維護禅道
- 4.1.1 初始化管理腳本
- 4.1.2 備份禅道
- 4.1.3 恢複刪除的資源
- 4.1.4 如何更新燃盡圖
- 4.1.5 一鍵安裝包如何實現mysql異機連接
- 4.1.6 linux一鍵安裝包配置https
- 4.1.7 禅道一鍵安裝包遷移/更新禅道一鍵安裝包
- 4.2. 配置禅道
- 4.2.1 設置是否允許匿名訪問
- 4.2.2 如何配置email發信
- 4.2.3 如何成爲超級管理員
- 4.2.4 配置禅道系統爲靜態訪問
- 4.2.5 去掉禅道訪問地址中的zentao
- 4.2.6 linux一键安装包去掉禅道訪問地址中的zentao
- 4.2.7 集成禅道和svn
- 4.2.8 集成禅道和git
- 4.2.9 在第三方應用中集成禅道
- 4.2.10 第三方應用配置免密登錄禅道
- 4.2.11 第三方應用集成禅道客戶端進行消息通知
- 4.2.12 集成webhook
- 4.2.13 集成ZDOO
- 4.2.14 客戶端集成
- 4.2.15 浏覽器通知的設置
- 4.2.16 集成釘釘工作消息通知
- 4.2.17 集成企業微信應用消息通知
- 4.2.18 集成企業微信群機器人
- 4.2.19 集成飛書群機器人
- 4.2.20 集成飛書消息通知
- 4.2.21 解決一鍵安裝包密碼口令弱的問題
- 4.3. 性能優化
- 4.3.1 nginx反向代理禅道502或504bad gateway错误
- 4.3.2 linux系統中配置session使用redis
- 4.3.3 緩存功能
- 4.1. 維護禅道
- 5. 快速入門
- 5.1. 新版本快速入門
- 5.1.1 20版本禅道的新增功能
- 5.1.2 新版本禅道的最簡使用
- 5.1.3 20版本禅道的界面變化
- 5.1. 新版本快速入門
- 6. 按照角色使用
- 6.1. 管理員
- 6.2. 項目集負責人
- 6.3. 産品经理
- 6.3.1 維護模塊
- 6.3.2 産品多分支/平台管理
- 6.3.3 維護計劃
- 6.3.4 維護需求
- 7.4.5 需求的狀態和研發階段
- 6.3.6 創建發布
- 6.3.7 跟蹤進度
- 6.3.8 反饋管理(企业版)
- 6.4. 項目經理
- 6.5. 研發人員
- 6.5.1 参加産品计划會議,分解任务
- 6.5.2 領取任務,並每天更新任務
- 6.5.3 創建構建,提交測試
- 6.5.4 確認Bug,解決Bug
- 6.5.5 執行的綜合、需求、Bug、任務看板
- 6.6. 測試人員
- 7. 功能介紹
- 7.1. 核心管理結構
- 7.1.1 項目集(Program)
- 7.1.2 項目(Project)
- 7.1.3 産品(Product)
- 7.1.4 執行(Execution)
- 7.1.5 管理模型
- 7.2. 地盤
- 7.3. 項目集
- 7.4. 産品
- 7.4.1 创建産品
- 7.4.2 維護模塊
- 7.4.3 産品多分支/平台管理
- 7.4.4 維護計劃
- 7.4.5 維護需求
- 7.4.6 需求的評審
- 7.4.7 需求的狀態和研發階段
- 7.4.8 創建發布
- 7.4.9 跟蹤進度
- 7.4.10 業務需求&需求多層級
- 7.5. 項目
- 7.6. 執行
- 7.6.1 参加産品计划會議,分解任务
- 7.6.2 領取任務,並每天更新任務
- 7.6.3 創建構建,提交測試
- 7.6.4 確認Bug,解決Bug
- 7.6.5 執行的綜合、需求、Bug、任務看板
- 7.7. 測試
- 7.8. 自動化測試
- 7.9 DevOps(解決方案)
- 7.10. 文檔
- 7.11. AI
- 7.11.1 AI小程序簡介
- 7.11.2 創建與設計AI小程序
- 7.11.3 發布與禁用小程序
- 7.11.4 調試AI小程序
- 7.11.5 前台小程序的應用
- 7.11.6 AI小程序的導入導出
- 7.11.7 管理AI小程序權限
- 7.12. BI
- 7.12.1 維度(企業版8.4+)
- 7.12.2 大屏(企業版8.4+)
- 7.12.3 透視表
- 7.12.4 透視表下钻
- 7.12.5. 大屏設計器
- 7.12.5.1 大屏設計器界面布局
- 7.12.5.2 大屏設計器引用圖表
- 7.12.5.3 大屏设计器引用透視表
- 7.12.6 圖表
- 7.12.7. 度量項
- 7.12.7.1 查看度量項
- 7.12.7.2 創建度量項
- 7.12.7.3 度量項編碼開發操作手冊
- 7.12.8 數據表(企業版8.4+)
- 7.13. 反饋
- 7.14. 看板
- 7.14.1 通用看板功能
- 7.15. 工作流
- 7.16. 學堂
- 7.17. 資産庫(旗艦版)
- 7.17.1 資産庫管理(旗舰版)
- 7.18. 組織
- 7.18.1 團隊成員和工作信息
- 7.18.2 人力資源日曆(需安裝插件)
- 7.18.3 组织動態
- 7.18.4 公司信息
- 7.19. 辦公
- 7.20. 後台設置
- 7.20.1 後台首頁
- 7.20.2. 系統設置
- 7.20.3 功能開關
- 7.20.4. 人員管理
- 7.20.5. 模型配置
- 7.20.6. 功能配置
- 7.20.7 文檔模板
- 7.20.8. 通知設置
- 7.20.9 插件管理
- 7.20.10 二次開發
- 7.20.11 Jira數據導入
- 7.20.12 Jira數據導入--数据迁移说明
- 7.20.13 Confluence數據導入
- 7.20.14. 權限維護和控制
- 7.20.14.1 項目集的權限維護和訪問控制
- 7.20.14.2 産品的权限维护和访问控制
- 7.20.14.3 項目的權限維護和訪問控制
- 7.20.14.4 執行的权限维护和访问控制
- 7.20.14.5 项目和執行的访问控制和数据关系
- 7.20.15. AI配置
- 7.20.16. DevOps設置
- 7.20.16.1. 資源
- 7.21. 客户端增强版會議SRS
- 7.21.1. 音視頻會議配置
- 7.21.1.1 安装音視頻服務端
- 7.21.1.2 安装SRS音視頻服務端
- 7.21.1.3 开启和配置音視頻功能
- 7.21.2. 发起會議
- 7.21.2.1 一对一会话中发起音視頻會議
- 7.21.2.2 群组会话中发起音視頻會議
- 7.21.2.3 独立发起音視頻會議入口
- 7.21.3. 加入會議
- 7.21.3.1 分享音視頻會議到会话
- 7.21.3.2 通过會議的ID加入會議
- 7.21.4. 预约會議
- 7.21.4.1 预约會議
- 7.21.5. 會議应用
- 7.21.5.1 音視頻會議应用
- 7.21.1. 音視頻會議配置
- 7.22. 客户端增强版會議Jitsi
- 7.1. 核心管理結構
- 8. AI插件
- 8.1 AI插件安裝
- 8.2 ZAI服務安装
- 8.3 AI插件功能使用
- 8.4 ZAI服務控制面板使用
- 9. 其他相關
- 9.1. 其他
- 9.1.1 禅道所使用到的第三方代碼
- 9.1.2 禅道FAQ
- 9.1.3 如何幫助禅道项目
- 9.1.4 禅道商业服務
- 9.1.5 禅道項目的貢獻者
- 9.1.6 曆史修改記錄
- 9.1.7 禅道對象名稱的重名規則
- 9.1. 其他
- 10. IPD版本功能介紹
- 10.1. 禅道IPD版介紹
- 10.1.1 關于禅道IPD版
- 10.1.2 禅道IPD版的核心流程
- 10.2. IPD版的安裝和升級
- 10.2.1 選擇適合您的安裝方法
- 10.2.2 選擇適合您的升級方法
- 10.3. 需求与市場管理界面
- 10.4. IPD研發管理界面
- 10.1. 禅道IPD版介紹
ZAI服務安装 分享鏈接 /book/zentaopms/zai-install-1774.html?releaseID=21
本篇目錄
介紹
ZAI 是一款面向企业的智能服務平台,基于 雷駝智能引擎 實現。
ZAI 提供大模型聚合能力,为智能对话、知识库、智能体等场景提供基础支撑。它内置完善的监控体系,可实时查看用量统计与分析报表;同时具备多层安全防护,支持调用限制策略与内容安全管理。
禅道 AI 依赖 ZAI 作为基础服務。本文将介紹 ZAI 的安装流程和基本使用方法。
注意:ZAI 1.0 是一个全新升级的版本,不支持从更早的 beta 版本升级,需要进行全新安装使用。
通过 Docker 安装
目前 ZAI 服務支持通过 Docker 部署,步骤如下:
第一步:安装 Docker
確保 Docker 已安裝。
第二步:创建 docker-compose.yml 文件
在文件系统中创建一个目錄来存放 ZAI
服務相关文件,例如 ~/zai/
。然後在 ~/zai/
目錄下创建一个名为 docker-compose.yml
的空白文本文件。可通過命令行創建:
# 创建一个名为 zai(可以是其他名称)的文件夹,用于存放 ZAI 服務生成的系统文件 mkdir zai && cd zai # 创建一个 docker-compose.yml 空白文件 touch docker-compose.yml
第三步:配置 docker-compose.yml
使用任意編輯器打開 docker-compose.yml
文件,並添加以下內容:
services: # PostgreSQL 数据库服務;如使用自建数据库,请删除此服務 postgres: image: pgvector/pgvector:pg16 container_name: postgres ports: - "5432:5432" environment: - POSTGRES_USER=postgres # Postgres 管理员用戶名 - POSTGRES_PASSWORD=zai123456 # Postgres 管理员密码 - POSTGRES_DB=zai_base # 初始化数据库名 volumes: - postgres_data:/var/lib/postgresql/data healthcheck: test: ["CMD-SHELL", "pg_isready -U postgres"] interval: 5s timeout: 5s retries: 5 networks: - zai-network # 初始化数据库服務,如果使用自己的数据库服務,请删除此服務 db-init: image: postgres:16 depends_on: postgres: condition: service_healthy environment: - POSTGRES_USER=postgres # 与 postgres 服務一致的用戶名 - POSTGRES_PASSWORD=zai123456 # 与 postgres 服務一致的密码 - POSTGRES_DB=zai_base # 连接的数据库名(将启用 pgvector 扩展) # 通过 psql 连接到 postgres,创建 pgvector 扩展;若目标数据库不存在则先创建,再启用扩展;并在執行前主动等待端口就绪 command: > bash -lc "set -euo pipefail; PGPASSWORD=$$POSTGRES_PASSWORD psql -h postgres -U $$POSTGRES_USER -d postgres -v ON_ERROR_STOP=1 -tAc \"SELECT 1 FROM pg_database WHERE datname='$$POSTGRES_DB'\" | grep -q 1 || \ PGPASSWORD=$$POSTGRES_PASSWORD psql -h postgres -U $$POSTGRES_USER -d postgres -v ON_ERROR_STOP=1 -c \"CREATE DATABASE \\\"$$POSTGRES_DB\\\"\"; \ PGPASSWORD=$$POSTGRES_PASSWORD psql -h postgres -U $$POSTGRES_USER -d $$POSTGRES_DB -v ON_ERROR_STOP=1 -c 'CREATE EXTENSION IF NOT EXISTS vector;'" networks: - zai-network restart: "no" # ZAI 服務 app: image: qihangnet/zai:v1.0.26 # 使用 v1.0.26 版本 container_name: zai ports: - "8000:8000" environment: - LANG=zh_CN.UTF-8 # 容器默认语言与编码 - LANGUAGE=zh_CN:zh # 语言优先顺序 - DB_HOST=postgres # 数据库主机(Compose 服務名) - DB_PORT=5432 # 數據庫端口 - DB_USER=postgres # 数据库用戶名 - DB_PASSWORD=zai123456 # 數據庫密碼 - DB_NAME=zai_base # 數據庫名稱 depends_on: postgres: condition: service_healthy db-init: condition: service_completed_successfully networks: - zai-network volumes: postgres_data: networks: zai-network: driver: bridge
請檢查 docker-compose.yml
的配置(含注釋),並根據需要調整下列配置:
确认所使用的 ZAI 服務版本
当前推荐的 ZAI 服務版本为 1.0.26。如需使用其他版本,请将 v1.0.26
替換爲目標版本號。
app: image: qihangnet/zai:v1.0.26 # 使用 v1.0.26 版本 container_name: zai
配置 ZAI 服務端口
ZAI 服務默认使用 8000 端口。如需在宿主机使用其他访问端口,请调整端口映射中前面的宿主机端口(格式为 宿主機:容器
):
app: ports: - "8000:8000" # 宿主机 8000 → 容器 8000
配置數據庫
ZAI 需要 PostgreSQL
数据库来存储数据。如果使用自建数据库,请删除 postgres
與 db-init
服務。无论是自建数据库还是 Docker 提供的
PostgreSQL 服務,都需要在 app
服務中配置數據庫连接信息,可通过以下环境变量設置:
app: environment: - DB_HOST=postgres # 數據庫主機地址,如果使用 docker compose 提供的 postgres 服務,则設置为 postgres - DB_PORT=5432 # 數據庫端口 - DB_USER=postgres # 数据库用戶名 - DB_PASSWORD=zai123456 # 數據庫密碼 - DB_NAME=zai_base # 數據庫名稱
環境變量說明:
變量名 | 描述 | 默認值 | 必需 |
---|---|---|---|
DB_HOST
|
數據庫主機地址 | localhost | ? |
DB_PORT
|
數據庫端口 | 5432 | |
DB_USER
|
数据库用戶名 | postgres | |
DB_PASSWORD
|
數據庫密碼 | (空) | ? |
DB_NAME
|
數據庫名稱 | dathor |
如不使用自建数据库(即使用 Compose 中的 PostgreSQL
服務),需在 postgres
與 db-init
中配置連接信息。在 postgres
服務中可通过如下环境变量設置:
postgres: environment: - POSTGRES_USER=postgres # 数据库用戶名 - POSTGRES_PASSWORD=zai123456 # 數據庫密碼 - POSTGRES_DB=zai_base # 數據庫名稱
第四步:安装并启动 ZAI 服務
首次安装需要拉取镜像,耗时取决于网络状况(可能需数分钟)。執行以下命令启动:
# 拉取最新镜像 docker-compose pull # 在后台运行 docker-compose up -d # 查看 app 进程的情况 docker-compose logs app
注:若使用 Docker Compose v2,请将命令中的 docker-compose
替換爲 docker compose
。
第五步:访问 ZAI 服務并初始化
ZAI 服務启动后,使用浏覽器打开 http://localhost:8000
。

首次訪問需創建管理員賬號。按照提示填寫管理員賬號與密碼即可完成創建。

此後可使用該賬號與密碼登錄系統。
升级 ZAI
当 ZAI 发布新版本后,进入 ZAI 服務目錄,按以下步骤进行升级:
第一步:停止现有服務
# 停止现有服務 docker-compose down
如果要刪除舊的容器和數據,可以添加 -v
參數:
# 停止并删除旧容器,危险! docker-compose down -v
第二步:更新 docker-compose.yml 文件
升級前,需要修改 docker-compose.yml
文件,將 image
的版本號替換爲新版本號。
app: image: qihangnet/zai:v1.0.26 # 使用 v1.0.26 版本
第三步:拉取最新鏡像並啓動
# 拉取最新镜像 docker-compose pull # 在后台运行 docker-compose up -d # 查看 app 进程的情况 docker-compose logs app
其他參考
- 配置和使用 ZAI 参加 ZAI 控制面板使用文檔;
- 在禅道中集成 ZAI 参见 禅道 AI 插件部署文檔。
-
禅道産品
禅道開源版 禅道企業版 禅道旗艦版 禅道IPD版 -
核心功能
産品管理 項目管理 質量管理 效能管理 -
使用文檔
基本版手冊 企業版手冊 旗艦版手冊 IPD版手冊 開發中心手冊 -
幫助中心
积分問答 常見問題 論壇交流 使用視頻 Gitee GitHub -
關于我們
關于我們 禅道軟件 最新動態 禅道活動 -
禅道社區
禅道博客 積分排行 積分商城 禅道書院 -
聯系方式
聯系人:楊苗 電話:13165050229 微信:13165050229 Q Q:2692096539北京、上海、深圳分部