Linux 应优先使用 epoll，FreeBSD/macOS 应选用 kqueue；Nginx 自动检测并启用对应机制，显式配置 events { use epoll; } 可避免容器环境误判，但仅在对应系统支持时生效，否则启动报错退出。
Linux 系统默认且应优先使用 epoll，FreeBSD/macOS 系统则应选用 kqueue；Nginx 会自动检测并启用对应机制，通常无需手动指定，但明确配置可避免自动探测失效或容器环境误判。
Linux 下 epoll 是唯一合理选择
epoll 是 Linux 2.6+ 内核原生的高性能 I/O 多路复用接口，相比 select/poll 具备显著优势：
- O(1) 事件复杂度，支持数十万并发连接，无文件描述符数量硬限制（仅受系统资源约束）
- 边缘触发（ET）模式减少重复通知，配合非阻塞 socket 可提升吞吐
- Nginx 在 Linux 上默认启用 epoll，即使未显式配置也几乎总在使用它
除非内核版本极旧（
FreeBSD/macOS 必须用 kqueue
epoll 是 Linux 专属接口，在 FreeBSD、OpenBSD、macOS 等系统上根本不存在。这些系统原生高效机制是 kqueue：
- kqueue 支持文件、socket、信号、子进程等多种事件源，语义更通用
- 同样具备 O(1) 事件分发能力，且对大量空闲连接更友好
- Nginx 在编译时若检测到 kqueue 头文件（如
），会自动启用它
在 macOS 上运行 Nginx（例如本地开发），若发现高并发下响应延迟或 CPU 异常升高，大概率是因未启用 kqueue（常见于静态编译包或 Docker 镜像未适配宿主系统）。
如何确认和显式配置事件模型
运行中的 Nginx 可通过以下方式验证实际使用的事件模块：
- nginx -V 2>&1 | grep -o 'epoll\|kqueue\|poll\|select' —— 查看 configure 参数中启用的模块
- nginx -t -v 或检查 error.log 启动日志，通常含类似 "using the kqueue event method" 的提示
若需强制指定（如多平台统一部署脚本或容器基础镜像），可在 nginx.conf 的 events 块中写：
events {
use epoll; # Linux
# use kqueue; # FreeBSD/macOS
worker_connections 10240;
}
注意：use 指令仅在对应系统支持时生效，不支持时 Nginx 启动会报错并退出。
容器与跨平台部署注意事项
在 Docker 等容器环境中，Nginx 进程运行在宿主内核之上，其事件模型取决于 宿主系统内核，而非容器镜像的发行版：
- Linux 宿主机上运行 alpine:latest 镜像的 Nginx → 使用 epoll
- macOS 宿主机用 Colima 或 native macOS Docker Desktop → 底层仍是 macOS 内核 → 必须用 kqueue
- 若镜像预编译时未包含 kqueue 支持（如某些精简版二进制包），在 macOS 上可能回退到低效的 poll，需换用官方源码编译或适配镜像
建议在 CI/CD 或部署脚本中根据 uname -s 动态注入 events 配置，或直接依赖 Nginx 自动探测——只要不是极端定制环境，它足够可靠。
