nginx 默认按操作系统自动适配事件模型：linux 用 epoll，freebsd/macos 用 kqueue；不可手动互换，编译时绑定，配置中 use 指令仅作校验；跨平台部署须匹配构建环境；可通过 nginx -v 或 strace 验证实际使用的模型。
Nginx 在不同操作系统上默认使用不同的事件驱动模型：Linux 用 epoll，FreeBSD/macOS 用 kqueue。它们不是可随意互换的选项，而是由 Nginx 编译或运行时自动适配的内核机制。选型不靠手动指定，而取决于目标系统的内核能力与构建配置。
Linux 环境下只应使用 epoll
Linux 内核原生支持 epoll，且自 2.6 版本起已高度优化。Nginx 在 Linux 上编译时会自动启用 epoll，无需额外配置。即使显式在 nginx.conf 中写 use epoll;，也仅起校验作用——若系统不支持，启动会报错；若支持，则按预期生效。
- 不要尝试在 Linux 上强制改用 kqueue（不可用，编译不通过）
- 避免在配置中写
use select;或use poll;，性能明显偏低，仅作兼容兜底 - 高并发场景下，确保开启
epoll_et（边缘触发模式），这是 epoll 的默认行为，无需显式声明
FreeBSD/macOS 环境下自然选用 kqueue
kqueue 是 FreeBSD 原生高性能事件通知接口，macOS 基于 Darwin 内核，同样完整支持。Nginx 在这些系统上编译时会自动探测并链接 kqueue。其行为与 epoll 类似，但语义更通用（不仅限于 socket，还支持文件、信号等）。
- kqueue 在 FreeBSD 上稳定性与扩展性久经验证，是生产首选
- macOS 上虽支持，但因系统本身非为长期服务器设计，建议仅用于开发测试，避免部署关键服务
- 无需在配置中写
use kqueue;，Nginx 启动时会自动选择；若强行指定，仅校验可用性
跨平台构建与容器化场景注意事项
当使用 Docker 或 CI/CD 构建多平台镜像时，Nginx 的事件模块是在编译阶段决定的，而非运行时。例如：在 Ubuntu 容器中编译的二进制文件，即使拷贝到 FreeBSD 主机，也无法使用 kqueue——它只带 epoll 支持。
- 推荐使用官方预编译包（如 nginx.org 的 deb/rpm 或 FreeBSD ports），它们已针对对应平台优化
- 自行编译时，确保 build 环境与 target 环境一致（例如：FreeBSD 上编译才含 kqueue）
- Docker 多阶段构建中，若需适配不同宿主机，应在对应基础镜像中分别编译，而非“一次编译，到处运行”
如何确认当前 Nginx 使用的事件模型
运行中的 Nginx 不会直接输出所用事件模块，但可通过以下方式验证：
- 执行
nginx -V 2>&1 | grep -o 'epoll\|kqueue\|poll\|select'，查看 configure 参数中启用的模块 - 检查错误日志：启动时若成功加载事件模块，通常无提示；若指定不支持的模型（如 Linux 写
use kqueue），会报unknown event type - 用
strace -e trace=epoll_wait,kqueue,kevent nginx -t（Linux/FreeBSD 分别执行）观察系统调用，可直观确认底层行为
