-
1. 关于喧喧
- 1.1 关于喧喧聊天软件
- 1.2 喧喧的主要功能
- 1.3 喧喧的使用授权说明
- 1.4 喧喧技术架构实现方案
- 1.5 如何获得技术支持
-
2. 安装喧喧服务器
-
2.1. 集成安装
- 2.1.1 集成安装(推荐)
- 2.1.2 Windows 一键安装包
-
2.2. 手动安装
-
2.2.1. 安装后端处理服务器(XXB)
- 2.2.1.1 源码包安装XXB(系统通用)
- 2.2.1.2 Linux 一键安装包安装
- 2.2.1.3 宝塔Nginx安装XXB
- 2.2.1.4 安装 ionCube 扩展
- 2.2.2 使用禅道作为后端处理服务器
- 2.2.3 使用 ZDOO 协同作为后端处理服务器
-
2.2.4. 安装消息中转服务器(XXD)
- 2.2.4.1 Windows 系统安装XXD
- 2.2.4.2 Linux 系统安装XXD
-
2.2.1. 安装后端处理服务器(XXB)
-
2.3. 安装桌面客户端(XXC)
- 2.3.1 Windows 系统安装XXC
- 2.3.2 macOS 系统安装XXC
- 2.3.3 Linux 系统安装XXC
- 2.4 CentOS / Ubuntu 下安装 Docker
- 2.5 安装音视频服务端
- 2.6 安装 SRS 音视频服务端
- 2.7 安装Jitsi音视频服务端
- 2.8 浏览器端安装客户端
- 2.9 防火墙开启喧喧使用端口
- 2.10 安装 Office 服务端
-
2.1. 集成安装
-
3. 升级喧喧服务器和客户端
-
3.1. 升级后端处理服务器
-
3.1.1. XXB升级
- 3.1.1.1 源码包升级XXB(系统通用)
- 3.1.1.2 Windows 一键安装包升级XXB
- 3.1.1.3 Linux 一键安装包升级XXB
- 3.1.2 禅道升级
- 3.1.3 ZDOO协同升级
-
3.1.1. XXB升级
- 3.2 升级消息中转服务器(XXD)
- 3.3 升级喧喧客户端
- 3.4 升级喧喧浏览器端
-
3.1. 升级后端处理服务器
- 4 常见错误处理
常见错误处理
- 2020-03-23 17:32:13
- 孙浩
- 58332
- 最后编辑:孙浩 于 2020-03-23 13:59:45
- 分享链接
客户端错误
当用户登录或进行网络诊断时,会给出对应的错误信息。
USER_INVALID
用户信息不可用。
建议:
- 请检查登录所使用的服务器地址、账号和密码信息是否正确;
CLIENT_REQUIRE_UPDATE
客户端版本太低,需要进行升级后才能登入系统。
建议:
- 请从官方网站获取客户端最新版本进行部署使用;
NET_OFFLINE
无法连接到网络。
建议:
- 确保当前设备已经连接到网络
- 检查是否打开了飞行模式,如果已经打开请关闭飞行模式
- 检查网络代理是否设置正确
- 检查网卡设备工作正常
NET_PING_FAIL
ping 操作失败。
建议:
- 确保主机名或域名可以正常使用;
- 检查服务器上的防火墙设置,允许客户端访问对应的主机名;
- 如果所使用的域名是刚刚进行解析的,你可能需要等待一段时间才能够生效;
- 确保主机名或域名指向的服务器已经启动并可以正常访问。
NET_TRACEROUTE_ERROR
Traceroute 错误。
建议:
- 确保主机名或域名可以正常使用;
- 检查服务器上的防火墙设置,允许客户端访问对应的主机名;
- 如果所使用的域名是刚刚进行解析的,你可能需要等待一段时间才能够生效;
- 确保主机名或域名指向的服务器已经启动并可以正常访问。
NET_LOOKUP_FAIL
无法解析域名。
建议:
- 确保域名可以正常使用;
- 如果所使用的域名是刚刚进行解析的,你可能需要等待一段时间才能够生效;
SERVER_VERSION_NOT_SUPPORT
当前客户端不支持所连接服务器版本,需要更高的服务器版本。
建议:
- 请从官方网站获取服务器最新版本进行部署使用;
SERVER_VERSION_UNKNOWN
未知的服务器版本。
建议:
- 请确保你的服务器是从官方渠道获取;
SOCKET_CLOSED
服务器意外断开了 Socket 连接。
建议:
- 检查 XXD 是否正常运行;
- 确保 XXD 服务器上的端口可用;
SOCKET_CLOSE_ABNORMAL
无法建立 Socket 连接,可能当前网络不可用。
建议:
- 检查 XXD 是否正常运行;
- 确保 XXD 服务器上的端口可用;
SOCKET_TIMEOUT
Socket 请求超时。
建议:
- 请检查发送到服务器的数据包被当前版本支持;
- 如果你确定是一个错误,请记录错误发生前后的操作并反馈给我们;
HTTP_STATUS_401
验证失败,账号名称或密码不正确。
建议:
- 请填写正确的用户名或密码,如果你忘记密码,请联系管理员登录 XXB 后端管理界面进行修改;
HTTP_STATUS_402
用户被暂时禁用,请稍候再试。
建议:
- 通常暂时被禁用的账户会在 10 分钟之后恢复正常,请稍后再进行登录操作;
- 如果你想立即访问你的账户,请联系你的管理员登录 XXB 后端用户管理界面进行解禁;
HTTP_STATUS_403
用户被永久禁用,请联系管理员。
建议:
- 请联系你的管理员登录 XXB 后端用户管理界面进行解禁;
HTTP_STATUS_405
后端服务器授权失效,请联系管理员。
建议:
- 如果你是管理员,请访问 https://www.xuanim.com/license-browse.html 获取授权;
HTTP_STATUS_500
服务器处理请求错误。此时应该从 XXD 返回具体的错误信息给 XXC。
建议:
- 检查 XXB 是否可以正常访问;
- 确保 mysql 数据库已经启动并允许 XXB 访问;
HTTP_STATUS_ERROR
服务器操作失败。
建议:
- 检查 XXB 是否可以正常访问;
- 确保 mysql 数据库已经启动并允许 XXB 访问;
HTTP_ECONNREFUSED
访问 URL 时被拒绝。
建议:
- 检查是否已经启动 XXD 服务器;
- 检查端口是否正确。
HTTP_ETIMEDOUT
访问 URL 时超时。
建议:
- 确保主机名或域名可以正常使用;
- 检查服务器上的防火墙设置,允许客户端访问指定的主机名或端口;
- 如果所使用的域名是刚刚进行解析的,你可能需要等待一段时间才能够生效;
- 确保主机名或域名指向的服务器已经启动并可以正常访问。
HTTP_REQUEST_FAIL
无法连接到服务器,请检查网络连接是否通畅。
建议:
- 检查请求地址所指向的域名或 IP 是否正确。
HTTP_DATA_ERROR
服务器返回的数据不正确。
建议:
- 请检查 XXD 服务器是否运行正常;
- 检查 XXB 是否可以正常访问;
- 确保 mysql 数据库已经启动并允许 XXB 访问;
XXD 输出报错
XXD 在遇到导致不能启动的错误时,会在控制台输出错误。
E_NO_SERVER
配置文件中没有可用的 XXB 配置。
建议:
- 修改 config/xxd.conf 中的[backend]段,添加可用的 XXB 配置。
E_BAD_RESPONSE
XXB 返回值无法被解析。
建议:
- 检查 XXB 是否正常运行,以及检查 XXB 与 XXD 版本是否一致。
E_PORT_UNAVAILABLE
XXD 无法监听配置中指定的端口。
建议:
- 检查端口是否被占用,解决占用,或修改配置使用别的端口。
E_IP_UNAVAILABLE
XXD 无法监听配置中指定的 IP 地址。
建议:
- 修改配置使用本机拥有的 IP 或0.0.0.0。
微信公众号
[I] XXD v8.0.3 built at 2024-04-11 11:28:25 on commit 35aa347 is running
[I] XXD runs the directory /opt/zbox/run/xxd
[I] System: linux-amd64
----------------------------------------
[InitHttp] E_BAD_RESPONSE: Unable to perform handshake with backend server.
Visit https://www.xuanim.com/book/xuanxuanserver/238.html#E_BAD_RESPONSE for troubleshooting hints.
Press Ctrl+C to exit this program
Socket 请求超时。
请检查发送到服务器的数据包被当前版本支持;
如果确定是一个错误,请记录错误发生前后的操作,添加页面右边QQ,邀请进群反馈给我们。