安装Nginx
添加Nginx源
1 | rpm -ivh http://nginx.org/packages/centos/7/noarch/RPMS/nginx-release-centos-7-0.el7.ngx.noarch.rpm |
查询
1 | yum list nginx |
安装
1 | yum install -y nginx |
卸载
1 | yum -y remove nginx* |
启动
1 | service nginx start |
停止
1 | service nginx stop |
设为开机启动
1 | chkconfig nginx on |
或
1 | systemctl enable nginx.service |
查看服务是否开机自启
1 | systemctl is-enabled nginx |
重新加载配置
1 | nginx -t |
查看版本
1 | nginx -v |
配置文件路径/etc/nginx/conf.d
Nginx配置生效
查看配置是否可用
1 | nginx -t |
重新加载配置
1 | nginx -s reload |
常见场景
静态网站
1 | server { |
静态页面+SSL
文件_www.psvmc.cn.conf
1 | server { |
Vue history模式
在使用 Vue 的 history
模式时,由于前端路由是通过修改 URL 来实现的,所以在部署到服务器上时,需要进行一些特殊的配置才能确保正常访问。
以下是一个常见的配置流程:
Nginx添加配置:
在 Nginx 的配置文件中,添加一个用于处理前端路由的 location 配置,
如下所示:
1 | location / { |
这个配置将会重定向所有请求到 index.html
,这样访问任何一个路由都会返回同一个首页。
然后 Vue Router 会根据 URL 来动态加载相应的组件。
保存并重新启动 Nginx 服务,使配置生效。
禁用缓存
前端项目使用VUE开发的都是单页,也就是只有一个html文件,但是每次更新可能因为用户缓存,而无法正常访问,所以建议html不进行缓存。
如果HTML文件较小建议直接禁用缓存
1 | # html不缓存 解决前端更新缓存问题 |
如果HTML文件较大建议使用协商方式
1 | # html协商缓存 解决前端更新缓存问题 |
对比:
Pragma: no-cache:和Cache-Control: no-cache区别
Pragma: no-cache
跟Cache-Control: no-cache
作用相同Pragma: no-cache
可以应用到http 1.0 和http 1.1Cache-Control: no-cache
只能应用于http 1.1.
Cache-Control: no-cache和Cache-Control: no-store区别
看字面意思容易误解,no-cache就是不缓存,但是no-cache并不是不缓存,而是使用协商缓存,所以并不能禁止缓存,no-store才是真正的禁止缓存。
从节省带宽角度讲,使用no-cache更优一点,文件未发生改变时只传输很小的报文大小,只有在文件改变时才会传输整个文件大小。而不是no-store不管什么情况都传输整个文件大小。
反代接口
1 | server { |
反代WS
1 | upstream imtest_xhkjedu { |
相比之前配置的HTTP代理 主要增加了以下配置
1 | proxy_http_version 1.1; |
无法获取IP
1 | location /ws/ { |
注意
只有建立连接的时候才能获取到IP。
获取IP
1 | ws.on('connection', function connection(ws, req) { |
Java
1 | String address = session.remoteAddress().toString(); |
分别取到的地址为
address: 127.0.0.1:48630
host: sockettest2.xhkjedu.com
xrealip: 123.14.108.207
xforwardedfor: 123.14.108.207
其中X-Real-IP
和X-Forwarded-For
获取到的是用户的IP。
负载均衡
1 | upstream a_psvmc { |
动静分离
1 | upstream filetest_psvmc { |
注意
20行的代码root的路径
不要
配置为/data/wwwjarapi/8905xhkjfileapitest/static/
否则会在
static
文件夹下再查找static
文件夹
正向代理
1 | server { |
测试
1 | curl -I --proxy 192.168.10.10:1080 www.baidu.com |
代理Mysql/远程连接/SSH
详细文章查看:https://www.psvmc.cn/article/2020-12-31-nginx-tcp.html
配置:
1 | stream { |
注意该配置要和http
同级
大文件上传
1 | client_max_body_size 1000m; |
每个参数的意思:
client_max_body_size
限制请求体的大小,若超过所设定的大小,返回413错误。
client_header_timeout
读取请求头的超时时间,若超过所设定的大小,返回408错误。
client_body_timeout
读取请求实体的超时时间,若超过所设定的大小,返回413错误。
proxy_connect_timeout
http请求无法立即被容器(tomcat, netty等)处理,被放在nginx的待处理池中等待被处理。
此参数为等待的最长时间,默认为60秒,官方推荐最长不要超过75秒。
proxy_read_timeout
http请求被容器(tomcat, netty等)处理后,nginx会等待处理结果,也就是容器返回的response。
此参数即为服务器响应时间,默认60秒。
proxy_send_timeout
http请求被服务器处理完后,把数据传返回给Nginx的用时,默认60秒。
send_timeout
服务器把结果返回的时间
大文件上传费时的是文件到代理服务器(Nginx)的时间,所以
proxy_xxx
相关的时间不用配置的过长
文件下载
1 | location /download/ { |
关键语句
add_header ‘Content-Type’ ‘application/octet-stream’;
重定向
GET请求
301重定向
1 | location = /static/应用.apk { |
规则路径是可以支持中文的。
重写
主要用于地址迁移 重定向到新的地址
1 | server { |
主要配置是
1 | location /userapi/login { |
注意
rewrite是302重定向,会把post请求重定向为get请求。
POST请求
307重定向
- 301 永久重定向,告诉客户端以后应从新地址访问.
- 302 作为HTTP1.0的标准,以前叫做Moved Temporarily ,现在叫Found. 现在使用只是为了兼容性的处理,包括PHP的默认Location重定向用的也是302.
但是HTTP 1.1 有303 和307作为详细的补充,其实是对302的细化
- 303:对于POST请求,它表示请求已经被处理,客户端可以接着使用GET方法去请求Location里的URI。
- 307:对于POST请求,表示请求还没有被处理,客户端应该向Location里的URI重新发起POST请求。
大部分浏览器 302 会将 POST 请求转为 GET
1 | location ~ ^/userapi/login { |
反代
1 | location ~ ^/userapi/login { |
SSL相关
SSL配置
在/etc/nginx/cert
目录放入证书文件
- psvmc.pem
- psvmc.key
Nginx的配置文件添加如下配置
1 | listen 443; |
配置完成后基本如下
1 | upstream test_psvmc { |
重启
1 | nginx -t |
HTTP自动跳转HTTPS
方式1:使用return
1 | server { |
如果此时nginx作为Tomcat的前端反向代理的话,需要将相应配置放在配置ssl的server块中。
方式2:使用rewrite
1 | server { |
如果此时nginx作为Tomcat的前端反向代理的话,需要将相应配置放在配置ssl的server块中。
方式3:使用error_page
只允许HTTP来访问时,用HTTP访问会让Nginx报497错误,然后利用error_page将链接重定向至HTTPS上。
1 | server { |
使用error_page指令时,将http和https的监听配置写在同一个server块中,对应的其他配置也需要在该server配置块中完成。
需要注意的是,此时需要将error_page
指令语句写在最后,否则不能生效。
日志
默认位置
使用yum安装的Nginx的默认日志位置
1 | cd /var/log/nginx |
示例
创建文件夹
1 | mkdir /etc/nginx/logs/ |
项目对应的配置文件中
1 | server { |
错误日志
1 | error_log <FILE> <LEVEL>; |
关键字:其中关键字error_log不能改变
日志文件:可以指定任意存放日志的目录
错误日志级别:常见的错误日志级别有[debug | info | notice | warn | error | crit | alert | emerg],级别越高记录的信息越少。
生产场景一般是 warn | error | crit 这三个级别之一
关闭错误日志
只禁用无法找到的错误日志
1 | log_not_found off; |
禁用所有错误日志
error_log off
并不能关闭日志记录功能,它将日志文件写入一个文件名为off的文件中,如果你想关闭错误日志记录功能,应使用以下配置:
把存储位置设置到Linux的黑洞中去
1 | error_log /dev/null crit; |
访问日志
默认
1 | http { |
其中main
是定义日志格式化方式的名称log_format main
关闭访问日志
1 | access_log off; |
常见错误
端口无法绑定
nginx: [emerg] bind() to 0.0.0.0:8091 failed (13: Permission denied)
是开启selinux 导致的
查看状态 如果输出 disabled
或 Permissive
那就是关闭了
如果输出 Enforcing
那就是开启了 selinux
1 | getenforce |
临时关闭
1 | # 临时关闭 |
永久关闭
修改/etc/selinux/config
文件
1 | vi /etc/selinux/config |
将
1 | SELINUX=enforcing |
改为
1 | SELINUX=disabled |
立即生效
1 | source /etc/selinux/config |
静态项目访问403
编辑配置文件
1 | vi /etc/nginx/nginx.conf |
修改内容
用户修改为root 默认是nginx
1 | user root; |
输入
1 | getenforce |
出现Enforcing
表示已强制执行安全策略了
配置关闭
1 | vi /etc/selinux/config |
修改为disable
SELINUX=disabled
重启
1 | reboot |
全局变量
全局变量
- $args : 这个变量等于请求行中的参数,同$query_string
- $content_length : 请求头中的Content-length字段。
- $content_type : 请求头中的Content-Type字段。
- $document_root : 当前请求在root指令中指定的值。
- $host : 请求主机头字段,否则为服务器名称。
- $http_user_agent : 客户端agent信息
- $http_cookie : 客户端cookie信息
- $limit_rate : 这个变量可以限制连接速率。
- $request_method : 客户端请求的动作,通常为GET或POST。
- $remote_addr : 客户端的IP地址。
- $remote_port : 客户端的端口。
- $remote_user : 已经经过Auth Basic Module验证的用户名。
- $request_filename : 当前请求的文件路径,由root或alias指令与URI请求生成。
- $scheme : HTTP方法(如http,https)。
- $server_protocol : 请求使用的协议,通常是HTTP/1.0或HTTP/1.1。
- $server_addr : 服务器地址,在完成一次系统调用后可以确定这个值。
- $server_name : 服务器名称。
- $server_port : 请求到达服务器的端口号。
- $request_uri : 包含请求参数的原始URI,不包含主机名,如:”/foo/bar.php?arg=baz”。
- $uri : 不带请求参数的当前URI,$uri不包含主机名,如”/foo/bar.html”。
- $document_uri : 与$uri相同。
例:
http://localhost:88/test1/test2/test.php
1 | $host:localhost |
location
基本语法
1 | location [=|~|~*|^~|@] pattern{……} |
- = 严格匹配。如果这个查询匹配,那么将停止搜索并立即处理此请求。
- ~ 匹配区分大小写的定的正则表达式
- ~* 匹配不区分大小写的定的正则表达式
- ^~ 类似于无修饰符的行为,也是以指定模式开始,不同的是,如果模式匹配,
那么就停止搜索其他模式了 - !~ 不匹配区分大小写的定的正则表达式
- !~* 不匹配不区分大小写的定的正则表达式
示例
1 | location = / { |
各请求的处理如下例:
- / → configuration A
- /documents/document.html → configuration B
- /images/1.gif → configuration C
- /documents/1.jpg → configuration D
查找顺序
模式 | 含义 |
---|---|
location = /uri | = 表示精确匹配,只有完全匹配上才能生效 |
location ^~ /uri | ^~ 开头对URL路径进行前缀匹配,并且在正则之前。 |
location ~ pattern | 开头表示区分大小写的正则匹配 |
location ~* pattern | 开头表示不区分大小写的正则匹配 |
location /uri | 不带任何修饰符,也表示前缀匹配,但是在正则匹配之后 |
location / | 通用匹配,任何未匹配到其它location的请求都会匹配到,相当于switch中的default |
优先级
- 精确匹配
=
- 前缀匹配
^~
- 按文件中从前到后顺序的正则匹配
- 匹配不带任何修饰的前缀匹配
- 交给
/
通用匹配 - 当有匹配成功时候,停止匹配,按当前匹配规则处理请求
root、alias指令区别
1 | location /img/ { |
区别
alias
是一个目录别名的定义,root
则是最上层目录的定义。alias
后面必须要用/
结束,否则会找不到文件的 而root
则可有可无