部署 助讯通 Linux ( Ubuntu Server ) 服务器

请准备一台 Ubuntu Server 的 VPS 或 物理主机 服务器
操作系统及数据库 推荐版本：Ubuntu Server 18.04 / MySQL Server 5.7.31 ~ 8.1

首先请在以下 助讯通 HelpChat 官网页面，下载 Linux 服务端的压缩包

https://www.helpchat.com/download

如下图，在官网下载页面，找到 Linux Server 的下载区域

在以下红色方框范围，鼠标右键点击，在弹出的菜单中，点击 复制下载地址 子菜单，即可得到 Linux 服务器的下载地址

1. 下载服务端并执行文件可执行权限

1. 在根目录建立 helpchatsvr 文件夹，并进入 helpchatsvr 文件夹，例如：

cd \
mkdir helpchatsvr
cd helpchatsvr
 
 
请先到官网下载页面，复制 Linux 服务端 下载地址，并用以下命令下载，比如：
 
wget https://www.helpchat.cn/file/12.2.3/HelpChat_Server_Linux_x64_12.2.3.zip
 
解压缩：
 
unzip HelpChat_Server_Linux_x64_12.2.3.zip

若以下命令提示找不到 wget 或 unzip 命令，请先执行以下命令

apt-get install wget unzip -y

在解压后的目录中运行以下命令即可：

chmod 777 *.sh hc* ./ffmpeg/* ./bin/*

给予指定文件可执行权限后，再执行 ls -lh 时显示如下：
可执行文件的颜色变成绿色了

2. 安装并配置 数据库 MySQL Server

sudo apt install mysql-server-5.7 -y
mysql_secure_installation

安装完后，请在 mysqld.conf 文件中的 [mysqld] 行的下面加入一行配置，否则会导致无法添加帐号的问题。 mysqld.conf 文件在 Ubuntu Server 18.0.4 中的位置是（其它版本的系统大同小异）：

/etc/mysql/mysql.conf.d/mysqld.cnf

请加入下面这行：

sql_mode = NO_ENGINE_SUBSTITUTION,STRICT_TRANS_TABLES

MySQL Server 的版本号在 5.7.8 及以上的版本，上面这行可能需要加引号，如下：

sql-mode = "NO_ENGINE_SUBSTITUTION,STRICT_TRANS_TABLES"

( 以上命令执行中，会询问 0 1 2 分别表示密码强度：弱 / 中等 / 强，请选择一个等级，并设置一个密码如 12X34*56A@abc 后，后面全部按 Y 回车即可 )

若以上设置密码遇到死循环时，用另一个终端执行以下命令，退出当前死循环

killall -9 mysql_secure_installation

并再进入 mysql 执行以下命令，替换以下 123456 重新设置 MySQL 密码：

mysql
use mysql;
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '123456';
flush privileges;
exit

3. 创建空数据库

HelpChat Server 服务端从 11.1.2 版开始，将默认创建以下两个空数据库，分别对应 企业模式 和 客服模式，这样在不同模式之间切换时，不会发生不同模式下的帐号所收发的消息、创建的群等，带入到另一个运行模式下，造成切换后的业务逻辑混乱。

在 MySQL 命令行下依次执行以下命令即可建立相应的，符合字符编码格式的空数据库：

企业模式

create database helpchat_office CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

运营模式

create database helpchat_market CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

重要

新建以上数据库时，字符集编码请务必使用 utf8mb4 / utf8mb4_unicode_ci， 因为要存储消息中某些超宽的 Unicode 格式的 表情图标。

4. 运行 助讯通 服务端 登录与消息核心

请编辑好 config/mysql.ini 文件中的数据库信息：

请将以上设置的 MySQL root 用户的密码，替换以下 pswd = 后面的 123456 ：

以下端口号 6306，请改成默认的 3306

[mysql]
host = 127.0.0.1
port = 6306
user = root
pswd = 123456
db   = helpchatsvr
dbex = helpchatsvrex
charset = utf8mb4
runmode = 0

5. 测试 助讯通 服务端 是否部署成功（ 两个步骤 ）

1.测试数据库是否能正常连接，请运行：

./hclogin

如果成功运行，将会看到以下多行数据库成功连接的提示（多进程）：

Connected to the database.

如上图：确保有显示 MySQL Server connected to .... 字样.

以上的红色字符表明运行在 6866 端口上的核心进程 hckernel 还未启动，请暂时不用理会；

2.测试数据服务器是否正常运行，请运行：

./hcadmin

在浏览器中输入网址 http://127.0.0.1:6980 应该能看到类似于下面的页面 （其中的 127.0.0.1 请记得替换为自己的服务端IP）

默认 后台管理 用户名、密码 如下：

用户名：admin
密　码：helpchat

登录后，如下图：

6. 设置随机自启动：

编辑以下文件

sudo vi /etc/rc.local

在 exit 0 这一行之前加入以下内容

cd /www/helpchat_server/
 
./hclogin &
./hckernel &
./hcadmin &
./hcdata &

以上每一行后面的 & 号，表示在让可执行程序后台运行。

以上的 /www/helpchat_server/，请改成你自己的实际目录路径；

最后，很重要的一步，请保证 HelpChat Server 各后台服务需在 MySQL Server 之后启动

请用命令行工具 vi 打开 rc.local.service 文件，如下：

vi /lib/systemd/system/rc.local.service

将其中的 After=后面，换成 mysql.service 如下：

After=mysql.service

或者

After=mariadb.service

注：以上的 After= 后面是什么，取决于当前服务端装的是哪套数据库，用以下命令即可检查当前是哪套数据库正处于 Active

systemctl status mysql.service
systemctl status mariadb.service

现在可重启服务器；

重启后，所有服务端应该都已经正常随机启动了；

到此 HelpChat Server Linux CentOS 服务器 的核心部署工作就完成了；