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

请准备一台 CentOS Server 的 VPS 或物理主机服务器
操作系统及数据库推荐版本：CentOS Server 7.9 / MySQL Community Server 8

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

https://www.helpchat.com/download

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

在以下红色方框范围（请选择适合自己服务器架构的安装包），鼠标右键点击，在弹出的菜单中，点击复制下载地址子菜单，即可得到 Linux 服务器的下载地址 Linux下载地址

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

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

cd \
mkdir helpchat_server
cd helpchat_server
 
 
请先到官网下载页面，复制 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 命令，请先执行以下命令

yum install wget unzip -y

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

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

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

2. 安装并配置数据库 MySQL Server，逐行执行以下命令

wget https://dev.mysql.com/get/mysql80-community-release-el7-3.noarch.rpm
rpm -ivh mysql80-community-release-el7-3.noarch.rpm
rpm --import https://repo.mysql.com/RPM-GPG-KEY-mysql-2023
yum install mysql-community-server mysql-community mysql

以上安装的过程，按提示输入字母 y 并回车即可，不同 CentOS 版本，其安装 MySQL Server 的方法大同小异。

如果无法安装 MySQL Server，可选择安装 MariaDB Server ( 原 MySQL 作者将 MySQL 卖给 Oracle 后，
基于 MySQL 源码重新编译发行的一套数据库，核心用法与 MySQL 完全兼容 )
 
数据库相关安装部署，请大家自行 AI 或 百度、谷歌；
 
如果你能把数据库部署成功完成，后续所有 HelpChat Server 部署问题，我们都会帮你成功完成（ 可随时联系我们 ）；

安装完后，启动 MySQL 服务：

systemctl start mysqld

通过log查看并得到初始密码：

grep "password" /var/log/mysqld.log

执行以下命令，并将上一步显示出来的 root 初始密码输入，即可成功登录 MySQL 命令行

mysql -u root -p

登录成功后的第一步，需要重设一下 root 的密码，如下命令，替换最后面单引号中 123456 即可：

alter user 'root'@'localhost' identified by '123456';

回车后，执行以下命令，密码更改完成

flush privileges;

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.

数据库测试

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

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

./hcadmin

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

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

用户名：admin
密　码：helpchat

登录后，如下图： Web管理1

Web管理2

6. 设置随机自启动：

随机启动的原理就是，将 HelpChat Server 几个核心进程
 
配置在 /etc/rc.local 这个 CentOS 启动时会运行的脚本文件中；

1. /etc/rc.local 在 CentOS 7.9 中不存在的话，请按以下步骤创建

vi /etc/rc.local

输入以下文件内容：

#!/bin/bash
 
cd /www/helpchat_server/
 
./hclogin &
./hckernel &
./hcadmin &
./hcdata &
 
exit 0

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

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

确保 rc-local 服务已启用，请运行：

sudo systemctl enable rc-local
sudo systemctl start rc-local
sudo systemctl status rc-local

2. 如果 rc-local.service 单元文件不存在，您需要先创建它：

sudo vi /etc/systemd/system/rc-local.service

输入以下文件内容：

[Unit]
Description=/etc/rc.local Compatibility
ConditionPathExists=/etc/rc.local
 
[Service]
Type=forking
ExecStart=/etc/rc.local start
TimeoutSec=0
StandardOutput=tty
RemainAfterExit=yes
SysVStartPriority=99
After=mysql.service
# After=mariadb.service
 
[Install]
WantedBy=multi-user.target

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

systemctl status mysql.service
systemctl status mariadb.service

保存以上配置文件，重新加载 systemd 配置并启用该服务：

sudo systemctl daemon-reload
sudo systemctl enable rc-local
sudo systemctl start rc-local

给予 /etc/rc.local “可执行” 权限：

chmod +x /etc/rc.local

现在可重启服务器；

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

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

CentOS Server

On this page