当前位置：首页 > article >正文

借助 Docker 环境变量，实现1分钟上线在线客服系统

article 2025/2/18 20:15:25

最新版本的客服系统 Docker 镜像加入了对环境变量的支持，可以在 docker run 时直接指定域名和IP，一键上线，不再需要进入容器内修改配置文件。

从 Docker Hub 下载服务器镜像
docker pull iccb1013/linkup:latest

用以下启动命令为例：
docker run -e ApiUrl=http://kf-api.yourname.com -e ResourceUrl=http://kf-resource.yourname.com -e TcpIpAddress=您的服务器公网IP地址 -p 8021-8023:8021-8023 -p 9527:9527 -dit --restart=always --privileged=true --name=linkup_latest iccb1013/linkup:latest

如果无法访问 Docker Hub，可以下载我提供的镜像文件
cd /
wget -c https://files.shengxunwei.com/kf/dockerimages/linkup.tar
docker load -i /linkup.tar

环境变量

启动命令中，包括了 3 个环境变量，分别是：

ApiUrl：您的主程序域名
ResourceUrl：静态资源站点域名
TcpIpAddress：您的服务器公网IP地址

域名不是必须的，您也可以通过服务器公网 IP 地址加上端口号的方式使用本系统。
参阅：准备域名

如果您不使用域名访问，而是使用 IP 地址，那么启动命令会是这样（假设 IP 地址为 8.8.8.8）：
docker run -e ApiUrl=http://8.8.8.8:8021 -e ResourceUrl=http://8.8.8.8:8022 -e TcpIpAddress=8.8.8.8 -p 8021-8023:8021-8023 -p 9527:9527 -dit --restart=always --privileged=true --name=linkup_latest iccb1013/linkup:latest

通过指定这些环境变量，可以在启动容器后直接上线使用，而无需进入容器手工修改配置文件。

或者，在启动容器时不指定域名和 IP 地址，程序将以 http://localhost:端口运行，并监听 127.0.0.1 上的 9527 通信端口。
待容器启动后，进入容器内容修改配置文件。参阅：更新容器中的客服系统配置文件
docker run -p 8021-8023:8021-8023 -p 9527:9527 -dit --restart=always --privileged=true --name=linkup_latest iccb1013/linkup:latest

初始化

首次启动容器时将自动执行数据库初始化等操作，请稍等片刻再访问。

从容器中下载客服端软件

从部署好的站点中下载匹配的客服端软件
http://kf-resource.yourname.com/Shell.zip
如果使用 IP 地址访问客服系统，下载地址为：
http://ip:8022/Shell.zip

客服端软件版本需要与服务端匹配使用，请直接从容器中下载提供的对应版本。

解压后运行 Sheng.Linkup.Client.Shell.exe，并在登录画面中修改服务器地址为你的主程序地址，然后使用默认账户登录。
主程序地址： http://kf-api.yourname.com
如果使用 IP 地址访问客服系统，则主程序地址为：http://ip:8021

默认站点代码：freesite，账户： kf1 ，密码：123 登录。

站点代码和客服的账户信息可以登录 Web 管理后台修改。

打开访客端聊天窗口

打开访客聊天页面，输入内容后点击发送按钮。
http://kf-resource.yourname.com/WebChat/WebChat.html?sitecode=freesite
如果使用 IP 地址访问客服系统，地址为：
http://ip:8022/WebChat/WebChat.html?sitecode=freesite

即可开始与客服聊天，更详细的使用说明和集成说明，请参阅在线文档的相关章节。