症状
管理员或用户可能会反馈系统频繁将其从WHMCS登出,并提示重新登录。
此行为的常见原因包括:
-
托管WHMCS的服务器存在PHP配置错误。
-
托管WHMCS的服务器存在代理或CDN配置错误。
-
托管WHMCS的服务器磁盘空间不足。
-
访客IP地址发生变化。
-
访客正在使用VPN。
有关其他登录问题的信息,请参阅排查登录问题。
PHP配置错误
托管WHMCS的服务器若存在PHP配置错误,可能导致登录会话中断。常见配置错误包括:
-
PHP会话支持被禁用。
- •
session.auto_start设置已启用。 -
session.save_path值不可写。
系统健康检查(Configuration > System Health) 可检测到这些配置错误。
但需注意,系统健康检查无法检测以下配置错误:session.gc-maxlifetime值过低(PHP默认会话存活时间为1440秒)。
解决方案
-
如需解决PHP会话问题,请参阅系统健康状态页中PHP会话支持注意事项的解决方法。
-
如需解决会话存活时间问题,请参阅延长登出前的等待时间(登录会话时长)。
WHMCS可将登录会话数据存储在MySQL®数据库而非文件系统中。切换至数据库会话存储可绕过此类限制,更多信息请参阅数据库会话。
代理/CDN配置错误
若服务器部署在代理服务器或CDN后方,配置错误可能导致IP地址检测失效,进而触发客户端登出。
排查方法:查看 Configuration > System Logs 中的管理日志。
观察同一管理员的日志记录IP地址:若显示的是内网IP而非连接的公网IP,说明服务器可能部署在代理或CDN后方。
若日志显示不同IP地址,可能表明代理或CDN配置存在问题。
示例:
解决方案
WHMCS通过以下HTTP头信息检测访客IP地址(优先使用第一个有效且非本地的内网地址,支持IPv4/IPv6):
HTTP_CLIENT_IP、HTTP_X_FORWARDED_FOR、HTTP_X_FORWARDED、HTTP_X_CLUSTER_CLIENT_IP、HTTP_FORWARDED_FOR、HTTP_FORWARDED。
若上述头信息均不可用,WHMCS将回退至REMOTE_ADDR的值。
请联系服务器管理员或托管服务商,配置一个或多个HTTP头以转发访客IP至PHP。更多信息请参阅可信代理设置。
磁盘空间不足
若托管WHMCS的服务器或托管账户磁盘空间不足,PHP将无法将会话数据写入磁盘存储路径,导致认证虽成功但无法保存已认证状态。
解决方案
检查托管WHMCS的服务器及账户可用磁盘空间,调整配额以确保有足够空闲空间。
访客IP地址变化
若访客在加载页面、请求下一页或提交表单期间IP地址发生变化,系统将触发登出(此为防范会话劫持的安全机制)。
部分网络连接(如移动网络、3G/4G/5G)的IP地址变更频率可能高于固定线路连接。
排查方法:查看HTTP服务器访问日志,确认访客浏览网站时IP地址是否一致(单个访客IP频繁变化可佐证此问题)。
解决方案
-
建议受影响访客使用固定线路连接(IP分配更稳定)。
-
检查 Configuration > System Settings > General Settings 中“Security”标签页的“Disable Session IP Check”选项。更多信息请参阅安全标签页。
访客使用VPN
VPN连接会变更访客IP地址(如连接/断开时,或切换地区时)。部分VPN服务商会自动变更访客IP(用户可能无感知)。
解决方案
建议用户使用IP地址分配更稳定的网络连接。

