Live Helper Chat 4.97v 介绍与选型指南

Live Helper Chat 4.97v 开源 PHP 在线客服系统介绍与选型：定位、五层架构、功能特性、与 Chatwoot/Rocket.Chat/Zammad 量化对比，基于 2026-10-26 官方溯源。

Live Helper Chat在线客服PHP即时通讯2026/10/26

Live Helper Chat 4.97v 介绍与选型指南

目标：面向"给网站加一套可自托管的在线客服"这一需求，讲清 Live Helper Chat（下文简称 LHC）的定位、架构、功能边界，并与 Chatwoot、Rocket.Chat、Zammad 做量化对比，帮助读者判断"什么时候选 LHC、什么时候不选"。本文为认知篇，全部信息溯源自官方渠道并标注来源与查询日期，不做本地实测；部署实操见本专栏的安装与部署篇。

一、环境信息

本篇为认知与选型篇，仅联网溯源，不涉及本地环境实测。溯源口径如下（查询日期均为 2026-10-26）：

  • 本篇主版本：Live Helper Chat 4.97v（GitHub Releases 最新稳定版，tag 4.97v，发布于 2026-10-23；上一版 4.96v 发布于 2026-10-14，半月内连续两版，来源：github.com/LiveHelperChat/livehelperchat/releases）
  • 官方发行包：4.97v-with-dependencies.tgz / 4.97v-with-dependencies.zip（Release 附件，实测页面存在；"with dependencies" 表示已内置 Composer 依赖，无需自行执行 composer install）
  • 官方代码仓：github.com/LiveHelperChat/livehelperchat（Apache-2.0，来源：仓库 LICENSE 文件与 shields.io 徽章，实测值 Apache-2.0）
  • 官方文档：doc.livehelperchat.com（安装文档 doc.livehelperchat.com/docs/install）
  • 官方容器编排仓：github.com/LiveHelperChat/docker-standalone（README 首页与主仓库 README 均以此为官方 Docker 入口）
  • 官方镜像组织：Docker Hub remdex 组织（remdex/livehelperchat-php、remdex/livehelperchat-php-cronjob、remdex/livehelperchat-php-resque 等，remdex/livehelperchat-php 最近推送 2026-10-21；注意组织名是作者 ID remdex 而非 livehelperchat，后者在 Docker Hub 上为空组织，实测 count: 0）
  • 对比对象版本：Chatwoot v4.19.1（shields.io release 徽章实测）、Rocket.Chat 8.9 与 Zammad 7.2.2（取本站已有专栏文档口径）
  • 星数口径：四方 GitHub stars 均取自 shields.io 徽章 JSON 实测（2026-10-26）：LHC 2.2k、Chatwoot 38k、Rocket.Chat 46k、Zammad 6k

二、软件概述

LHC 是一款开源的在线客服/在线支持聊天系统（live support chat），由立陶宛开发者 Remigijus Kiminas（GitHub ID remdex）创建并维护至今，源码版权声明从 2009 年起（来源：源码文件头 Copyright 2009-2015 Remigijus Kiminas 与官方仓库）。它解决的问题非常具体：在自有服务器上部署一个"访客在网页里发起聊天、客服坐席在后台接待"的会话系统，并进一步把语音/视频、机器人、消息渠道（Telegram、Messenger、WhatsApp）、邮件转工单等能力围绕同一个会话流整合起来。

几个来自官方的关键事实（来源：官网首页与 README，查询日期 2026-10-26）：

  • 技术底座极轻：核心只依赖 PHP 与 MySQL，官网原话 "Dead simple setup for beginners; Requirements: PHP, MySQL"；只要主机能跑 WordPress，就能跑 LHC。
  • 面向生产验证：官网声明 "In a production environment, serving clients handling over 10,000 chats per day with dozens of operators actively working"，并被银行、医疗、高校、游戏行业用于数据保护优先的场景（来源：官网首页）。
  • 企业级特性免费：官网强调 "Enterprise level features free to use for everyone everywhere"，即坐席数、会话数、部门数不设社区版限制，也不做功能阉割加锁（商用版主要是托管与服务）。
  • 许可：Apache-2.0（LICENSE 文件实测），允许商用闭源二次集成，无 AGPL 类传染条款——这是它与 Zammad（AGPL-3.0）在合规上的关键差异。

💡 说明：LHC 的版本号形如 4.97v（数字 + 小写 v 后缀），这是该项目自带的命名习惯，阅读 Release 与镜像 tag 时不要漏掉后缀。

三、核心架构

LHC 是单体 PHP 应用（MVC 结构，代码根目录 lhc_web/），但围绕"聊天同步"这一个核心问题演化出一套可选的加速/解耦组件。整体可拆成五层（来源：官方 docker-standalone 编排与源码结构，查询日期 2026-10-26）：

层组件说明
Web 层Nginx/Apache + PHP-FPM官方要求 PHP 8.2 及以上；入口 lhc_web/index.php，管理后台路由 index.php/site_admin/...；访客端聊天窗口由一段嵌入 JS（design/defaulttheme/js/widgetv2/index.js）拉起
数据层MySQL/MariaDB要求 MySQL 5.7 或 MariaDB 10.2.3+ 且支持 json 函数（官方安装文档）；可选 Elasticsearch 承接海量会话统计（官网："get statistic for millions of chats in seconds"）、可选 Amazon S3 存放文件
同步层HTTP 轮询 / php-resque 队列默认 http worker 模式（PHP 直接轮询数据库）；官方 Docker 编排把 worker 切换为 resque，用 Redis + php-resque 后台进程承接消息分发（来源：docker-standalone install.sh 中的两处 sed：'worker' => 'http' 改 'resque'、启用 lhcphpresque 扩展）
实时推送层nodejshelper（NodeJS/SocketCluster）或 golhchelper（Go）可选组件，为访客端/坐席端提供 WebSocket 长连接，替代轮询；Go 版 remdex/livehelperchat-golhchelper 镜像 2026-09-22 仍在更新，官方 .env 注释明确它是 NodeJS 版的替代品
后台任务层php cron.php + cron 脚本官方 cronjob 镜像内置 /etc/cron.d/lhc，每分钟跑 workflow（php cron.php -s site_admin -c cron/workflow）、webhook、消息转接，5 分钟/6 小时/8 小时各一档，另含归档、加密、报表、邮箱监控等低频任务（来源：docker-standalone Dockerfiles/cronjob/lhc/cron 实文件）

💡 技术拓展：Web 聊天系统的"新消息如何到达坐席"有三种主流实现，选型时值得横向对比——

方案原理特点
HTTP 短轮询前端定时请求服务器零依赖、实现最简单；延迟=轮询间隔，连接数大时浪费明显
长轮询/Comet请求挂住直到有新消息延迟低；占住服务端连接
WebSocket 推送建立全双工长连接实时性最好、省流量；需要额外常驻进程（NodeJS/Go）

LHC 默认采用 HTTP 轮询（单机小流量足够），规模上来后官方推荐切到 resque 队列 + WebSocket 推送（nodejshelper/golhchelper）组合。本专栏部署篇默认走官方标准编排（轮询 + resque），WebSocket 推送作为可选扩展。

外围能力（均为官方仓库/官网列明）：机器人编排（内置 generic bot + 对接 OpenAI/ChatGPT、Rasa、DeepPavlov、Ollama、Gemini）、邮件转会话（mail conv，IMAP/SMTP 驱动）、Telegram/Facebook Messenger/WhatsApp（Twilio 或 open-wa 自托管）渠道接入、Co-Browsing 与屏幕共享（自托管 NodeJS 服务）、语音视频（Jitsi 免费方案 / Agora 商用方案）、Flutter 移动端 App、Chrome 扩展、REST API 与 Webhooks、n8n 集成、2FA 与 Google 登录。

四、功能特性

以下特性清单来自官网首页功能区与主仓库 README（查询日期 2026-10-26），按运维者视角归类：

  • 坐席与组织：不限坐席数、会话数、部门数；坐席分组、部门可用性时段（departament availability）、团队负责人（Team lead，4.9x 新增）、坐席间互聊、在线状态手动置位与在线原因（4.96v "Online reasons"）。
  • 访客侧：嵌入式聊天 widget（新版嵌入码生成器 Embed code → Widget embed code (new)）、主动邀请弹窗、跨子域访客跟踪、访客截图（"see what your users sees"）、文件上传与拖拽、自定义表单、RTL/LTR 多语言。
  • 会话运营：聊天归档（archive 模块）、加密存储（cron/encrypt）、会话转接与工作流、离线留言（4.98v 之前已有 offline reasons，4.88v 引入）、队列优先级范围控制（4.97v "Standard queue chat priority range for operators"）。
  • 自动化：内置机器人（触发器、REST API 调用第三方服务无需编码）、webhook（cron/webhook 每分钟）、n8n 集成、辱骂检测（DeepPavlov/NudeNet，可选）。
  • 渠道：Telegram（既作客服渠道也作坐席移动端客户端）、Facebook Messenger、WhatsApp（Twilio 托管或 open-wa 自托管）、Google Business Message、邮件（IMAP 拉信自动转会话，cron/mail/monitor_mailbox 每 15 分钟）。
  • 音视频与协同：Jitsi 语音/视频/屏幕共享（免费自托管）、Agora（商用付费）、Co-Browsing（独立 NodeJS 服务，官方镜像 livehelperchat-cobrowse）。
  • 企业扩展：Elasticsearch 大数据量统计、Amazon S3 文件存储、Google 账号登录、2FA、多域名/子域名部署、主题定制（Bootstrap 5）。
  • 开发者：MVC 结构、扩展（extension）钩子机制、REST API、Webhooks、MCP 支持（4.9x 新增 "MCP Support" Release）。

💡 说明：上表中带版本号的特性（Online reasons、Team lead、MCP Support 等）直接取自 GitHub Releases 标题（4.88v～4.97v 区间，查询日期 2026-10-26），可作为判断"项目仍在活跃迭代"的证据：4.96v 与 4.97v 分别发布于 2026-10-14 与 2026-10-23，且 remdex/livehelperchat-php 官方镜像 2026-10-21 同步更新。

五、快速开始（最小可用示例）

官方推荐两条安装路径（来源：doc.livehelperchat.com/docs/install 与 docker-standalone README，查询日期 2026-10-26）：发行包 + Web 向导（传统路径）与 Docker 编排（官方主推，README 首页 "How to install?" 即指向 docker-standalone）。本节给出两条路径的最小骨架，完整逐步实录见本专栏部署篇。

路径一：发行包 + Web 向导（需自备 PHP 8.2+ 与 MySQL/MariaDB）：

# 下载 4.97v 内置依赖的发行包（GitHub Release 附件，页面实测存在）
wget https://github.com/LiveHelperChat/livehelperchat/releases/download/4.97v/4.97v-with-dependencies.tgz
# 解压后得到 lhc_web/ 目录，放入 Web 根并赋予写权限（官方文档要求）

发行包解压后按官方文档对 cache/、var/、settings/ 三处授予 Web 服务用户写权限，浏览器访问 index.php/site_admin/install/install 进入安装向导：填数据库连接 → 填初始管理员 → 完成。安装完成后的登录地址固定为 index.php/site_admin/user/login。生成网站嵌码在管理后台：设置图标 → Embed code → Widget embed code (new)。

路径二：官方 Docker 编排（docker-standalone）：

# 官方 install.sh 的实际动作（源文件实测）：克隆主仓库 + lhc-php-resque，
# 复制 resque.php、把 Redis 主机改写为 'redis'、启用 lhcphpresque 扩展并把 worker 从 http 切到 resque
git clone --branch master https://github.com/LiveHelperChat/livehelperchat.git --depth 10
git clone --branch master https://github.com/LiveHelperChat/lhc-php-resque.git --depth 10
# 之后：复制 .env.default 为 .env（改 LHC_SECRET_HASH），拉起 docker-compose-standard.yml，
# 浏览器访问 http://127.0.0.1:8081 完成向导（README 原文指引）

⚠️ 以上两段命令块为官方仓库/文档原文动作的摘录（标注来源与查询日期），本篇不做本地实测；逐步逐条带真实回显的安装实录见本专栏安装与部署篇。官方编排默认监听 8081 端口（.env 的 LHC_PUBLIC_PORT），包含 web(nginx)、php(fpm)、php-cronjob、php-resque、cobrowse、redis、db(mariadb) 七个服务，数据库 root 密码默认 lhcroot——正式部署必须修改 .env 中的 LHC_SECRET_HASH 与数据库口令。

六、适用场景与限制

适合选 LHC 的场景（结合官方声明与架构特征）：

  1. PHP 技术栈团队的自托管客服：与 WordPress/Nginx/PHP 共用一套运维经验，一台小规格服务器（PHP-FPM + MySQL）即可起步，是四款对比产品中部署最轻的。
  2. 强 bot/自动化诉求的售前客服：内置触发器机器人 + REST API 直调任意第三方服务，官网以 "integrate any third party Rest API out of the box without any coding" 作为核心卖点。
  3. 多渠道收件箱：Telegram/Messenger/WhatsApp/邮件统一进同一会话流，其中"邮件自动转会话"（mail conv）是 LHC 相对 Chatwoot 的特色能力。
  4. 合规敏感行业：Apache-2.0 无传染性 + 数据完全自持，官网明确银行/医疗/高校在生产使用；helpline（危机热线）场景有官方专门方案页。
  5. 需要语音/视频/协同浏览且不想再买 SaaS：Jitsi 免费方案可完全自托管。

限制与风险（选型前必须知晓）：

  • 社区规模小：GitHub 2.2k stars，与 Chatwoot（38k）、Rocket.Chat（46k）差一个数量级；第三方教程、插件市场、招人熟悉度都不占优，遇到问题更多依赖官方文档与 Discord/Forum。
  • 单维护者主导：项目由 remdex 个人长期主导迭代（2009 至今），巴士因子低是客观事实；好在发布节奏稳定（2026-10 内连发 4.96v/4.97v）。
  • 实时体验默认靠轮询：不部署 nodejshelper/golhchelper 时，消息到达延迟取决于轮询间隔与 cron/workflow 执行频率，高频场景必须做加速扩展。
  • 官方镜像无版本 tag：remdex/livehelperchat-php 在 Docker Hub 只有 latest 标签（实测 tag 列表仅 1 个），镜像与应用版本无一一对应关系，做版本锁定与回滚时要靠自建镜像或固定 digest。
  • PHP 版本门槛：官方要求 PHP 8.2+，老系统（如 Debian 11 默认 PHP 7.4）需要第三方源升级；仓库根目录自带的 Dockerfile 还停留在 php:7.4-apache，不能作为当前版本的镜像参考（应以 docker-standalone 的 php:8.5-fpm 为准）。
  • 文档与界面英文为主：有中文翻译语言包但文档、社区均英文，中文团队需评估使用成本。

七、同类选型对比

本节把 LHC 与三个常被一起比较的开源产品做量化对比。对比对象：Chatwoot（客户消息平台）、Rocket.Chat（团队聊天 + 全渠道客服）、Zammad（工单式客服台）。版本与星数口径见「一、环境信息」；本站已有 Rocket.Chat、Zammad 专栏可对照阅读：《Rocket.Chat 8.9 介绍与选型指南》、《Zammad 7.2.2 介绍与选型指南》。

维度Live Helper Chat 4.97vChatwoot v4.19.1Rocket.Chat 8.9Zammad 7.2.2
定位自托管在线客服 + bot 编排客户消息平台（omnichannel inbox）团队聊天 + 客服工作台工单式客服台（email-first）
技术栈PHP 8.2+ 单体Ruby on RailsNode.js（Meteor）Ruby on Rails
数据库MySQL/MariaDBPostgreSQL + RedisMongoDB（副本集）PostgreSQL + Redis
许可证Apache-2.0（LICENSE 实测）核心 MIT + 部分企业特性单独授权（LICENSE 拆分声明实测）核心 MIT + 部分企业特性单独授权（LICENSE 拆分声明实测）AGPL-3.0（shields.io 实测）
GitHub stars2.2k38k46k6k
部署重量极轻：PHP + MySQL 即可起步中：Rails + PG + Redis + Sidekiq重：MongoDB 副本集 + 多服务中重：PG + Redis + 多进程
实时推送默认轮询，可选 WebSocket（NodeJS/Go）WebSocket 内置WebSocket 内置（DDP/WS）WebSocket 内置
版本节奏（近两月）4.96v（10-14）、4.97v（10-23）连续两版v4.19.1 为最新8.9（本站专栏口径）7.2.2（本站专栏口径）
特色能力邮件转会话、helpline 方案、Co-Browsing 自托管、bot 直调 REST API收件箱体验、多渠道报表大型团队 IM + 频道 + 直播聊天工单 SLA、报表、多语言知识库
适合谁PHP 团队、轻量起步、bot 自动化、合规自持想要现代客服产品体验的中小团队已用 Rocket.Chat 做 IM 再扩展客服邮件工单为主的售后支持

关键差异与如何选：

  • 最轻 vs 最流行：LHC 用"PHP + MySQL 两个依赖"换来最低的部署与运维门槛，代价是社区规模与生态最小；如果你的团队只有一台 2C4G 服务器和 PHP 运维经验，LHC 是四者中唯一能"一小时跑起来"的。
  • 合规差异：Zammad 的 AGPL-3.0 要求对修改后的网络服务开源，商业公司直接二开需法务评估；LHC 的 Apache-2.0 无此顾虑。
  • 产品成熟度差异：Chatwoot/Rocket.Chat 的坐席工作台、移动端体验更现代，且有大量商业服务背书；LHC 的优势在可定制性（PHP 直接改）与自动化（bot + webhook + REST API 全免费无锁）。
  • 一个反向提醒：如果你要的其实不是"网站访客聊天"而是"邮件工单系统"，Zammad 更对口；如果是"内部协作 IM"，Rocket.Chat 更对口；LHC、Chatwoot 才是"在线客服"的同赛道对手。

八、参考链接

  • 官网：https://livehelperchat.com
  • 官方安装文档（本文安装要求与向导流程来源）：https://doc.livehelperchat.com/docs/install
  • GitHub 主仓库（Apache-2.0）：https://github.com/LiveHelperChat/livehelperchat
  • 4.97v Release 页（含 4.97v-with-dependencies.tgz/zip 附件）：https://github.com/LiveHelperChat/livehelperchat/releases/tag/4.97v
  • 官方 Docker 编排仓：https://github.com/LiveHelperChat/docker-standalone
  • 后台队列扩展 lhc-php-resque：https://github.com/LiveHelperChat/lhc-php-resque
  • 官方镜像（Docker Hub remdex 组织）：https://hub.docker.com/u/remdex
  • 站内对照：《Rocket.Chat 8.9 介绍与选型指南》、《Zammad 7.2.2 介绍与选型指南》
  • 本专栏部署实操：安装与部署篇（Debian 12 安装 / Docker Compose 部署）见本专栏列表。