Swoole官方扩展中不存在SwooleProxyServer类，该类仅为第三方封装或误传；官方支持的代理实现方式仅有两种：基于SwooleHttpServer手动编写反向代理逻辑，或使用SwooleCoroutineHttpClient进行协程转发。
“SwooleProxyServer”根本不存在
官方 Swoole 扩展中没有 SwooleProxyServer 这个类。你搜到的这类写法，基本是第三方封装库、过时文档或误传代码——比如某些旧版 Gitee 项目（如 x2460087/swoole-src）里自定义的 Proxy 类，或早期社区仿照 SwooleHttpServer 命名习惯的随意命名。
真正被 Swoole 官方支持且稳定可用的代理相关能力，只有两类：
-
SwooleHttpServer+ 手动实现反向代理逻辑（主流、可控、推荐） -
SwooleCoroutineHttpClient用于后端请求转发（协程模式下最常用）
为什么不能直接 new SwooleProxyServer()
执行 new SwooleProxyServer() 会直接报错：Class 'SwooleProxyServer' not found。这不是配置或版本问题，而是该类从未进入 Swoole 主干代码。
容易混淆的点：
-
swoole_http_server（函数式旧 API）和SwooleHttpServer（面向对象新 API）是真实存在的 HTTP 服务器类，但它们本身不带代理功能，只是基础服务容器 - 所谓“Proxy Server”必须由开发者用
on('request')拦截请求，再用SwooleCoroutineHttpClient转发，最后$response->end()回传——这是标准做法 - 部分教程里出现的
use SwooleProxy是某个独立 Composer 包（非官方），其Proxy类内部也只是对SwooleHttpServer和协程 Client 的封装
正确实现 HTTP 反向代理的最小可行路径
用 SwooleHttpServer 实现透明代理，核心就三步：接收 → 转发 → 回传。关键不是“有没有 Proxy 类”，而是怎么组织协程调用链。
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
示例片段（省略错误处理）：
<pre class="brush:php;toolbar:false;">$server = new SwooleHttpServer('0.0.0.0', 9501);
$server->on('request', function ($request, $response) {
$client = new SwooleCoroutineHttpClient('backend.example.com', 80);
$client->set(['timeout' => 5]);
$client->execute('/', $request->getMethod(), $request->rawcontent());
$response->status($client->getStatusCode());
foreach ($client->getHeaders() as $k => $v) {
$response->header($k, $v);
}
$response->end($client->getBody());
});
$server->start();
注意：
- 必须启用协程：
co::set(['hook_flags' => SWOOLE_HOOK_ALL])（PHP 8.1+ 可能默认开启） - 后端域名解析依赖
dns_lookup，若用 IP 更稳；若需 HTTPS 后端，$client构造时传443并设'ssl' => true - Header 转发要过滤敏感项（如
Connection、Keep-Alive），否则可能触发客户端连接复用异常
容易被忽略的底层约束
很多人卡在“代理跑起来但超时/乱码/502”，其实和类名无关，而是没意识到 Swoole 的事件模型限制：
- Worker 进程内协程是共享内存的，但
SwooleCoroutineHttpClient实例不可跨协程复用，每次请求都得 new 一个 - 如果后端响应头含
Transfer-Encoding: chunked，$client->getBody()仍能取全，但流式响应（如 SSE）需用on('data')事件手动透传，无法靠end()简单搞定 -
SwooleHttpServer默认不解析Content-Length外的 body，POST 大包需确认$request->rawcontent()是否完整（尤其用了 Nginx 做前置时）
代理逻辑越简单，越容易出底层兼容问题；真要长期运行，别迷信“一行启动 Proxy”的幻觉，老实用 on('request') + 协程 Client 控制每一步。
