Ubuntu Server 部署

在 Ubuntu Server 上部署 HelpChat Server 13。推荐 Ubuntu Server 20.04 / 22.04 / 24.04 LTS。

一、解压安装包

bash

tar -xzf HelpChat_Server_Linux_<架构>_<版本>.tar.gz
cd HelpChat_Server_Linux_<架构>_<版本>

二、部署到正式目录

bash

sudo mkdir -p /opt/helpchat_server
sudo cp -r * /opt/helpchat_server/
cd /opt/helpchat_server

使用固定目录便于长期维护和自动升级。

三、设置可执行权限

bash

sudo chmod +x helpchatsvr
sudo chmod +x bin/ffmpeg bin/ffprobe bin/hcupdater

四、安装并启动服务

bash

sudo ./helpchatsvr install
sudo ./helpchatsvr start

五、查看服务状态

bash

sudo ./helpchatsvr status

六、运行模式配置

修改配置文件 config/helpchatsvr.ini，找到 [runtime] 部分：

config/helpchatsvr.ini

[runtime]
run_mode = 0    ; 办公模式，使用 db_office 数据库
run_mode = 1    ; 运营模式，使用 db_market 数据库

七、数据库配置（可选）

默认使用 SQLite，无需额外配置，开箱即用。

如需使用其他数据库，修改 config/helpchatsvr.ini 的 [database] 部分：

config/helpchatsvr.ini

[database]
type      = sqlite / mysql / postgres / sqlserver
host      = 数据库地址
port      = 数据库端口
user      = 数据库用户名
password  = 数据库密码
db_office = 办公数据库名（run_mode=0 时使用）
db_market = 运营数据库名（run_mode=1 时使用）

注意

除 SQLite 之外，其它数据库请确保先创建好空的同名数据库：

sql

-- 办公模式
CREATE DATABASE helpchat_office CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

-- 运营模式
CREATE DATABASE helpchat_market CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

修改配置后重启服务：sudo ./helpchatsvr restart

八、其他命令

命令	说明
sudo ./helpchatsvr start	启动服务
sudo ./helpchatsvr stop	停止服务
sudo ./helpchatsvr restart	重启服务
sudo ./helpchatsvr status	查看状态
sudo ./helpchatsvr run	控制台前台运行
sudo ./helpchatsvr uninstall	卸载服务
./helpchatsvr version	查看版本

九、默认端口

端口	名称	用途	配置项	备注
6800	Login	用户注册、登录认证	login_port
6866	Kernel	核心消息收发、长连接通道	kernel_port
6888	Storage	文件上传下载、图片收发	storage_port
6816	HelpPost	论坛 / 知识库	helppost_port	设为 0 可禁用
6898	Repeater	VNC 远程桌面协助转发	repeater_port	设为 0 可禁用
6980	Manager	管理后台 Web	manager_port

确保防火墙开放以上端口：

bash

sudo ufw allow 6800,6866,6888,6816,6898,6980/tcp

十、管理后台

text

访问地址：http://服务器IP:6980
默认账号：admin
默认密码：helpchat