私有化项目协作工具新手入门指南：从建项目到团队协同

从建一个项目到团队真正协同起来，中间隔着部署、搭结构、配权限几道坎。这篇指南按落地顺序讲清私有化项目协作工具怎么装、怎么建第一个项目、怎么把成员和权限理顺，最后给出判断跑没跑通的标准，面向准备在内网自建项目管理环境的中小研发团队。

为什么团队会把项目协作工具放到内网

很多团队第一次选协作工具，都是从在线试用开始的。等真正落到日常研发，问题才浮出来：需求、缺陷、代码提交记录都集中在别人的服务器上，安全部门过不了；业务部门想按自己的流程改审批节点，SaaS 版本改不了。

私有化项目协作工具的核心差别不是功能多少，而是数据和服务放在哪里。 工具装在企业自己的服务器或内网里，数据不出内网，权限、加密、访问控制可以按企业既有策略来配，流程定制和内部系统对接也更容易。

禅道是国产开源项目管理软件，集产品管理、项目管理、质量管理、文档管理、组织管理和事务管理于一体，同时提供私有化部署和云部署两种方式，私有化部署可以在一台内网服务器上跑起来。私有化部署的典型特点是完全控制、数据留在自有环境、支持灵活定制。

哪类团队更适合走私有化：

• 数据不能出内网，比如测试数据、客户信息、涉密项目
• 有信创或合规要求，需要跑在国产操作系统、国产数据库上
• 已有运维体系，希望把工具纳入统一的备份、监控、升级流程
• 需要深度定制流程、字段和集成方式

反过来，十来个人、没有专职运维、只想先看效果的团队，云部署更省事。私有化的代价是服务器、备份和升级都得自己负责。

部署前要准备什么：环境、安装方式与首次登录

装之前先把三件事定下来，后面能少返工。

服务器、地址端口与访问方式

• 一台能长期运行的内网服务器（物理机或虚拟机），单独一台，不和办公电脑混用
• 规划访问地址和端口，例如 http://192.168.1.35，团队用固定 IP 或内网域名访问
• 确认服务器防火墙、云服务器安全组放行实际使用的端口；网页打不开时先查防火墙和 SELinux
• 定好备份目录和备份节奏，私有化之后数据安全由你负责

四种安装方式怎么选

以 Linux 一键安装包为例，把带 zbox 集成环境的安装包解压到 /opt 目录，执行 /opt/zbox/zbox start 启动 Apache、MySQL 等服务，用 /opt/zbox/zbox check 检查状态，停止和重启分别是 /opt/zbox/zbox stop 与 /opt/zbox/zbox restart，端口也可以用 --aport、--mport 参数调整。安装包在禅道的下载页获取，命令以安装包内说明和官方文档为准，不同版本可能略有差异。

有两个细节容易出错：不要解压到别的目录再拷贝到 /opt，否则文件所有者和读写权限会变；也不要图省事把整个目录设成 777。

首次登录后先做三件事

浏览器打开 http://服务器IP:端口 就能进入登录页。一键安装包的默认管理员账号是 admin，密码是 123456，登录后第一件事就是改掉这个密码。 接着核对系统时区和语言，在后台确认公司名称等基础信息。还要注意服务器地址要写完整的协议加 IP 加端口，不能用 127.0.0.1，否则客户端和消息通知会连不上。

建第一个项目：产品、项目、执行三层怎么切

禅道的核心结构是项目集、产品、项目、执行四层，管理思路上融合了 Scrum、看板、瀑布等主流模型。新手最容易踩的坑，是把所有东西塞进一个项目，结果需求一变、任务就乱，缺陷也说不清归属。

先用产品、项目、执行三层把「做什么、这次交付什么、谁在什么时候做完」分开，后面会顺很多。

• 产品层：管「做什么」，产品规划与需求管理都在这一层，需求挂在这里，按产品线或业务模块划分
• 项目层：管「这次交付什么」，项目关联产品需求，形成一次迭代或一个版本的交付范围
• 执行层：管「谁在什么时候做完」，任务和缺陷挂在执行下，直接对应到人

最小操作顺序如下，以 21.x 版本界面为例，不同版本的菜单名称可能略有差异：

1. 建产品。在产品页面创建产品，填名称和描述，例如「某业务系统 V2.0」。
2. 录需求。进入产品下的需求列表，创建需求，写清功能点和预期效果，保存后可以发起评审。
3. 建项目。在项目页面创建项目，填名称、起止时间，在关联产品处勾选刚建的产品。任务工时、甘特图和燃尽图这类项目管理能力都在这一层。
4. 建执行。在项目下新建迭代或阶段，把这次要做的事放进执行里。

到位信号：产品列表里能看到需求，项目详情里能看到已关联的产品需求，执行下能看到对应工作项，三者能互相点到，说明结构搭对了。

把团队拉进来：成员、角色与权限怎么配

工具装好了、项目建好了，如果只有你一个人能看见，协同还没开始。这一步分两处配：后台管人，项目管团队。

后台：先建部门，再加用户

在组织视图里先搭部门和用户，把人和组织关系建起来。用户属于哪个部门，会决定后续权限分组的批量维护方式，所以这一步建议在建项目之前做。

权限：视野、权限、成员三项一起看

权限在后台的人员管理下，按权限分组设置。每个分组有三个关键入口：

• 视野维护：这个分组能看到哪些视图，以及能访问哪些项目集、产品、项目、执行。不勾选具体对象代表没有访问限制，勾了才代表限定在这些对象内。
• 权限维护：分组能执行哪些具体操作。这里还有「依赖的权限」和「推荐的权限」提示，避免开了功能却因为缺依赖项用不了。
• 成员维护：把用户加进分组，也可以直接复制分组，快速创建权限相近的开发组、测试组。

此外，产品、项目集、项目、执行各自还有访问控制，可以设为公开、私有或访问白名单，用来隔离不同层级的数据。

项目内：添加团队成员与角色

在项目的团队里添加成员并设定角色，成员才能进入这个项目的任务、缺陷和看板。后台权限决定「能不能用」，项目团队决定「在这个项目里是谁」。

新成员先给受限用户

新同事对流程不熟，直接给全套权限容易误操作。禅道内置了「受限用户」分组：这类用户只能编辑与自己相关的需求、任务、缺陷，不能新增。 熟悉之后再放开。它还支持只在某个项目或某个迭代内受限，其他项目不受影响，很适合新人过渡期。

到位信号：让一位成员登录，他能看到被授权项目里的任务和缺陷，看不到没授权的视图；受限用户在新增需求时被拦下。

跑通协同：需求、任务、缺陷怎么串起来

结构有了、人进来了，接下来是让数据真正流动起来。禅道用需求池、需求、任务、缺陷、用例、代码、反馈、工单八个核心概念串起研发流程：需求池收集潜在需求，评审后分发到产品规划，研发中转化为任务执行、转化为用例验证，用例执行失败可转为缺陷，缺陷再通过任务解决。

一个新项目最小可用的流转：

1. 需求评审后激活。需求先写成草稿，评审通过后设为激活，才算正式进入排期。
2. 拆任务并指派。从需求拆出可交付的任务，写清负责人和截止时间。一个需求可以拆成多条任务，任务有独立责任人和工时。
3. 缺陷闭环。测试人员提交缺陷管理中的缺陷，指派给对应开发，修完流转回测试验证，通过后再关闭。缺陷能关联到需求，方便回溯。
4. 用看板和图表跟进度。任务列表看当日工作量，看板看整体流动，甘特图和燃尽图看排期与趋势。

日常协同里还有两个顺手的地方：项目文档放进文档管理，需求、任务、缺陷都能关联文档，减少在群里翻聊天记录；站会直接打开看板过一遍，比口头汇报准确。

怎么判断跑通了，以及新手最容易踩的坑

判断标准不用复杂，能回答下面三个问题就算跑通：

• 一条需求能追溯到它拆出的任务和产生的缺陷吗
• 每位成员登录后看到的内容，是否符合他的角色
• 迭代结束时，能说清这个版本交付了哪些需求吗

新手常见的坑，按出现频率排：

• 把三层揉成一层。 所有需求、任务、缺陷都塞进一个项目，需求一变全乱，历史记录也断了。
• 只给权限不给视野。 功能权限开了但视图没放开，成员登录后看不到入口，以为账号有问题。
• 默认密码没改。 admin / 123456 装完就用，内网也不安全。
• 安装环境不注意。 解压到带中文或空格的路径、解压后再拷到 /opt、目录直接设 777，都会引发启动或权限问题。
• 忘了备份。 私有化意味着数据安全、升级回滚都要自己负责，备份策略要在上线前定好。

不用一次把所有功能配齐。先拿一个真实项目跑完一个迭代，按上面的标准验证一遍，再逐步加权限分组、加流程。工具本身不难，难的是让流程先跑通。