安装集成 分享链接

禅道大桌面由喧喧提供支持。喧喧是禅道软件（青岛）有限公司下另外一款安全的IM产品，支持私有部署，跨平台操作，内置大量插件，功能丰富。

禅道大桌面与禅道深度集成，支持需求、任务指派，成员沟通，小组讨论，文件传输，音视频会议，更加方便的项目管理，更加流畅的团队协作。

可观看视频了解操作详情：https://www.zentao.net/redirect-index-21795.html

禅道大桌面集成的简单流程：

1、禅道管理员在后台--聊天--参数设置里配置客户端的服务器（xxd）配置。

一、 配置禅道大桌面服务器参数

以 Windows 64位一键安装包为例。

点击ZenTao.exe程序启动禅道。

使用windows一键安装包安装的禅道，需要打开xampp/start.exe程序，将集成面板左下角的apache验证取消勾选。

确认下xampp/runner/res/apache/conf/httpd.conf配置文件中，是否存在x.php的配置文件。如果不存在，需要添加如下内容。

  <Files "x.php">
    SetHandler application/x-httpd-php
  </Files>
  <Files "ux.php">
    SetHandler application/x-httpd-php
  </Files>

检查好后，去“后台”-“系统设置”-“首页”进行参数设置。

注意：禅道服务器地址为完整的协议+地址+端口，如http://192.168.1.35 或 http://pms.zentao.com ，不能使用127.0.0.1。

• 禅道的客户端集成默认是开启的状态。

• 密钥是随机生成的32位密码，需要与禅道客户端的服务器里的配置保持一致。

• 上传文件大小默认是20M，可以根据实际使用需要调整。

• 是否启用https，默认是不启用。启用后，需要把https证书的内容和密钥复制粘贴到输入框了。

二、下载和运行禅道大桌面的服务器

设置好禅道大桌面参数后，会出现下载客户端服务器的按钮。

注：

• 选择操作系统，目前支持 Windows 32位，Windows 64位，Linux 32位，Linux 64位，macOS系统。
• 如果之前已下载过喧喧服务端，那么可以只下载配置文件。配置文件为xxd.conf，下载成功后替换掉原喧喧服务器端里的同名文件即可。替换后需要重启服务器端服务。

以下载windows64位服务端为例：将下载后得到文件中包含之前在“后台”-“客户端”下所做的配置参数。

如在config/xxd.conf文件中，可以修改上传文件大小的设置。

双击目录中的 xxd.exe ，即可启用服务器端的服务。

说明：

禅道大桌面的服务器端（xxd）

• 禅道和 xxd在同一服务器：登录禅道客户端时，服务器地址写禅道访问地址也没问题。
• 禅道和 xxd不在同服务器：登录禅道客户端时，服务器地址必须写 xxd 的监听地址。
• xxd 的监听地址为内网地址，但连接时要用外网IP连接。 登录禅道客户端时，服务器地址要写外网地址。
• xxd 安装在云主机外网时，一定要在防火墙开放11444和11443的监听端口访问。

禅道大桌面的服务器端(xxd)推荐放置位置

• 源码方式安装的禅道，推荐把 xxd 放到与禅道并行的目录，执行 ./xxd 即可启动运行禅道大桌面的服务器端服务（xxd）。

• Windows一键安装包方式安装的禅道，可以在禅道“后台”-“聊天”-“参数设置"中只下载配置文件xxd.conf，然后覆盖原目录里的 xampp/xxd/config 即可。启动 xxd 服务，直接点击禅道运行控制面板里的“启动聊天服务”即可。

  

• Linux 一键安装包安装的禅道，可以在禅道“后台”-“聊天”-“参数设置"中只下载配置文件xxd.conf，然后覆盖原目录里的  /opt/zbox/run/xxd/config 即可。 

三、安装和登录禅道大桌面

超级管理员在后台配置了大桌面服务器端后，才会出现“下载大桌面”的入口。 

内网环境需要手动将禅道大桌面的安装包放到服务器指定目录下，这样其他用户才可以通过“下载大桌面”入口下载禅道大桌面，操作可参见 4.内网环境下载禅道大桌面。

禅道地盘首页点击个人头像-“大桌面”-“下载大桌面”。

选择操作系统，点击“保存”，进入下载页面。

禅道大桌面下载成功后，解压得到zentao_chat_client.win64文件夹。进入 zentaoclient 目录，双击 zentaoclient.exe 即可启动禅道大桌面。

点击“”显示服务器设置“。

注：

• 服务器填写的是客户端服务器端设置文件（xxd.conf）里的服务器地址。
• 如果没有单独修改xxd配置文件中的默认端口号，服务器地址后面 不需要加端口。 例如：禅道在网页端访问地址为http://192.168.1.110:8080，在大桌面的服务器填写http://192.168.1.110就可以了。
  
• 账号和密码，填写的是禅道里添加的用户名和密码。

客户端登录失败排查

1. 请先逐一排查禅道、禅道大桌面、禅道大桌面服务器端（xxd）是否都正常运行。
2. 禅道、禅道大桌面、禅道大桌面服务器端（xxd）都运行正常的话，需要检查禅道大桌面服务器端的xxd.conf的配置。 服务器名是否写对，密钥是否一致，是否加上了default。
3. 禅道大桌面登录页面提示：服务器操作失败，提示500错误。请先到“后台”-“聊天”-“参数设置”里查看服务器配置里是否是打开状态。

四、内网环境下载禅道大桌面

内网环境可以先从官网手动下载禅道大桌面，然后放到指定的服务器目录下，其他用户就可以通过点击个人头像-“大桌面”-“下载大桌面”直接下载客户端了。

在禅道官网下载对应操作系统的安装包。