讲师中心 微信公众号
AI工具推荐 视频效率加速

如何配置Workerman的Text协议避免恶意超长字符串导致内存崩溃?

雨强吖_8812

雨强吖_8812

发布时间:2026-05-20 23:12:36

|

711人浏览过

|

来源于php中文网

原创

Text协议易被超长行攻击导致OOM,因其不校验单行长度且不限缓冲区上限;必须显式设置max_package_size和strict_mode启用防护,否则默认无保护。

如何配置workerman的text协议避免恶意超长字符串导致内存崩溃?

Text协议为什么容易被恶意超长行打崩

Workerman 的 TextProtocol 默认用 \n 或 \r\n 做分隔,内部靠不断扫描缓冲区找换行符。它不校验单行长度,也不限制缓冲区上限——如果客户端发一个 500MB 且不含换行的字符串,TextProtocol 会一直缓存、持续扩容内存,直到 OOM 或触发 PHP 内存限制崩溃。

必须设置 max_package_size 并启用 strict_mode

TextProtocol 支持两个关键配置项,但默认都不生效,必须显式传入:

  • max_package_size:单条消息最大允许字节数,超限直接丢弃连接(推荐设为 1024 * 1024 即 1MB)
  • strict_mode:设为 true 后,协议解析器会在每次 recv 后立即检查是否已收到完整行;若缓冲区超过 max_package_size 仍无换行,直接断连

示例写法:

$worker = new Worker('text://0.0.0.0:1234');
$worker->protocol = \Workerman\Protocols\TextProtocol::class;
$worker->transport = 'tcp';
// 必须这样传参,不能只 new TextProtocol()
$worker->onMessage = function ($connection, $data) {
    // $data 已是完整一行(不含\n)
    $connection->send("echo: " . $data);
};
// 关键:通过 protocol_args 注入配置
$worker->protocol_args = [
    'max_package_size' => 1024 * 1024,
    'strict_mode'      => true,
];

比 TextProtocol 更安全的替代方案

如果你控制得了客户端,强烈建议放弃 TextProtocol,改用带长度头的协议:

  • 用 FrameProtocol:内置包头(4 字节网络序长度),天然防粘包+防超长,无需手动解析
  • 自定义二进制协议:用 pack('N', $len) + unpack('N', $header),长度字段本身就能做第一道校验
  • JSON over TCP:自己实现 input() 方法,先读固定长度头,再按长度读 body,再 json_decode(),全程可控

注意:TextProtocol 的“简单”是假象——它省掉的解析逻辑,全在内存和稳定性上还了债。

生产环境必须配合系统级防护

仅靠协议层还不够,得叠加防御:

  • 在 onConnect 中记录连接时间,并用 Worker::addTimer() 定期清理空闲连接(比如 60 秒无数据就 close)
  • 用 Nginx 或 HAProxy 做前置代理,配置 client_max_body_size 和 proxy_read_timeout,提前拦截异常流量
  • Linux 层面限制单进程打开文件数:ulimit -n 65535,防止恶意建大量连接耗尽句柄
  • 日志中监控 "package too big" 或 "connection closed by protocol" 类错误,这是攻击发生的信号

真正危险的不是超长字符串本身,而是你没意识到 TextProtocol 默认根本不拦它。

热门AI工具

更多
Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

相关专题

更多
Workerman安装配置教程
Workerman安装配置教程

Workerman安装配置教程专题提供Workerman安装配置、WebSocket开发、TCP通信、异步编程、高并发服务搭建与PHP实时通信开发教程。

166

2026.05.20

Workerman实时通信与长连接开发教程
Workerman实时通信与长连接开发教程

WWorkerman实时通信与长连接开发教程聚合实时通信、聊天室、长连接、消息推送、AI流式输出等Workerman高并发开发内容。

202

2026.05.20

Workerman异步通信与TCP服务器开发
Workerman异步通信与TCP服务器开发

Workerman异步通信与TCP服务器开发专题整理Workerman异步通信、TCP服务、HTTP服务、WebSocket开发与高并发PHP服务器教程。

187

2026.05.20

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

80

2026.09.30

LLVM RISC-V参数配置教程
LLVM RISC-V参数配置教程

本专题介绍LLVM对RISC-V基础ISA和扩展的支持方式,涵盖RV32、RV64、标准扩展、实验性扩展、厂商扩展、-menable-experimental-extensions和版本差异。

80

2026.09.30

LLVM IR中间表示入门指南
LLVM IR中间表示入门指南

本专题整理LLVM IR的核心概念,包括中间表示作用、模块结构、函数、基本块、SSA形式、类型系统和常见语法,帮助新手理解LLVM编译流程中的关键层。

80

2026.09.30

PDF转图片方法
PDF转图片方法

需要把 PDF 页面用于上传、预览、分享或图片归档时,PDF 转图片方法专题整理 JPG/PNG 格式选择、逐页导出、清晰度设置、批量下载和结果检查等流程,帮助用户稳定完成 PDF 图片化处理。

40

2026.09.30

PixTV AI视频生成与无限画布创作
PixTV AI视频生成与无限画布创作

PixTV专题整理AI视频与视觉内容创作相关功能使用教程,涵盖AI生图、视频生成、无限画布、多模型创作、素材管理、声音音乐及视频剪辑等功能,帮助用户快速掌握PixTV从创意到成片的完整制作方法。

60

2026.09.29

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

280

2026.09.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Webman中文手册
Webman中文手册

共0课时 | 0人学习

Workerman官方手册
Workerman官方手册

共0课时 | 0人学习

ThinkPHP5.1完全开发手册
ThinkPHP5.1完全开发手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn