use epoll 必须配置在 nginx.conf 的 events 块内且仅出现一次，不可置于 http、server 或 location 块中；Linux 下显式声明可确保启用 epoll 事件模型，提升高并发性能。
直接在 events 块中写 use epoll; 即可，这是 Linux 系统下启用 epoll 的标准做法，无需额外依赖或编译选项。
在哪里配置 use epoll
必须放在 events 块内，且只能出现一次。它不属于全局块、http 块或 server 块。典型位置如下：
- 位于
nginx.conf文件中events { ... }大括号内部 - 不能嵌套在 http、server 或 location 中
- 若未显式配置，Linux 下 Nginx 通常自动选用 epoll（但显式声明更可靠、可读性更强）
标准 events 块示例
一个常见且稳妥的配置片段如下：
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
use epoll;
worker_connections 10240;
accept_mutex on;
}
-
use epoll必须独占一行，后面不加逗号或分号以外的符号 -
worker_connections建议同步调高（如 10240、20480），否则 epoll 的高并发优势无法释放 -
accept_mutex on可减少多 worker 接收连接时的竞争，配合 epoll 更稳定
验证是否生效
配置后重载 Nginx 并检查错误日志，能确认实际使用的模型：
- 执行
nginx -t && nginx -s reload - 查看
error.log（默认在/var/log/nginx/error.log或 conf 中指定路径） - 启动或重载时若看到类似
using the "epoll" event method的日志，说明已启用成功 - 若无此提示，可能因系统不支持（极少见）或配置位置错误（比如写在了 http 块里）
注意事项
epoll 是 Linux 2.6+ 内核原生支持的机制，无需安装额外模块：
- Windows 系统下不支持 epoll，会回退到 select（无需也不应强行配置）
- macOS 使用的是 kqueue，Nginx 会自动适配，
use epoll在非 Linux 系统会被忽略 - 不要在同一个 events 块中写多个
use指令，Nginx 启动会报错 - 如果使用容器部署（如 Alpine Linux），确保基础镜像内核版本 ≥ 2.6 且未裁剪 epoll 支持
