禅道：一款国产开源的研发项目管理应用，由禅道软件（青岛）有限公司开发，集产品、项目、质量、DevOps、知识库等管理于一体，覆盖研发全生命周期，内置瀑布、敏捷、看板等模型，支持私有化部署，助力团队高效协同与流程闭环管理禅道。

支持看板、敏捷开发、传统的瀑布开发，适合小团队、中大型团队使用

工具特点：

• 国产开源，可私有部署，数据完全自主可控

• 一站式覆盖产品、项目、任务、测试、Bug、知识库研发全流程

• 同时支持敏捷 Scrum + 瀑布两种开发模式

• 需求、任务、用例、Bug 全链路关联追溯

• 自带完整测试管理：用例、测试计划、缺陷闭环

• 支持集成 Git/SVN、企业微信、钉钉，开放 API

• 自带效能报表、数据大屏，量化研发效率

• 轻量化易部署、上手简单，适配大小团队

项目地址：

禅道官网

禅道Github地址

免费支持以下数据库：

• MySQL 5.7+/8.0+

• MariaDB 10.3+

• SQLite（内置轻量文件库，仅适合测试 / 单机小数据）

Docker安装部署禅道

1、创建本地目录

mkdir -p /opt/zentao /opt/zentao/data
cd /opt/zentao

2、使用Docker命令行安装

docker run -d \
  --name zentao-v22.1 \
  -p 30081:80 \
  -v ./data:/opt/zentao \
  --restart unless-stopped \
  -e ZT_MYSQL_HOST=192.168.1.64 \
  -e ZT_MYSQL_PORT=3306 \
  -e ZT_MYSQL_USER=root \
  -e ZT_MYSQL_PASSWORD=123456 \
  -e ZT_MYSQL_DB=zentao \
  -e IS_CONTAINER="false" \
  -e PHP_MEMORY_LIMIT=512M \
  easysoft/zentao:22.1

3、Docker Compose配置

创建docker-compose.yml文件

vim docker-compose.yml

Docker Compose配置

version: '3'
services:
  zentao:
    image: easysoft/zentao:22.1
    #image: hub.zentao.net/app/zentao:22.1
    container_name: zentao-v22.1
    ports:
      - "30081:80"
    volumes:
      - ./data:/opt/zentao  # 持久化禅道数据
    restart: unless-stopped
    environment:
      ZT_MYSQL_HOST: 192.168.1.64  # 本地MySQL服务器IP,不能识别localhost、127.0.0.1等
      ZT_MYSQL_PORT: 3306
      ZT_MYSQL_USER: root
      ZT_MYSQL_PASSWORD: 123456  # 替换为实际密码
      ZT_MYSQL_DB: zentao  # 需提前创建的空数据库
      IS_CONTAINER: "false"  # 关键声明（非容器化数据库）
      PHP_MEMORY_LIMIT: 512M  # 性能优化参数
​

参数说明：

连接外部数据库地址，支持MySQL

      ZT_MYSQL_HOST: 192.168.1.64  # 本地MySQL服务器IP,不能识别localhost、127.0.0.1等
      ZT_MYSQL_PORT: 3306
      ZT_MYSQL_USER: root
      ZT_MYSQL_PASSWORD: 123456  # 替换为实际密码
      ZT_MYSQL_DB: zentao  # 需提前创建的空数据库

安装带数据库

services:
# db service for zentao
  zentao-db:
    image: mariadb:10.6
    container_name: zentao-db
    ports:
      - '3306:3306'
    volumes:
      - /data/zentao-mysql:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=pass4Zentao
      - MYSQL_DATABASE=zentao
    networks:
      - zentao-net
# zentao service
  zentao:
    image: hub.zentao.net/app/zentao:21.2
    container_name: zentao
    ports:
      - '30081:80'
    volumes:
      - /data/zentao-file:/data
    depends_on:
      - zentao-db
    environment:
      - ZT_MYSQL_HOST=zentao-db
      - ZT_MYSQL_PORT=3306
      - ZT_MYSQL_USER=root
      - ZT_MYSQL_PASSWORD=pass4Zentao
      - ZT_MYSQL_DB=zentao
      - PHP_MAX_EXECUTION_TIME=120
      - PHP_MEMORY_LIMIT=512M
      - PHP_POST_MAX_SIZE=128M
      - PHP_UPLOAD_MAX_FILESIZE=128M
    networks:
      - zentao-net
networks:
  zentao-net:
    driver: bridge

禅道工具使用

1、登录

1）使用http://服务器IP:30081登录禅道项目管理首页

2）初始化：

下一步

系统检查

生成系统配置，确认数据库配置、数据库表名格式、应用市区设置

设置账号，是否导入Demo数据

3）输入刚才登记的账号/密码，进入应用首页

2、后台管理

1）添加人员

2）配置权限

• 给用户配置权限

勾选上需要分配的权限，点击保存即可

3、创建项目

1）全生命周期还是轻项目管理？

管理模式选择，选择全生命周期还是轻项目管理

通过后台-系统设置-模式管理

轻管理模式 = 砍掉复杂流程，只留核心协作；

全生命周期 = 完整、严谨、端到端的研发管理闭环，适合不同规模与成熟度的团队

对比项	轻管理模式	全生命周期模式
核心	极简协作、结果导向	完整闭环、过程导向
团队规模	≤10 人、小团队	≥20 人、中大型团队
流程	灵活自由、无强制节点	标准严谨、全链路约束
功能	核心模块（产品 / 项目 / Bug）	全模块（含项目集、测试全流程、QA、DevOps、BI）
学习成本	低、1 小时上手	高、需系统学习
适用场景	初创、小项目、敏捷快速迭代	规范研发、IPD/CMMI、多项目并行

2）创建项目集

点击项目集列表右上角的添加项目集按钮，进入项目集添加的表单页

添加项目集的表单页：

创建项目集成功：

3）创建项目和添加产品

添加产品

点击产品列表右上角的添加产品按钮，进入产品添加页面

产品添加页面：

添加产品需求：

需求清单：

创建产品开发计划：

创建项目：

项目是产品还是项目驱动类型：

选择项目管理模式，项目看板、Scrum、融合敏捷

4、任务管理

1）创建和管理任务

添加冲刺/迭代：

分配和维护团队

创建任务：

任务分解：

工时管理

2）测试

点击版本列表操作栏的提交测试按钮，提交测试创建测试单

创建测试单页面：

查看测试用例：

3）看板

禅道看板功能内置任务看板、需求看板、缺陷看板等多类视图，支持按迭代、模块、人员、状态拖拽流转任务与需求缺陷，可视化展示研发进度、工作分配和阻塞情况，可自定义看板列、标签与筛选维度，能和项目、迭代、用例、Bug 深度关联

看板功能特点：

• 多类型内置看板：支持任务看板、需求看板、缺陷看板、迭代看板等，覆盖研发全场景

• 可视化拖拽流转：卡片可自由拖拽变更状态，操作直观，无需繁琐表单提交

• 自定义维度配置：可自定义看板列、泳道、标签、字段，按人员 / 模块 / 版本 / 优先级分组展示

• 全要素卡片信息：卡片展示标题、负责人、工时、优先级、状态、标签等关键信息，一目了然

• 深度业务关联：看板卡片可关联需求、任务、Bug、用例，点击直达详情，链路可追溯

• 多维度筛选检索：支持按迭代、模块、负责人、时间段、优先级快速筛选视图

• 进度实时统计：自带工时、完成率、未开始 / 进行中 / 已完成数量统计，直观把控迭代进度

• 适配敏捷流程：贴合敏捷迭代模式，支持迭代规划、每日站会、进度跟进场景

• 权限隔离管控：基于项目和人员权限，控制看板查看、编辑、拖拽操作权限

• 简洁轻量化界面：布局清爽，学习成本低，小团队到大团队都能快速上手使用

创建看板项目

5、文档管理

禅道文档管理是深度融入研发全流程的内置知识库

支持 Markdown、富文本、Office 多类文档编辑，按产品、项目、执行、接口及自定义库做树形分类归档，自带版本回溯、历史对比、全文检索和细粒度权限管控，还能和需求、任务、Bug 双向关联，既可沉淀 PRD、设计方案、测试报告、运维手册等研发资料，也能作为团队共享知识库，替代零散本地文件与网盘。

点击文档--我的空间--创建库的按钮，可以选择创建个人库