nginx配置及使用

偶尔会用到nginx部署项目，记录nginx配置备忘。主要有端口、地址及别名，代理转发和https配置。

配置文件为nginx.conf。

部署http项目：

1.找到http下的server配置项

端口和servername配置，即访问地址中http://localhost:9003

 listen       9003;
 server_name  localhost;

2.配置项目

项目结构如下

nginx增加location配置项：

         location /dist {
             root E:/code/02project/rt-poc;  # root 时 root路径＋location路径映射到服务器文件
             index index.html;
         }

访问地址为：http://localhost:9003/dist/index.html

         # alias 时 location代替root路径映射到服务器文件上
         location /webapp {
             alias E:/code/02project/rt-poc/dist;
             index index.html;
         }

访问地址为：http://localhost:9003/webapp/index.html

可以浏览文件

         #autoindex 开启后可以显示目录
         location /images {
             root   E:/code/00test/picture;
             autoindex on;
         }

代理转发

         # 代理转发
         location /my-web {
             proxy_pass  http://localhost:9003/dist;
         }

访问 http://localhost:9003/my-web/index.html  即跳转为   http://localhost:9003/dist/index.html

部署https项目：

1.找到https下的server配置项，设置默认的443端口及ssl证书地址，location配置和http一样，这里也可以转发http下的server，使其能以https的方式访问

        listen       443 ssl;
        server_name  localhost;

        ssl_certificate      E:/code/03server/nginx-1.16.0/ssl/nginx_https.crt;
        ssl_certificate_key  E:/code/03server/nginx-1.16.0/ssl/nginx_https.key;

转发http服务

 # 转发http服务，变为https
  location /tour {
      proxy_pass  http://localhost:9003/webapp;
 }

nginx相关命令：

 // window下 进入nginx目录，启动cmd
 start nginx               -- 启动
 nginx -s reload           -- 重载配置
 nginx -s quit             --退出
 nginx -s stop

nginx.conf文件完整内容，可参考进行配置。

 #user  nobody;
 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 {
     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 {
         listen       9003;
         server_name  localhost;

         #charset koi8-r;

         #access_log  logs/host.access.log  main;

         # location / {
         #     root   html;
         #     index  index.html;
         # }      

         #autoindex 开启后可以显示目录
         location /images {
             root   E:/code/00test/picture;
             autoindex on;
         }

         # alias 时 location代替root路径映射到服务器文件上
         location /tour {
             alias E:/code/02project/ni-tour/ni-tour-web/dist;
             index index.html;
         }

         # root 时 root路径＋location路径映射到服务器文件上
         location /dist {
             root E:/code/02project/smrt-poc/smrt-poc-tbox-html;
             index index.html;
         }

         # 代理转发
         location /smrt {
             proxy_pass  http://localhost:9003/dist;
         }

         location / {
             root   E:/code/00test/picture;
             autoindex on;
         }

         #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;
         }

         # proxy the PHP scripts to Apache listening on 127.0.0.1:80
         #
         #location ~ \.php$ {
         #    proxy_pass   http://127.0.0.1;
         #}

         # pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
         #
         #location ~ \.php$ {
         #    root           html;
         #    fastcgi_pass   127.0.0.1:9000;
         #    fastcgi_index  index.php;
         #    fastcgi_param  SCRIPT_FILENAME  /scripts$fastcgi_script_name;
         #    include        fastcgi_params;
         #}

         # deny access to .htaccess files, if Apache's document root
         # concurs with nginx's one
         #
         #location ~ /\.ht {
         #    deny  all;
         #}
     }

     # another virtual host using mix of IP-, name-, and port-based configuration
     # 可以监听不同的端口
     server {
        listen       9005;
        server_name  localhost;

        location /smrt {
             alias E:/code/02project/smrt-poc/smrt-poc-tbox-html/dist;
             index index.html;
         }
     }

     #HTTPS server
     server {
        listen       443 ssl;
        server_name  localhost;

        ssl_certificate      E:/code/03server/nginx-1.16.0/ssl/nginx_https.crt;
        ssl_certificate_key  E:/code/03server/nginx-1.16.0/ssl/nginx_https.key;

        ssl_session_cache    shared:SSL:1m;
        ssl_session_timeout  5m;

        ssl_ciphers  HIGH:!aNULL:!MD5;
        ssl_prefer_server_ciphers  on;

        location /images {
            root   E:/code/00test/picture;
            autoindex on;
        }

        location /smrt {
             alias E:/code/02project/smrt-poc/smrt-poc-tbox-html/dist;
             index index.html;
         }

         # 转发http服务，变为https
         location /tour {
             proxy_pass  http://localhost:9003/tour;
         }
     }

 }

配置https需要的ssl证书地址 可参考https://blog.csdn.net/sunroyfcb/article/details/83592553

缓存配置
server前添加如下配置项：

 proxy_cache_path /opt/map-web-model/map-web-buildings-cache levels=: keys_zone=buildingscache:10m max_size=10g inactive=300m use_temp_path=off;

相关配置说明如下：

• /path/to/cache 本地路径，用来设置Nginx缓存资源的存放地址
• levels 默认所有缓存文件都放在同一个/path/to/cache下，但是会影响缓存的性能，因此通常会在/path/to/cache下面建立子目录用来分别存放不同的文件。假设levels=1:2，Nginx为将要缓存的资源生成的key为f4cd0fbc769e94925ec5540b6a4136d0，那么key的最后一位0，以及倒数第2-3位6d作为两级的子目录，也就是该资源最终会被缓存到/path/to/cache/0/6d目录中
• key_zone 在共享内存中设置一块存储区域来存放缓存的key和metadata（类似使用次数），这样nginx可以快速判断一个request是否命中或者未命中缓存，1m可以存储8000个key，10m可以存储80000个key
• max_size 最大cache空间，如果不指定，会使用掉所有disk space，当达到配额后，会删除最少使用的cache文件
• inactive 未被访问文件在缓存中保留时间，本配置中如果60分钟未被访问则不论状态是否为expired，缓存控制程序会删掉文件。inactive默认是10分钟。需要注意的是，inactive和expired配置项的含义是不同的，expired只是缓存过期，但不会被删除，inactive是删除指定时间内未被访问的缓存文件
• use_temp_path 如果为off，则nginx会将缓存文件直接写入指定的cache文件中，而不是使用temp_path存储，official建议为off，避免文件在不同文件系统中不必要的拷贝
• proxy_cache 启用proxy cache，并指定key_zone。另外，如果proxy_cache off表示关闭掉缓存。

使用：

 location /buildings {
         proxy_cache buildingscache;
         alias /opt/map-web-model/buildings;
         autoindex off;
 }

常见错误
1.访问服务出现以下错误：
The 'Access-Control-Allow-Origin' header contains multiple values '*, *', but only one is allowed.
这种问题常见于nginx做代理，设置了add_header 'Access-Control-Allow-Origin' '*'; 
而被代理的服务本身已经设置了'Access-Control-Allow-Origin' '*';  会出现了header重复，删掉代理的即可。