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 Swoole\Http/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 Swoole\Http/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 统一入口调度即可。
