移动 > 阿里

Nginx(自定义/预定义)变量,alias虚拟目录解读

10人参与 • 2025-07-03 • 阿里

1. nginx 变量简介

所有的 nginx变量在 nginx 配置文件中引用时都须带上 $ 前缀

在 nginx 配置中，变量只能存放一种类型的值，而且也只存在一种类型，那就是字符串类型

所有的变量值都可以通过这种方式引用 $变量名

2. nginx 变量的定义和使用

nginx中的变量分为两种，自定义变量与内置预定义变量

2.1. 自定义变量

1、声明变量可以在sever,http,location等标签中使用set命令声明变量，语法如下：

set $变量名 变量值

注意：

nginx安装echo模块

//查看已经安装的nginx的版本
[root@localhost ~]# nginx -v
nginx version: nginx/1.24.0

//上传或者下载一个相同版本的nginx包
[root@localhost ~]# wget http://nginx.org/download/nginx-1.24.0.tar.gz
//下载echo模块的安装包
[root@localhost ~]# wget https://github.com/openresty/echo-nginx-module/archive/refs/tags/v0.63.tar.gz
[root@localhost ~]# ls
anaconda-ks.cfg  nginx-1.24.0.tar.gz  v0.63.tar.gz
//解压到相同路径下：
[root@localhost ~]# tar xzvf nginx-1.24.0.tar.gz -c /usr/local/
[root@localhost ~]# tar xzvf v0.63.tar.gz -c /usr/local/
//安装编译工具
[root@localhost ~]# cd /usr/local/
[root@localhost local]# yum -y install pcre pcre-devel openssl openssl-devel gcc gcc-c++   zlib zlib-devel gd-devel

//添加模块：
[root@localhost local]# cd nginx-1.24.0/

//添加上原来已经有的参数和新添加的模块:
[root@localhost nginx-1.24.0]# ./configure  --prefix=/etc/nginx --sbin-path=/usr/sbin/nginx --modules-path=/usr/lib64/nginx/modules --conf-path=/etc/nginx/nginx.conf --error-log-path=/var/log/nginx/error.log --http-log-path=/var/log/nginx/access.log --pid-path=/var/run/nginx.pid --lock-path=/var/run/nginx.lock --http-client-body-temp-path=/var/cache/nginx/client_temp --http-proxy-temp-path=/var/cache/nginx/proxy_temp --http-fastcgi-temp-path=/var/cache/nginx/fastcgi_temp --http-uwsgi-temp-path=/var/cache/nginx/uwsgi_temp --http-scgi-temp-path=/var/cache/nginx/scgi_temp --user=nginx --group=nginx --with-compat --with-file-aio --with-threads --with-http_addition_module --with-http_auth_request_module --with-http_dav_module --with-http_flv_module --with-http_gunzip_module --with-http_gzip_static_module --with-http_mp4_module --with-http_random_index_module --with-http_realip_module --with-http_secure_link_module --with-http_slice_module --with-http_ssl_module --with-http_stub_status_module --with-http_sub_module --with-http_v2_module --with-mail --with-mail_ssl_module --with-stream --with-stream_realip_module --with-stream_ssl_module --with-stream_ssl_preread_module --with-cc-opt='-o2 -g -pipe -wall -wp,-d_fortify_source=2 -fexceptions -fstack-protector-strong --param=ssp-buffer-size=4 -grecord-gcc-switches -m64 -mtune=generic -fpic' --with-ld-opt='-wl,-z,relro -wl,-z,now -pie' --add-module=/usr/local/echo-nginx-module-0.63

//编译，千万不要make install 否则会覆盖原来的文件
[root@localhost nginx-1.24.0]# make
//将原来的nignx二进制文件备份
[root@localhost nginx-1.24.0]# mv /usr/sbin/nginx /usr/sbin/nginx_bak 
//拷贝替换新的nignx二进制文件
[root@localhost nginx-1.24.0]# cp objs/nginx /usr/sbin/  
[root@localhost nginx-1.24.0]# systemctl restart nginx    //重启nginx
//查看模块是否添加成功
[root@localhost nginx-1.24.0]# nginx -v
nginx version: nginx/1.24.0
built by gcc 4.8.5 20150623 (red hat 4.8.5-44) (gcc) 
built with openssl 1.0.2k-fips  26 jan 2017
tls sni support enabled
configure arguments: --prefix=/etc/nginx --sbin-path=/usr/sbin/nginx --modules-path=/usr/lib64/nginx/modules --conf-path=/etc/nginx/nginx.conf --error-log-path=/var/log/nginx/error.log --http-log-path=/var/log/nginx/access.log --pid-path=/var/run/nginx.pid --lock-path=/var/run/nginx.lock --http-client-body-temp-path=/var/cache/nginx/client_temp --http-proxy-temp-path=/var/cache/nginx/proxy_temp --http-fastcgi-temp-path=/var/cache/nginx/fastcgi_temp --http-uwsgi-temp-path=/var/cache/nginx/uwsgi_temp --http-scgi-temp-path=/var/cache/nginx/scgi_temp --user=nginx --group=nginx --with-compat --with-file-aio --with-threads --with-http_addition_module --with-http_auth_request_module --with-http_dav_module --with-http_flv_module --with-http_gunzip_module --with-http_gzip_static_module --with-http_mp4_module --with-http_random_index_module --with-http_realip_module --with-http_secure_link_module --with-http_slice_module --with-http_ssl_module --with-http_stub_status_module --with-http_sub_module --with-http_v2_module --with-mail --with-mail_ssl_module --with-stream --with-stream_realip_module --with-stream_ssl_module --with-stream_ssl_preread_module --with-cc-opt='-o2 -g -pipe -wall -wp,-d_fortify_source=2 -fexceptions -fstack-protector-strong --param=ssp-buffer-size=4 -grecord-gcc-switches -m64 -mtune=generic -fpic' --with-ld-opt='-wl,-z,relro -wl,-z,now -pie' --add-module=/usr/local/echo-nginx-module-0.63

2、配置 $foo=hello

[root@localhost ~]# cd /etc/nginx/conf.d/
[root@localhost conf.d]# vim echo.conf
server {
        listen 80;
        server_name     localhost;
        location /test {
                set $foo hello;
                echo "foo: $foo";
        }
}
[root@localhost conf.d]# nginx -t
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
[root@localhost conf.d]# systemctl restart nginx
//访问测试
[root@localhost conf.d]# curl  http://localhost/test
foo: hello

nginx 变量的创建只能发生在 nginx 配置加载的时候，或者说 nginx 启动的时候。

而赋值操作则只会发生在请求实际处理的时候。这意味着不创建变量，直接使用变量会导致启动失败。

2.2. 内置预定义变量

内置预定义变量即无需声明就可以使用的变量，通常包括一个 http 请求或响应中一部分内容的值，以下为一些常用的内置预定义变量

变量名定义
$arg_parameterget请求中变量名parameter参数的值。
$args这个变量等于get请求中的参数。例如，foo=123&bar=blahblah;这个变量只可以被修改。
$binary_remote_addr二进制码形式的客户端地址。
$body_bytes_sent传送页面的字节数。
$content_length请求头中的content-length字段。
$content_type请求头中的content-type字段。
$cookie_cookiecookie cookie的值。
$document_root当前请求在root指令中指定的值。
$document_uri与$uri相同。
$host请求中的主机头(host)字段，如果请求中的主机头不可用或者空，则为处理请求的server名称(处理请求的server的server_name指令的值)。值为小写，不包含端口。
$hostname机器名使用 gethostname系统调用的值
$http_headerhttp请求头中的内容，header为http请求中的内容转为小写，-变为_(破折号变为下划线)，例如：$http_user_agent(uaer-agent的值)。
$sent_http_headerhttp响应头中的内容，header为http响应中的内容转为小写，-变为_(破折号变为下划线)，例如： $sent_http_cache_control, $sent_http_content_type…;
$is_args如果$args设置，值为"?“，否则为”"。
$limit_rate这个变量可以限制连接速率。
$nginx_version当前运行的nginx版本号。
$query_string与$args相同。
$remote_addr客户端的ip地址。
$remote_port客户端的端口。
$remote_user已经经过auth basic module验证的用户名。
$request_filename当前连接请求的文件路径，由root或alias指令与uri请求生成。
$request_body这个变量（0.7.58+）包含请求的主要信息。在使用proxy_pass或fastcgi_pass指令的location中比较有意义。
$request_body_file客户端请求主体信息的临时文件名。
$request_completion如果请求成功，设为"ok"；如果请求未完成或者不是一系列请求中最后一部分则设为空。
$request_method这个变量是客户端请求的动作，通常为get或post。包括0.8.20及之前的版本中，这个变量总为main request中的动作，如果当前请求是一个子请求，并不使用这个当前请求的动作。
$request_uri这个变量等于包含一些客户端请求参数的原始uri，它无法修改，请查看$uri更改或重写uri。
$scheme所用的协议，比如http或者是https，比如rewrite ^(.+)$ $scheme://example.com$1 redirect。
$server_addr服务器地址，在完成一次系统调用后可以确定这个值，如果要绕开系统调用，则必须在listen中指定地址并且使用bind参数。
$server_name服务器名称。
$server_port请求到达服务器的端口号。
$server_protocol请求使用的协议，通常是http/1.0或http/1.1。
$uri请求中的当前uri(不带请求参数，参数位于args)，不同于浏览器传递的args)，不同于浏览器传递的args)，不同于浏览器传递的request_uri的值，它可以通过内部重定向，或者使用index指令进行修改。不包括协议和主机名，例如/foo/bar.html

3. nginx alias 虚拟目录（拓展）

使用alias标签的目录块中不能使用 rewrite 的 break 。

server {
        listen 80;
        server_name localhost;

        location /test {
                root /var/www/html;
                index index.html;
        }
        location /qfedu {
                alias /var/www/nginx; 
        #访问http://x.x.x.x/qfedu时实际上访问是/var/www/nginx/index.html
                index index.html;
        }
}

//创建location匹配的目录和文件
[root@localhost ~]# mkdir /var/www/html/test
[root@localhost ~]# echo "location /test" >> /var/www/html/test/index.html

//创建alias匹配的目录和文件
[root@localhost ~]# mkdir /var/www/nginx
[root@localhost ~]# echo "alias /qfedu" >> /var/www/nginx/index.html

[root@localhost ~]# nginx -t
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
[root@localhost ~]# systemctl restart nginx

root 和 alias 的主要区别是：

总结

以上为个人经验，希望能给大家一个参考，也希望大家多多支持代码网。

赞 (0)

您想发表意见！！点此发布评论

推荐阅读

Nginx安装和配置过程(yum安装和编译安装)

Nginx安装和配置过程(yum安装和编译安装)

07-03

nginx变量的使用详解

07-03

Nginx日志配置的使用及说明

07-03

解读Nginx变量字段大全

07-03

Nginx的预定义变量方式

07-03

在Ubuntu 24.04(Noble)上配置阿里源的操作步骤

07-03

猜你喜欢

版权声明：本文内容由互联网用户贡献，该文观点仅代表作者本人。本站仅提供信息存储服务，不拥有所有权，不承担相关法律责任。 如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 2386932994@qq.com 举报，一经查实将立刻删除。

发表评论