Nginx学习笔记：安装、运行

本文更新于2024-04-12。

目录

• 安装
  • Windows下安装
  • Linux下安装
• 运行
• 日志
• Docker下运行

安装

各系统的安装包可于官网http://nginx.org/en/download.html下载。

Windows下安装

从http://nginx.org/download/nginx-1.16.1.zip下载安装包，并解压，解压目录即为安装目录。

Linux下安装

1. 创建用户：

   sudo groupadd nginxd
   sudo useradd -g nginxd nginxd
   

2. 创建安装目录：

   cd /usr/local
   sudo mkdir nginx
   sudo chown nginxd:nginxd nginx
   

3. 安装依赖库及nginx：

   • CentOS 7.5下安装nginx 1.16：

     sudo yum install pcre-devel
     sudo yum install zlib-devel
     sudo yum install openssl-devel
     
     # In any directory.
     wget http://nginx.org/download/nginx-1.16.1.tar.gz
     tar -xvz -f nginx-1.16.1.tar.gz
     cd nginx-1.16.1
     ./configure --prefix=/usr/local/nginx --with-http_stub_status_module --with-http_ssl_module --with-pcre
     make
     sudo make install
     # Do as you need.
     #rm nginx-1.16.1.tar.gz
     #rm -r nginx-1.16.1
     

   • Debian 8.9下安装nginx 1.16（CentOS 7.5下安装nginx 1.16也适用）：

     cd /usr/local/src
     sudo wget https://ftp.pcre.org/pub/pcre/pcre-8.44.tar.gz
     sudo wget http://www.zlib.net/zlib-1.2.11.tar.gz
     sudo wget https://www.openssl.org/source/openssl-1.1.1f.tar.gz
     sudo tar -xvz -f pcre-8.44.tar.gz
     sudo tar -xvz -f zlib-1.2.11.tar.gz
     sudo tar -xvz -f openssl-1.1.1f.tar.gz
     # Do as you need.
     #sudo rm pcre-8.44.tar.gz zlib-1.2.11.tar.gz openssl-1.1.1f.tar.gz
     
     # In any directory.
     wget http://nginx.org/download/nginx-1.16.1.tar.gz
     tar -xvz -f nginx-1.16.1.tar.gz
     cd nginx-1.16.1
     ./configure --prefix=/usr/local/nginx --with-http_stub_status_module --with-http_ssl_module \
     	--with-openssl=/usr/local/src/openssl-1.1.1f --with-zlib=/usr/local/src/zlib-1.2.11 --with-pcre=/usr/local/src/pcre-8.44
     make
     sudo make install
     # Do as you need.
     #rm nginx-1.16.1.tar.gz
     #rm -r nginx-1.16.1
     

   • Debian 10下安装nginx1.20.2：

     # In any directory.
     wget http://nginx.org/download/nginx-1.20.2.tar.gz
     tar -xvz -f nginx-1.20.2.tar.gz
     cd nginx-1.20.2
     ./configure --prefix=/usr/local/nginx --with-http_stub_status_module --with-http_ssl_module --with-pcre
     make
     sudo make install
     # Do as you need.
     #rm nginx-1.20.2.tar.gz
     #rm -r nginx-1.20.2
     

   ./configure参数含义如下：

   • --prefix：安装目录。
   • --with-http_ssl_module：SSL模块，用于支持SSL，需要安装依赖openssl。
   • --with-http_stub_status_module：监控模块，用于监控nginx状态。
   • --with-pcre：PCRE模块，用于支持正则表达式，需要安装依赖pcre。
   • --with-zlib：ZLIB模块，用于支持压缩算法，需安装依赖zlib。

   注意make install会覆盖此前安装的所有文件，包括配置文件。

4. 权限配置：

   sudo chown -R nginxd:nginxd /usr/local/nginx
   

   在/usr/local/nginx/conf/nginx.conf开头增加一行：

   user nginxd;
   

运行

需先进入安装目录。

运行nginx时不使用参数，会启动nginx服务，包含主进程和工作进程两个nginx进程。

运行nginx时也可使用以下参数：

• -?, -h：查看帮助。
• -c filename：设置配置文件名（默认为conf/nginx.conf）。
• -g directives：设置配置文件之外的全局指令。
• -p prefix：设置路径前缀（默认无）。
• -q：检查配置期间禁止打印非错误消息。
• -s signal：发送信号至主进程，signal可为：
  • stop：强制停止服务。
  • quit：优雅退出服务。
  • reopen：打开新的日志文件。需要先重命名原来的日志文件。
  • reload：重新加载配置文件，服务不会中止。
• -t：检查配置后退出。
• -T：检查配置，转储后退出。
• -v：打印版本后退出。
• -V：打印版本和configure编译配置参数后退出。

日志

请求日志为安装目录下的logs/access.log。

请求日志使用组合日志格式，各字段依次为：

1. 客户端主机名或IP。
2. ident查找的用户名。
3. 已认证的用户名。
4. 日期时间，以“[]”扩起。
5. 请求行，以“""”引起。
6. 响应状态码。
7. 响应Content-Length，如无则为0。
8. 请求Referer。
9. 请求User-Agent。

Docker下运行

docker container create --network host --name nginx nginx
docker start nginx

容器中的目录结构：

• /etc/nginx/：配置文件、证书文件目录。
  • nginx.conf：配置文件。
  • cert/：证书文件目录。
• /usr/sbin/nginx：可执行文件。
• /usr/share/nginx/html：静态文件目录。

在容器中执行nginx命令，如：

docker container exec -it nginx nginx -t