Nginx 1. 常用命令和配置项

Nginx 1. 常用命令和配置项

1. 常用命令

nginx -v
nginx -t

nginx -s stop              // 强制停止
nginx -s quit               // 优雅：先正常处理当前所有请求再停止
  - nginx -s  SIGQUIT  <nginx master pid>
  - nginx -s  SIGWINCH  <nginx worker pid>

nginx -s reload        // 先优雅关闭，再重新启动
  - nginx -s  SIGHUP  <nginx master pid>


nginx -s reopen        // 重新打开日志文件
// 可以先把当前日志改名或迁移备份，再 reopen 打开生成新日志文件
  - nginx -s  SIGUSR1  <nginx master pid>

2. 平滑升级

• 通知旧 Nginx 重命名 pid: kill -s SIGUSR2 <nginx master pid>
• 启动新 Nginx (新旧同时运行): nginx
  • 指定配置：nginx -c /etc/nginx/nginx.conf
  • 指定安装目录: nginx -p /usr/local/nginx/
  • 指定全局配置项：nginx -g 'pid /var/nginx/test.pid' (对应操作-g, eg: nginx -g 'pid /var/nginx/test.pid' -s stop )
• 优雅关闭旧 nginx: nginx -s SIGQUIT <nginx master pid>

3. 配置

Nginx 通常由一个 master 进程来管理多个 worker 进程, 通常默认配置为： /etc/nginx/nginx.conf

一般配置块 block{} 有： http / server / location / upstream / if

• 默认守护进程：daemon on | off （当用 gdb调试进程时需要停止守护来跟进 fork 出的子进程）
• 限制 coredump: worker_rlimit_core size
• 限制信号队列：worker_rlimit_sigpending limit
• worker 最大连接数：woker_connections <int:number>
• woker 最多句柄描述符个数: worker_rlimit_nofile limit
• 访问日志: access_log /var/log/nginx/access.log
• 错误日志: error_log /var/log/nginx/error.log (可以通过修改 /etc/logrotate.d/nginx 设置日志的大小等)
• 调试请求: debug_connection [IP|CIDR] 必须在 events 模块里

events {
    debug_connection 127.0.0.1;
    debug_connection 172.28.36.0/24;
}

• 优化性能

建议worker 数量和服务器的 CPU 核心数一样，且一一绑定, 减少进程间切换的代价。

worker_processes 4;
worker_cpu_affinity 1000 0100 0010 0001;

• 选择事件模型： use [ epoll | select | poll | rtsig | eventport | /dev/poll ]; linux 可供选择 epoll poll select 三种，epoll 性能最好。

下一章： Nginx 2. location 和 http_proxy