Nginx作为反向代理将请求分发至多个Swoole实例,实现负载均衡;通过upstream配置后端服务,proxy_pass转发请求,结合supervisor进程管理,提升系统高可用与扩展性。

Swoole 是一个高性能的 PHP 异步并发框架,常用于构建长连接服务、微服务或 HTTP 服务。当使用 Swoole 搭建 HTTP 服务器时,它本身已经可以独立对外提供服务,但为了实现高可用、横向扩展和请求分发,通常会结合 Nginx 做负载均衡。
1. 架构设计:Nginx 作为反向代理负载均衡器
Nginx 不直接运行 PHP,而是作为反向代理,将客户端请求转发到后端多个 Swoole HTTP 服务实例。这样可以:
- 分散请求压力
- 提高系统吞吐能力
- 实现故障转移(failover)
- 统一入口管理 SSL、静态资源等
2. 启动多个 Swoole 服务实例
在不同端口上启动多个 Swoole HTTP 服务器,例如:
// server1.php $http = new SwooleHttp/Server('0.0.0.0', 9501); $http->on('request', function ($request, $response) { $response->end("Response from Swoole Server 1"); }); $http->start();
// server2.php $http = new SwooleHttp/Server('0.0.0.0', 9502); $http->on('request', function ($request, $response) { $response->end("Response from Swoole Server 2"); }); $http->start();
确保这两个脚本分别运行在不同的终端或通过进程管理工具(如 supervisor)启动。
3. 配置 Nginx 实现负载均衡
编辑 Nginx 配置文件(通常是 /etc/nginx/nginx.conf 或 /etc/nginx/sites-available/default),添加 upstream 和 server 块:
upstream swoole_backend { least_conn; server 127.0.0.1:9501 weight=1 max_fails=3 fail_timeout=30s; server 127.0.0.1:9502 weight=1 max_fails=3 fail_timeout=30s; } server { listen 80; server_name your-domain.com; location / { proxy_pass http://swoole_backend; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_http_version 1.1; proxy_set_header Connection ""; } }
说明:
- upstream 定义了后端 Swoole 服务组
- least_conn 表示按最少连接数分配请求,也可用 round-robin(默认)或 ip_hash
- proxy_pass 将请求转发到 upstream 组
- 设置 headers 确保 Swoole 能获取真实客户端信息
4. 测试与验证
重启 Nginx 并访问域名或 IP:
curl http://your-domain.com
多次请求应能看到来自不同 Swoole 实例的响应内容(可通过返回文本区分)。使用浏览器开发者工具或日志也能观察请求被分发到不同后端。
5. 进阶建议
- 使用 supervisor 管理 Swoole 进程,防止崩溃退出
- 开启 Swoole 的守护进程模式:
$http->set(['daemonize' => true]); - 结合 Docker + Kubernetes 可实现更灵活的自动扩缩容
- 启用 HTTPS 时,在 Nginx 层配置 SSL 证书,后端仍走 HTTP
基本上就这些。Nginx 结合 Swoole 做负载均衡并不复杂,关键是把 Swoole 当作普通后端服务看待,由 Nginx 统一入口调度即可。
以上就是Swoole怎么结合Nginx做负载均衡的详细内容,更多请关注swoole php docker nginx 浏览器 端口 工具 ssl 后端 curl ai 配置文件 php nginx swoole 架构 并发 default 异步 docker kubernetes http https ssl 负载均衡


