Nginx Windows 详细安装部署教程

2024-12
日	一	二	三	四	五	六
	2	3	4	5	6	7
8	9	10	11	12	13	14
15	16	17	18	19	20	21
22	23	24	25	26	27	28
29	30	31

一. Nginx 简介

Nginx (engine x) 是一个高性能的 HTTP 和反向代理服务器，也是一个 IMAP/POP3/SMTP 服务器。Nginx 是由伊戈尔·赛索耶夫为俄罗斯访问量第二的 Rambler.ru 站点（俄文：Рамблер）开发的.

它也是一种轻量级的 Web 服务器，可以作为独立的服务器部署网站（类似 Tomcat）。它高性能和低消耗内存的结构受到很多大公司青睐，如淘宝网站架设。

先下载直接去官网 nginx.org

nginx 下载

分别有 Linux 和 Windows 两个版本

nginx Windows

点击后就会下载，下载完成后开始安装，其实官网已经告诉了如何安装，右侧“documentation -> nginx windows”就有详细的说明，只是英文而已

二. 安装部署

1. 解压

不要直接双击 nginx.exe

下载完成后，解压缩，运行 cmd，使用命令进行操作。

一定要在 dos 窗口启动，不要直接双击 nginx.exe，这样会导致修改配置后重启、停止 nginx 无效，需要手动关闭任务管理器内的所有 nginx 进程，再启动才可以

2. 使用命令到达 nginx 的加压缩后的目录

cd c:\\nginx-1.25.2

3、启动 nginx 服务，启动时会一闪而过是正常的

start nginx

4、查看任务进程是否存在

dos 方式查询

tasklist /fi "imagename eq nginx.exe"

nginx进程

任务管理器查询，开详细信息里面能看到隐藏的 nginx.exe 进程，在进程中是看不到 nginx.exe 的进程（双击 nginx.exe 时会显示在这里）

nginx进程

如果都没有可能是启动报错了，查看一下日志，在 nginx 目录中的 logs 文件夹下 error.log 是日志文件

nginx报错日志

5、常见报错处理

常见的错误：

(1)端口号被占用

(2)nginx文件夹路径含中文

其他错误就详细看 error.log 中的描述。

修改配置文件，进入解压缩目录，直接文件夹点击进去即可

nginx目录

在 conf 目录下找到 nginx.conf 使用 txt 文本打开即可，找到 server 这个节点，修改端口号，如果有需求可以修改主页目录没有就不用修改

nginx.conf

这里需要测试下 vue 项目，所以配置为

listen       80;
server_name  localhost;

#charset koi8-r;

#access_log  logs/host.access.log  main;

location / {
    #root   html;
    root    D:\Workspace\Web\VC4Code\project-two\dist;
    index  index.html index.htm;
    try_files $uri $uri/ @router; # 解决vue页面刷新404问题
}

location @router {
    rewrite ^.*$ /index.html last; # Vue项目路由不是真实存在的
}

#error_page  404              /404.html;

修改完成后保存，使用以下命令检查一下配置文件是否正确，后面是 nginx.conf 文件的路径，successful 就说明正确了

nginx -t -c /nginx-1.25.2/conf/nginx.conf

如果程序没启动就直接 start nginx 启动，如果已经启动了就使用以下命令重新加载配置文件并重启

nginx -s reload

之后就打开浏览器访问刚才的域名及端口 http://localhost:8800，出现欢迎页就说明部署成功了

6、关闭命令

nginx 服务使用以下命令，同样也是一闪而过是正常的，看一下是否进程已消失即可

快速停止

nginx -s stop

完整有序的关闭

nginx -s quit

三. 优化配置

打开 nginx.conf 按照自己需求进行配置，下面列出简单的一些常规调优配置

#user  nobody;

#==工作进程数，一般设置为cpu核心数
worker_processes  1; #error_log  logs/error.log; #error_log  logs/error.log  notice; #error_log  logs/error.log  info;

#pid        logs/nginx.pid;
 events { #==最大连接数，一般设置为cpu*2048
    worker_connections  1024;
}


http {
    include       mime.types;
    default_type  application/octet-stream; #log\_format  main  '$remote\_addr - $remote\_user \[$time\_local\] "$request" '
    # '$status $body\_bytes\_sent "$http_referer" '
    # '"$http\_user\_agent" "$http\_x\_forwarded_for"';

    #access_log  logs/access.log  main;
 sendfile        on; #tcp_nopush     on;

    #keepalive_timeout  0;

    #==客户端链接超时时间
    keepalive_timeout  65; #gzip  on;

    #当配置多个server节点时，默认server names的缓存区大小就不够了，需要手动设置大一点
    server\_names\_hash\_bucket\_size 512; #server表示虚拟主机可以理解为一个站点，可以配置多个server节点搭建多个站点
    #每一个请求进来确定使用哪个server由server_name确定
 server { #站点监听端口
        listen       8800; #站点访问域名
 server_name  localhost; #编码格式，避免url参数乱码
        charset utf-8; #access_log  logs/host.access.log  main;

        #location用来匹配同一域名下多个URI的访问规则
        #比如动态资源如何跳转，静态资源如何跳转等
        #location后面跟着的/代表匹配规则
        location / { #站点根目录，可以是相对路径，也可以使绝对路径
 root   html; #默认主页
 index  index.html index.htm; #转发后端站点地址，一般用于做软负载，轮询后端服务器
            #proxy_pass http://10.11.12.237:8080;

            #拒绝请求，返回403，一般用于某些目录禁止访问
            #deny all;

            #允许请求
            #allow all;
 add_header 'Access-Control-Allow-Origin' '*';
            add_header 'Access-Control-Allow-Credentials' 'true';
            add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
            add_header 'Access-Control-Allow-Headers' 'DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type'; #重新定义或者添加发往后端服务器的请求头
            #给请求头中添加客户请求主机名
 proxy\_set\_header Host $host; #给请求头中添加客户端IP
            proxy\_set\_header X-Real-IP $remote_addr; #将$remote\_addr变量值添加在客户端“X-Forwarded-For”请求头的后面，并以逗号分隔。 如果客户端请求未携带“X-Forwarded-For”请求头，$proxy\_add\_x\_forwarded\_for变量值将与$remote\_addr变量相同
            proxy\_set\_header X-Forwarded-For $proxy\_add\_x\_forwarded\_for; #给请求头中添加客户端的Cookie
 proxy\_set\_header Cookie $http_cookie; #将使用代理服务器的主域名和端口号来替换。如果端口是80，可以不加。
 proxy_redirect off; #浏览器对 Cookie 有很多限制，如果 Cookie 的 Domain 部分与当前页面的 Domain 不匹配就无法写入。
            #所以如果请求 A 域名，服务器 proxy_pass 到 B 域名，然后 B 服务器输出 Domian=B 的 Cookie，
            #前端的页面依然停留在 A 域名上，于是浏览器就无法将 Cookie 写入。

　　         #不仅是域名，浏览器对 Path 也有限制。我们经常会 proxy_pass 到目标服务器的某个 Path 下，
            #不把这个 Path 暴露给浏览器。这时候如果目标服务器的 Cookie 写死了 Path 也会出现 Cookie 无法写入的问题。

            #设置“Set-Cookie”响应头中的domain属性的替换文本，其值可以为一个字符串、正则表达式的模式或一个引用的变量
            #转发后端服务器如果需要Cookie则需要将cookie domain也进行转换，否则前端域名与后端域名不一致cookie就会无法存取
　　　　　　  #配置规则：proxy\_cookie\_domain serverDomain(后端服务器域) nginxDomain(nginx服务器域)
 proxy\_cookie\_domain localhost .testcaigou800.com; #取消当前配置级别的所有proxy\_cookie\_domain指令
            #proxy\_cookie\_domain off;
            #与后端服务器建立连接的超时时间。一般不可能大于75秒；
            proxy\_connect\_timeout 30;
        } #error_page  404              /404.html;

        # redirect server error pages to the static page /50x.html
        #
        error_page   500 502 503 504  /50x.html;
        location = /50x.html {
            root   html;
        }

    }

　　#当需要对同一端口监听多个域名时，使用如下配置，端口相同域名不同，server_name也可以使用正则进行配置
　　#但要注意server过多需要手动扩大server\_names\_hash\_bucket\_size缓存区大小
server {
　　　　listen 80;
　　　　server_name www.abc.com;
　　　　charset utf-8;
　　　　location / {
　　　　　　proxy_pass http://localhost:10001;
　　　　}
　　}
　　server {
　　　　listen 80;
　　　　server_name aaa.abc.com;
　　　　charset utf-8;
　　　　location / {
　　　　　　proxy_pass http://localhost:20002;
　　　　}
　　}
}

推荐