环境准备

叮咚客服是基于 php 的客服系统，因此这里推荐的环境是 LNMP 环境，下面列出我们需要的软件以及版本
软件名称
版本
php
7.3+
mysql
5.6+
nginx
1.18.0
前端确保你的 服务器/电脑 上安装了 nodejs 并且执行 如下命令不报错
node -v
npm -v
node推荐版本14.17.0，别的过高的版本可能会报错
将 php.ini 中的安全函数以 pcntl_ 开头的函数都删除
[教程] 叮咚 开源客服系统 在线对话插图
如何确定该删除哪个版本的php.ini中的安全函数呢？
[教程] 叮咚 开源客服系统 在线对话插图1
由于需要通过websocket通信，所以需要服务器开启端口。本系统默认使用的是 9120 端口，因此如果这个端口没被占用的话，你可以直接开启这个端口。当然，如果你更换了端口，那开启的方式是一样的。
1、到安全里面，放开 9120 端口，如果你是别的端口同理。
[教程] 叮咚 开源客服系统 在线对话插图2
2、云服务器，以阿里云为例，存在安全组的概念，就是阿里云给所有的云服务器额外加了一层防火墙，因此你需要到阿里云上，放开 9120
[教程] 叮咚 开源客服系统 在线对话插图3

开始安装

准备域名

我们准备2个域名，一个用于客服系统的web页面，一个用于api接口系统，比如我们有如下的2个域名

域名
用途
http://ddfree.pfecms.com
客服工作台地址
http://ddfree-api.pfecms.com
服务接口地址

配置接口程序

新建网站

[教程] 叮咚 开源客服系统 在线对话插图4
新建网站，输入网址，http://ddfree-api.pfecms.com (接口的域名)。

下载代码

登录 https://gitee.com/nickbai/dingdong 将获得的软件包 dingdong-master.zip 解压，获取包内的 dingdong包到宝塔的 /www/wwwroot/ddfree-api.pfecms.com下
[教程] 叮咚 开源客服系统 在线对话插图5
[教程] 叮咚 开源客服系统 在线对话插图6

配置站点

[教程] 叮咚 开源客服系统 在线对话插图7
网站目录选择 /www/wwwroot/ddfree-api.pfecms.com/dingdong
运行目录现在 public
伪静态，下载选择 thinkphp
[教程] 叮咚 开源客服系统 在线对话插图8
location / {
if (!-e $request_filename){
rewrite ^(.*)$ /index.php?s=$1 last; break;
}
}

新建数据库

[教程] 叮咚 开源客服系统 在线对话插图9
新建数据库，选择 utf8mb4编码，然后提交保存。复制好密码，点击管理数据库
[教程] 叮咚 开源客服系统 在线对话插图10
[教程] 叮咚 开源客服系统 在线对话插图11
选中数据库，选择导入，选择文件，sql文件在 /www/wwwroot/ddfree-api.pfecms.com/dingdong/dingdong-free.sql
[教程] 叮咚 开源客服系统 在线对话插图11
提交执行即可。

系统数据库配置

[教程] 叮咚 开源客服系统 在线对话插图12
在 /www/wwwroot/ddfree-api.pfecms.com/dingdong下的 .env 中输入刚才新建的数据库的用户名、数据库名、密码

配置系统信息

/www/wwwroot/ddfree-api.pfecms.com/dingdong/config/dingdong.php 下配置
<?php
return [
// 加密盐
‘salt’ => ‘RKek2dUYSoigxD6’,
// jwt 密码
‘jwt_key’ => ‘zY6dBijuOjEpxr6’,
// 项目域名
‘domain’ => ‘http://www.df.com’,
// 端口
‘ws_port’ => 9120,
// 是否开启ssl
‘open_ssl’ => env(‘SSL.IS_OPEN’, false),
// ssl配置文件
‘context’ => [
‘ssl’ => [
‘local_cert’ => env(‘SSL.LOCAL_CERT’, ”),
‘local_pk’ => env(‘SSL.LOCAL_PK’, ”),
‘verify_peer’ => false,
]
]
];
domain 配置你当前的域名，比如是 http://ddfree-api.pfecms.com

启动socket

进入 /www/wwwroot/ddfree-api.pfecms.com/dingdong 点击 终端 执行
php think server start -d
[教程] 叮咚 开源客服系统 在线对话插图13
其他命令
php think server stop // 停止
php think server restart -d // 重启守护
php think server start // 调试模式启动
php think server restart // 重启为调试模式

配置客服工作台

打包服务台页面

[教程] 叮咚 开源客服系统 在线对话插图14
源码包中的 web 程序即为 客服工作台 页面程序部分。我们可以通过vscode 打开。

注意这里是需要你提前安装了 nodejs 的，至于怎么安装nodejs 你可以百度，很多的。打开项目之后，在web项目根目录执行 npm i ，进行依赖的安装。

[教程] 叮咚 开源客服系统 在线对话插图15
找到 .env.production 配置 VUE_APP_BASE_API 为接口地址 http://ddfree-api.pfecms.com
进入 web 项目的根目录执行
npm run build:prod

新建网站

[教程] 叮咚 开源客服系统 在线对话插图16
配置 域名为 http://ddfree.pfecms.com php版本选择 纯静态
接下来讲我们之前打包好的 dist 目录下的文件，拷贝上传到 /www/wwwroot/ddfree.pfecms.com 即可
[教程] 叮咚 开源客服系统 在线对话插图17
[教程] 叮咚 开源客服系统 在线对话插图18

初始环境的各种默认密码

访问域名 http://ddfree.pfecms.com 即可访问客服工作台
[教程] 叮咚 开源客服系统 在线对话插图19
账号：15500000000 密码：admin
[教程] 叮咚 开源客服系统 在线对话插图20
访客咨询访问 http://ddfree.pfecms.com/#/chat
[教程] 叮咚 开源客服系统 在线对话插图21

如何配置 https

1、选择站点配置证书

[教程] 叮咚 开源客服系统 在线对话插图22

2、配置env

打开 php文件 到项目目录，找到目录下的 .env 文件
[教程] 叮咚 开源客服系统 在线对话插图23
他如果你像我一样是 宝塔的自签名证书，那么你就把 ALLOW_SELF_SIGNED 设置成 true，如果是三方买的证书，这个项目则设置为false
APP_DEBUG = true
[APP]
DEFAULT_TIMEZONE = Asia/Shanghai
[DATABASE]
TYPE = mysql
HOSTNAME = 127.0.0.1
DATABASE = dingdong
USERNAME = dingdong
PASSWORD = 55rDGLhRN6Z4MHha
HOSTPORT = 3306
CHARSET = utf8mb4
DEBUG = true
PREFIX = df_
[LANG]
default_lang = zh-cn
[SSL]
IS_OPEN = true
LOCAL_CERT = /www/server/panel/vhost/cert/dd.pfecms.com/fullchain.pem
LOCAL_PK = /www/server/panel/vhost/cert/dd.pfecms.com/privkey.pem
ALLOW_SELF_SIGNED = true
LOCAL_CERT 和 LOCAL_PK 如何找呢，打开宝塔站点
[教程] 叮咚 开源客服系统 在线对话插图24
这里就是。

3、打开端口

宝塔的安全中，放开9120
[教程] 叮咚 开源客服系统 在线对话插图25
如果你是云主机，请到云主机的安全组中，也放开 9120
[教程] 叮咚 开源客服系统 在线对话插图26

4、重启服务

[教程] 叮咚 开源客服系统 在线对话插图27
确保.env.xx 中域名是 https 的协议，然后重启socket服务即可。
声明：本站所有文章，如无特殊说明或标注，均为本站原创发布。任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益，可联系我们进行处理。