本地window系统phpstudy环境CRMEB客服部署配置流程

发布日期： 2025-10-29 17:04 阅读量： 170 来源： 互联网

现在公司作商城没有使用以前熟悉的Likeadmin系统，现在主要是CRMEB，经过一段时间的熟悉，前面下单之类的已经可以搞定，但是客服一直都没有搞清白，今天项目交付给客户，客户还没有反馈，趁这会时间把crmeb的客服给集中整理一下，模块的正常部署与运行依赖于环境配置、服务启用及代理设置等多环节的协同，以下为详细的部署配置流程、问题排查过程及最终解决方案，旨在为相关操作提供清晰指引。

一、前期准备

在开展部署配置前，需确保服务器环境满足CRMEB客服模块运行要求，建议提前完成以下准备工作：确认服务器已安装Apache、PHP等基础运行环境，准备好APIfox等接口测试工具用于后续连通性验证，同时备份服务器现有环境变量及Apache配置文件，避免配置失误影响原有服务。

二、基础部署配置步骤

按照以下顺序逐步完成基础配置，每一步操作后建议进行简单验证，确保配置生效：

1. 调整PHP版本至7.4.3：PHP版本兼容性是客服模块运行的基础，需修改系统环境变量中的PHP版本。具体操作为：找到系统环境变量中的PHP路径配置项，将其指向PHP 7.4.3版本的安装目录，修改完成后在终端执行“php -v”命令，验证版本是否切换成功，确保无版本冲突提示，之前使用的是8.0版本，一直都报错，我以为是代码不太完整导致的，但是更改之后，报错消失，可以确定是版本问题。

2. 启用后台消息队列功能：消息队列是客服模块处理消息分发、任务调度的核心组件。登录CRMEB系统后台，进入“系统设置-功能配置”页面，找到“消息队列”相关选项，勾选“启用消息队列服务”，根据提示保存配置并重启系统后台服务，确保功能正常加载。

3. 验证Apache的mod_proxy模块启用状态：mod_proxy模块是实现反向代理的关键，需确认其已启用。登录服务器后，找到Apache的主配置文件（通常为httpd.conf），搜索“LoadModule proxy_module modules/mod_proxy.so”，查看该配置行前是否存在注释符号“#”，若有则删除注释以启用模块，初步确认模块配置状态。

4. 配置站点反向代理规则：为实现域名对客服服务的正常访问，需在站点配置中添加反向代理规则。进入Apache的站点配置目录，找到对应站点的配置文件，添加反向代理相关代码（示例：ProxyPass / http://127.0.0.1:40001/ ，具体路径需结合实际服务端口调整），保存配置后执行Apache配置重载命令，使规则生效。

5. 关闭本地防火墙：为排除端口拦截导致的连接问题，临时关闭服务器本地防火墙。根据服务器操作系统类型执行对应命令（如Linux系统执行“systemctl stop firewalld”，Windows系统在“服务”中停用防火墙服务），关闭后记录操作，后续问题解决后可根据需求重新配置防火墙规则。

三、问题排查过程

完成上述基础配置后，客服模块仍无法正常访问，通过APIfox工具开展针对性排查，逐步定位问题根源：

1. 初步连通性测试：使用APIfox工具尝试通过系统域名访问客服模块接口，输入域名及对应接口路径后发起请求，结果显示连接失败，提示“无法建立有效连接”，排除接口本身故障（因基础服务已启动）。

2. 本地地址测试：为区分是网络问题还是配置问题，尝试使用本地回环地址“127.0.0.1:40001”（40001为客服服务默认端口，需结合实际配置调整）在服务器本地通过APIfox发起连接，结果显示连接成功，接口可正常返回数据，说明客服服务本身已正常运行。

3. 域名加端口测试：进一步测试网络访问链路，使用“域名:40001”的形式通过APIfox发起请求，发现连接成功且接口响应正常。结合前两步测试结果，可明确问题核心：域名直接访问失败，而域名加端口、本地地址访问成功，说明Apache反向代理未正常生效，无法将域名请求转发至对应端口的客服服务。

四、问题解决与验证

针对反向代理问题，重新核查Apache配置文件，最终找到问题症结并完成修复：

- 定位核心问题：再次检查Apache主配置文件httpd.conf，发现除已启用“mod_proxy.so”模块外，反向代理相关的“mod_proxy_connect.so”模块未启用，配置行“LoadModule proxy_connect_module modules/mod_proxy_connect.so”前仍带有注释符号“#”，导致反向代理的连接转发功能无法正常工作。

- 执行修复操作：删除“LoadModule proxy_connect_module modules/mod_proxy_connect.so”行前的注释符号，保存配置文件后，执行Apache重载命令（如“systemctl reload httpd”），确保新配置生效。

- 最终验证：使用APIfox再次通过纯域名访问客服模块接口，请求顺利响应，数据返回正常；同时测试客服模块的消息发送、接收等核心功能，均能正常运行，确认问题已彻底解决。

五、总结

CRMEB客服模块部署配置中，Apache反向代理的完整配置是实现域名正常访问的关键，需同时启用“mod_proxy.so”和“mod_proxy_connect.so”两个核心模块。本次部署过程中，通过“基础配置-问题排查-精准修复”的流程，高效定位并解决了反向代理失效问题，也为后续类似部署配置提供了重要经验：配置完成后需通过多场景测试验证连通性，且核心模块的启用状态需逐一核查，避免遗漏关键配置项，总共消费2个小时时间。

最终的配置现在写出来供以后参考

站点配置

<VirtualHost *:80>
    DocumentRoot "E:/work/gongfu/CRMEB-master/crmeb/public"
    ServerName crmeb.cn
    ServerAlias 192.168.31.80
    FcgidInitialEnv PHPRC "D:/phpstudy_pro/Extensions/php/php7.4.3nts"
    AddHandler fcgid-script .php
    FcgidWrapper "D:/phpstudy_pro/Extensions/php/php7.4.3nts/php-cgi.exe" .php
ProxyPass /notice ws://127.0.0.1:40001/
ProxyPassReverse /notice ws://127.0.0.1:40001/
ProxyPass /msg ws://127.0.0.1:40002/
ProxyPassReverse /msg ws://127.0.0.1:40002/
  <Directory "E:/work/gongfu/CRMEB-master/crmeb/public">
      Options FollowSymLinks ExecCGI
      AllowOverride All
      Order allow,deny
      Allow from all
      Require all granted
	  DirectoryIndex index.php index.html error/index.html
  </Directory>
  ErrorDocument 400 /error/400.html
  ErrorDocument 403 /error/403.html
  ErrorDocument 404 /error/404.html
  ErrorDocument 500 /error/500.html
  ErrorDocument 501 /error/501.html
  ErrorDocument 502 /error/502.html
  ErrorDocument 503 /error/503.html
  ErrorDocument 504 /error/504.html
  ErrorDocument 505 /error/505.html
  ErrorDocument 506 /error/506.html
  ErrorDocument 507 /error/507.html
  ErrorDocument 510 /error/510.html
</VirtualHost>

apache配置

LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_ajp_module modules/mod_proxy_ajp.so
#LoadModule proxy_balancer_module modules/mod_proxy_balancer.so
#LoadModule proxy_connect_module modules/mod_proxy_connect.so
#LoadModule proxy_express_module modules/mod_proxy_express.so
#LoadModule proxy_fcgi_module modules/mod_proxy_fcgi.so
#LoadModule proxy_ftp_module modules/mod_proxy_ftp.so
#LoadModule proxy_html_module modules/mod_proxy_html.so
#LoadModule proxy_http_module modules/mod_proxy_http.so
#LoadModule proxy_http2_module modules/mod_proxy_http2.so
LoadModule proxy_scgi_module modules/mod_proxy_scgi.so
#LoadModule proxy_uwsgi_module modules/mod_proxy_uwsgi.so
LoadModule proxy_wstunnel_module modules/mod_proxy_wstunnel.so

上一篇：: 记一次微信支付"bt rasp intercept"报错的解决过程

下一篇：: fastadmin报错preg_replace_callback(): Passing null to parameter #3 ($subject) o

本地window系统phpstudy环境CRMEB客服部署配置流程

随便看看