心域网络
DOCS

知识库

产品文档与帮助中心

星屿客服使用教程

宝塔面板安装

宝塔安装教程

一、服务器建议配置

你的客服系统带实时聊天、WebSocket、后台管理、AI 回复、MySQL 和 Redis,建议:

项目建议
系统 |  Ubuntu 22.04
CPU | 2核起步,推荐 4核
内存 | 最低 4G,推荐 8G
硬盘 | 50G 起
Node.js | 22.22.3
数据库 | MySQL 8.0
缓存 | Redis
Web 服务 | Nginx
进程守护 | PM2

建议使用一台全新的服务器安装,避免以前安装过的 Nginx、MySQL、Node、Docker 环境互相冲突。

二、安装宝塔面板

使用 SSH 工具连接服务器,例如 FinalShell、MobaXterm、XShell。

连接信息:

主机:服务器公网 IP
端口:22
用户名:root
密码:服务器 root 密码

Debian / Ubuntu 安装宝塔

执行:

wget -O install.sh https://download.bt.cn/install/install-ubuntu_6.0.sh && bash install.sh

中途看到:

Do you want to install Bt-Panel to the www directory now?(y/n)

输入:

y

等待安装完成。

安装完成后,终端会显示:

外网面板地址
用户名
密码

复制保存好。

三、云服务器安全组放行端口

去阿里云、腾讯云、华为云或其他服务器后台,进入安全组入方向规则。

至少放行:

端口 | 用途
22 | SSH 远程连接
80 | HTTP 网站访问
443 | HTTPS 网站访问
8888 | 宝塔面板初始端口
3000 或你的 Node 端口 | 初期调试可开放,正式环境不建议开放
3306 | 不建议公网开放
6379 | 不建议公网开放

正式部署后,Node 服务建议只监听 127.0.0.1,由 Nginx 反向代理,不需要开放 3000、3001 等接口端口。

四、登录宝塔并修改安全设置

浏览器访问宝塔安装后提供的地址,例如:

http://服务器IP:8888/随机安全入口
  1. 记得去云服务器安全组放行新端口。

五、安装运行环境

进入宝塔后台:

软件商店

安装下面的软件。

软件 | 建议版本 | 作用
Nginx | 最新稳定版 | 网站和反向代理
MySQL | 8.0 | 客服系统数据库
Redis | 7.x | 缓存、队列、Socket 辅助
phpMyAdmin | 最新版 | 查看和管理数据库


PM2 管理器 | 最新版 | 管理 Node.js 服务
Node.js 版本管理器 | 最新版 | 安装 Node 22.22.3

六、安装 Node.js 22.22.3

宝塔后台进入:

网站-Nodo项目
→ Node 版本管理器-找到22.22.3(找不到点击更新版本列表)
→ 安装

安装完成后进入:

版本管理选择刚刚安装的

选择:

Node.js 22.22.3

安装完成后,进入宝塔终端执行:

node -v
npm -v

正常应该看到类似:

v22.22.3
10.x.x

然后安装 PM2:

npm install -g pm2

确认:

pm2 -v

七、创建客服系统数据库

进入宝塔:

数据库
→ 添加数据库

例如填写:

数据库名:xinyu_chat
用户名:xinyu_chat
密码:设置一个高强度密码
访问权限:本地服务器
字符集:utf8mb4

建议不要把 MySQL 设置为公网访问。

数据库连接配置一般类似:

DB_HOST=127.0.0.1
DB_PORT=3306
DB_NAME=xinyu_chat
DB_USER=xinyu_chat
DB_PASSWORD=你的数据库密码

如果你的项目使用 Prisma、TypeORM、Sequelize 或其他 ORM,按项目中的 .env 配置即可。

八、安装 Redis 并设置密码

进入:

软件商店
→ Redis
→ 安装

安装完成后进入 Redis 设置,设置密码。

例如:

Redis 密码:你的高强度密码
端口:6379
绑定地址:127.0.0.1

Node 项目环境变量通常类似:

REDIS_HOST=127.0.0.1
REDIS_PORT=6379
REDIS_PASSWORD=你的Redis密码

不要开放 Redis 的 6379 公网端口。