升级 HelpChat Server 12

从 HelpChat Server 12 升级到 13 的完整步骤，包括数据迁移、配置映射和注意事项。

升级前必读

升级前请先停止 Server 12，并备份整个 Server 12 目录和数据库。13 会将数据库中所有名为 order 的字段重命名为 rorder，此变更不可逆，12 将无法再读取被 13 升级过的数据表。

Windows Server 升级步骤

HelpChat Server 13 支持 Windows Server 2008 至 2025。以下假设：

text

12 服务端目录：C:\HelpChat Server 12\
13 服务端目录：C:\HelpChat Server 13\

一、迁移聊天数据

将 12 的 imdata\ 下的 data 子目录复制到 13 的 imdata\ 目录中。

二、迁移头像文件

将 12 的 public\ 下的 groups 和 users 子目录复制到 13 的 public\ 目录中。

三、修复头像文件扩展名

版本 12 头像文件没有扩展名，版本 13 要求 .png 扩展名。双击运行以下两个目录中的 add_png_ext.bat：

text

C:\HelpChat Server 13\public\groups\add_png_ext.bat
C:\HelpChat Server 13\public\users\add_png_ext.bat

四、迁移服务器 ID

打开 12 的 config\serverid.dat，将对应值填入 13 的 config\helpchatsvr.ini：

serverid.dat（12）	helpchatsvr.ini [server]（13）
id=xxx	id_office = xxx
idex=xxx	id_market = xxx

注意

服务器 ID 必须与 12 一致，否则客户端无法识别服务器。

五、迁移数据库配置

打开 12 的 config\mysql.ini，将对应值填入 13 的 config\helpchatsvr.ini：

mysql.ini（12）	helpchatsvr.ini（13）	所在段
host=xxx	host = xxx	[database]
port=xxx	port = xxx	[database]
user=xxx	user = xxx	[database]
pswd=xxx	password = xxx	[database]
db=xxx	db_office = xxx	[database]
dbex=xxx	db_market = xxx	[database]
charset=xxx	charset = xxx	[database]
runmode=xxx	run_mode = xxx	[runtime]
threads=xxx	worker_threads = xxx	[runtime]

注意

注意将 [database] 段的 type 从 sqlite 改为 mysql。

六、启动验证

启动 HelpChat Server 13

启动服务端程序。

客户端登录验证

确认账号和历史消息正常。

检查头像显示

确认群组和用户头像显示正常。

Linux Server 升级步骤

以下假设：

text

12 服务端目录：/opt/HelpChatServer12/
13 服务端目录：/opt/HelpChatServer13/

一、迁移聊天数据

bash

cp -r /opt/HelpChatServer12/imdata/data /opt/HelpChatServer13/imdata/

二、迁移头像文件

bash

cp -r /opt/HelpChatServer12/public/groups /opt/HelpChatServer13/public/
cp -r /opt/HelpChatServer12/public/users  /opt/HelpChatServer13/public/

三、修复头像文件扩展名

bash

cd /opt/HelpChatServer13/public/groups/ && chmod +x add_png_ext.sh && ./add_png_ext.sh
cd /opt/HelpChatServer13/public/users/  && chmod +x add_png_ext.sh && ./add_png_ext.sh

四、迁移服务器 ID

与 Windows 相同，将 12 的 config/serverid.dat 中的 id 和 idex 填入 13 的 config/helpchatsvr.ini 的 [server] 段。

五、迁移数据库配置

与 Windows 相同，将 12 的 config/mysql.ini 中的各项填入 13 的 config/helpchatsvr.ini，参见上方映射表。

六、启动验证

bash

cd /opt/HelpChatServer13
sudo ./helpchatsvr start

客户端登录，确认账号、历史消息和头像显示正常。

注意事项

13 使用的端口与 12 相同，启动 13 前务必确认 12 的服务已完全停止，否则会端口冲突导致启动失败。

如果 13 继续使用 12 的 MySQL 数据库，停止 12 的服务时，请确保 MySQL 服务保持运行中。

建议

如果是全新部署，建议安装 MySQL 8.0 或 MariaDB 10.6+ 作为数据库，相比 12 中默认的 MySQL 5.7，性能和稳定性都有显著提升。

如果在线人数在 50 人左右，可以直接使用 SQLite，无需安装任何数据库，开箱即用。