1. 安装喧喧服务器和客户端
1.1. 喧喧 10.x 版本
1.1.1. 安装服务端
1.1.1.1. 一键安装包
1.1.1.1.1  Windows一键安装包安装
1.1.1.1.2  Linux一键安装包安装
1.1.1.2. 手动安装
1.1.1.2.1  Windows系统安装XXD
1.1.1.2.2  Linux系统安装XXD
1.1.2. 安装客户端
1.1.2.1  Windows系统安装XXC
1.1.2.2  macOS系统安装XXC
1.1.2.3  Linux系统安装XXC
1.1.3. 安装移动端
1.1.3.1  安卓手机安装移动端
1.1.3.2  苹果手机安装移动端
1.1.4  安装Jitsi音视频服务端
1.1.5  安装Office服务端
1.2. 喧喧 9.x 版本
1.2.1. 安装服务端
1.2.1.1. 一键安装包
1.2.1.1.1  Windows一键安装包安装
1.2.1.1.2  Linux一键安装包安装
1.2.1.2. 手动安装
1.2.1.2.1. 安装后端处理服务器(XXB)
1.2.1.2.1.1  源码包安装XXB(系统通用)
1.2.1.2.1.2  宝塔Nginx安装XXB
1.2.1.2.1.3  安装ionCube扩展
1.2.1.2.2. 安装消息中转服务器(XXD)
1.2.1.2.2.1  Windows系统安装XXD
1.2.1.2.2.2  Linux系统安装XXD
1.2.1.2.3  使用禅道作为后端处理服务器
1.2.2. 安装客户端
1.2.2.1  Windows系统安装XXC
1.2.2.2  macOS系统安装XXC
1.2.2.3  Linux系统安装XXC
1.2.3. 安装移动端
1.2.3.1  安卓手机安装移动端
1.2.3.2  苹果手机安装移动端
1.2.4  安装Jitsi音视频服务
1.2.5  安装Office服务端
1.2.6  CentOS/Ubuntu下安装Docker
1.2.7  防火墙开启喧喧使用端口
1.3. 喧喧 7.x 版本
1.3.1. 一键安装包
1.3.1.1  Windows一键安装包安装
1.3.1.2  Linux一键安装包安装
1.3.2. 手动安装
1.3.2.1. 安装后端处理服务器(XXB)
1.3.2.1.1  源码包安装XXB(系统通用)
1.3.2.1.2  宝塔Nginx安装XXB
1.3.2.1.3  安装ionCube扩展
1.3.2.2. 安装消息中转服务器(XXD)
1.3.2.2.1  Windows系统安装XXD
1.3.2.2.2  Linux系统安装XXD
1.3.2.3. 安装桌面客户端(XXC)
1.3.2.3.1  Windows系统安装XXC
1.3.2.3.2  macOS系统安装XXC
1.3.2.3.3  Linux系统安装XXC
1.3.2.4  使用禅道作为后台
1.3.3  CentOS/Ubuntu下安装Docker
1.3.4  浏览器端安装客户端
1.3.5  防火墙开启喧喧使用端口
1.3.6  安装Office服务端
1.3.7. 安装音视频服务
1.3.7.1  安装OWT音视频服务端
1.3.7.2  安装SRS音视频服务端
2. 升级喧喧服务器和客户端
2.1. 升级喧喧服务端
2.1.1. 升级到 10.x 版本
2.1.1.1. XXD升级
2.1.1.1.1  XXD包升级(系统通用)
2.1.1.1.2  Windows 一键安装包升级
2.1.1.1.3  Linux 一键安装包升级
2.1.2. 升级到 9.x 版本
2.1.2.1. XXB升级
2.1.2.1.1  源码包升级XXB(系统通用)
2.1.2.1.2  Windows 一键安装包升级XXB
2.1.2.1.3  Linux 一键安装包升级XXB
2.1.2.2  XXD升级
2.2  升级喧喧客户端
2.3  升级喧喧浏览器端
3  常见错误处理

Windows一键安装包安装

2026-01-21 11:18:34
张玉洁
227
最后编辑:张玉洁 于 2026-01-23 11:10:55
分享链接

一 、部署前的准备

1.1、服务器配置要求

5000人以下企业可参考如下标准来准备服务器的软硬件环境:

硬件建议配置要求:

1、xxb服务器配置:内存:windows:16G+cpu(8核+); 

2、xxd服务器配置:内存:windows:16G+cpu(8核+)、硬盘和带宽主要看贵公司上传的图片和附件的数量和大小。 

3、音视频服务器配置:内存:cpu(8核+):16GHz+,带宽尽可能大(音频会议大约每人占用0.5Mbps、音视频会议大约每人占用1Mbps带宽,建议带宽8Mbps+)。

不建议更低的服务器配置,过低的配置会影响服务性能,会对稳定性有一定程度的影响。

1.2、服务器网络环境要求

我们推荐的网络环境如下:

 

方案一

选择具备公网 IP 地址的服务器,客户端可通过公网访问喧喧。

方案二

企业只允许内网访问,服务器无法连接外网,所有客户端只能在企业的内网访问。

二、下载解压并配置windows一键安装包

2.1、下载和启动一键安装包

在官网下载windows一键安装包(.exe结尾) ,下载后, 双击解压到某个盘符的根目录下 ,得到一个zbox文件夹,如D:\zbox,打开zbox文件,双击喧喧启动后端服务。

喧喧后端服务启动成功后,会提示数据库密码太弱,建议修改密码,您可按需修改数据库密码。

注:Windows 的服务器是安装包,建议将服务安装在 D 盘上,不建议安装在系统盘 C 盘上。

 

2.2.访问后台

点击访问喧喧后台,进入喧喧后台的登录页面。后台的默认登录用户名 admin,密码123456 。


  

 

 

以下是登录成功后的喧喧后端处理服务器的后台首页

 


2.3、修改静态资源IP

:静态资源指的是系统中存储的图片、附件、文件等资源,这些资源在用户访问时需要从服务器加载。为了确保这些资源能被用户正确访问,我们需要设置服务器的IP地址。因为 如果只是用 127.0.0.1,意味着只允许本地访问,无法从外网或内网其他设备访问。设置正确的IP地址后,系统就知道“这些资源应该从哪个服务器地址获取”。


下面是修改静态资源IP的方法:

  • 编辑zbox/bin/xxd/config/xxd.conf文件,将serverHost修改为服务器可被访问的IP地址,例如110.10.10.96

  • 然后重启xxd服务


2.4、导入授权文件

安装完成后需要导入授权文件才能正常使用,授权文件获取方式:

  • 联系喧喧商务获取授权, 联系电话:18553229903
  • 注册 喧喧官网获取授权,在 个人中心 开发服务-授权中申请授权文件,审批通过后可直接在官网原地址下载授权文件。


下载后会获得一个 xuanxuan.用户名.zip 的一个压缩包。不清楚授权操作细节的可阅读这个文档: https://www.xuanim.com/book/about-xuanim/218


导入授权文件的方式有两种:

  • 解压后把 license 目录文件覆盖到 zbox/bin/xxd/site/config/license 目录下即可。
  • 喧喧后台首页底部点击替换授权,弹出替换授权弹窗,选择授权压缩包替换授权即可。


2.5、服务器防火墙端口设置

安装完成后,如果服务器或者网络硬件设备有防火墙,需要进行以下操作:

控制面板中选择windows防火墙;点击左侧的“高级设置”选项;设置入站规则,点击“新建规则”,点选“端口”,单击 “下一步”;选择相应的协议,如添加11443端口,我们选择TCP,在本地端口处输入11443;允许连接,点击下一步;勾选“域”,“专用”,“公司”,点击“下一步”;输入端口名称,点“完成”即可。( 需要开放11443 和11444端口)

如果服务器使用的是阿里云ECS,需要注意查看服务器所属安全组策略中是否开启了喧喧相应端口。参照以下截图设置:

喧喧后台配置服务器防火墙端口 

 

后台功能的使用,如有不清楚的可以阅读这个文档,https://www.xuanim.com/book/xxbservice/186.html。

三、下载喧喧客户端

我们推荐使用喧喧服务端部署包来安装下载,用户登录喧喧后台,从客户端下载区块来下载客户端使用。

管理员可以直接选择下载客户端进行下载,其他同事可以通过复制下载链接,按照下载链接地址直接下载即可。

 

四.登录喧喧客户端

下载喧喧客户端后,安装并进入客户端登录窗口,填写服务器地址和用户帐号密码。

 

成功登录:

五、移动端客户端的下载和安装

5.1移动客户端下载

安卓手机下载手册:https://www.xuanim.com/book/xuanxuanserver/andriod-download-409

苹果手机下载手册:https://www.xuanim.com/book/xuanxuanserver/iOS-download-410

发表评论
评论通过审核后显示。
获取方案 获取方案
联系我们
社群交流