转载自 http://blog.sina.com.cn/openresty
来看一个 ngx_static 模块服务磁盘文件的例子。我们使用下面这个配置片段：
location / {
root /var/www/;
}
同时在本机的 /var/www/ 目录下创建两个文件，一个文件叫做 index.html，内容是一行文本 this is my home；另一个文件叫做 hello.html，内容是一行文本 hello world. 同时注意这两个文件的权限设置，确保它们都对运行 Nginx worker 进程的系统帐户可读。
现在来通过 HTTP 协议请求一下这两个文件所对应的 URI：
$ curl 'http://localhost:8080/index.html'
this is my home
$ curl 'http://localhost:8080/hello.html'
hello world
我们看到，先前创建的那两个磁盘文件的内容被分别输出了。
不妨来分析一下这里发生的事情：location / 中没有使用运行在 content 阶段的模块指令，于是也就没有模块注册这个 location 的“内容处理程序”，处理权便自动落到了在 content 阶段“垫底”的那 3 个静态资源服务模块。首先运行的 ngx_index 和 ngx_autoindex 模块先后看到当前请求的 URI，/index.html 和 /hello.html，并不以 / 结尾，于是直接弃权，将处理权转给了最后运行的 ngx_static 模块。ngx_static 模块根据 root 指令指定的“文档根目录”（document root），分别将请求 URI /index.html 和 /hello.html 映射为文件系统路径 /var/www/index.html 和 /var/www/hello.html，在确认这两个文件存在后，将它们的内容分别作为响应体输出，并自动设置 Content-Type、Content-Length 以及 Last-Modified 等响应头。
为了确认 ngx_static 模块确实运行了，可以启用 （一） 中介绍过的 Nginx “调试日志”，然后再次请求 /index.html 这个接口。此时，在 Nginx 错误日志文件中可以看到类似下面这一行的调试信息：
[debug] 3033#0: *1 http static fd: 8
这一行信息便是 ngx_static 模块生成的，其含义是“正在输出的静态文件的描述符是数字 8”。当然，具体的文件描述符编号会经常发生变化，这里只是我机器的一次典型输出。值得一提的是，能生成这一行调试信息的还有标准模块 ngx_gzip_static ，但它默认是不启用的，后面会专门介绍到这个模块。
注意上面这个例子中使用的 root 配置指令只起到了声明“文档根目录”的作用，并不是它开启了 ngx_static 模块。ngx_static 模块总是处于开启状态，但是否轮得到它运行就要看 content 阶段先于它运行的那些模块是否“弃权”了。为了进一步确认这一点，来看下面这个空白 location 的定义：
location / {
}
因为没有配置 root 指令，所以在访问这个接口时，Nginx 会自动计算出一个缺省的“文档根目录”。该缺省值是取所谓的“配置前缀”（configure prefix）路径下的 html/ 子目录。举一个例子，假设“配置前缀”是 /foo/bah/，则缺省的“文档根目录”便是 /foo/bar/html/.
那么“配置前缀”是由什么来决定的呢？默认情况下，就是 Nginx 安装时的根目录（或者说 Nginx 构造时传递给 ./configure 脚本的 --prefix 选项的路径值）。如果 Nginx 安装到了 /usr/local/nginx/ 下，则“配置前缀”便是 /usr/local/nginx/，同时默认的“文档根目录”便是 /usr/local/nginx/html/. 不过，我们也可以在启动 Nginx 的时候，通过 --prefix 命令行选项临时指定自己的“配置前缀”路径。假设我们启动 Nginx 时使用的命令是
nginx -p /home/agentzh/test/
则对于该服务器实例，其“配置前缀”便是 /home/agentzh/test/，而默认的“文档根目录”便是 /home/agentzh/test/html/. “配置前缀”不仅会决定默认的“文档根目录”，还决定着 Nginx 配置文件中许多相对路径值如何解释为绝对路径，后面我们还会看到许多需要引用到“配置前缀”的例子。
获取当前“文档根目录”的路径有一个非常简便的方法，那就是请求一个肯定不存在的文件所对应的资源名，例如：
$ curl 'http://localhost:8080/blah-blah.txt'
<html>
<head><title>404 Not Found</title></head>
<body bgcolor="white">
<center><h1>404 Not Found</h1></center>
<hr><center>nginx</center>
</body>
</html>
我们会很自然地得到 404 错误页。此时再看 Nginx 错误日志文件，应该会看到类似下面这一行错误消息：
[error] 9364#0: *1 open() "/home/agentzh/test/html/blah-blah.txt" failed (2: No such file or directory)
这条错误消息是 ngx_static 模块打印出来的，因为它并不能在文件系统的对应路径上找到名为 blah-blah.txt 的文件。因为这条错误信息中包含有 ngx_static 试图打开的文件的绝对路径，所以从这个路径不难看出，当前的“文档根目录”是 /home/agentzh/test/html/.
很多初学者会想当然地把 404 错误理解为某个 location 不存在，其实上面这个例子表明，即使 location 存在并成功匹配，也是可能返回 404 错误页的。因为决定着 404 错误页的是抽象的“资源”是否存在，而非某个具体的 location 是否存在。
初学者常犯的一个错误是忘记配置 content 阶段的模块指令，而他们自己其实并不期望使用 content 阶段缺省运行的静态资源服务，例如：
location /auth {
access_by_lua '
-- a lot of Lua code omitted here...
';
}
显然，这个 /auth 接口只定义了 access 阶段的配置指令，即 access_by_lua，并未定义任何 content 阶段的配置指令。于是当我们请求 /auth 接口时，在 access 阶段的 Lua 代码会如期执行，然后 content 阶段的那些静态文件服务会紧接着自动发生作用，直至 ngx_static 模块去文件系统上找名为 auth 的文件。而经常地，404 错误页会抛出，除非运气太好，在对应路径上确实存在一个叫做 auth 的文件。所以，一条经验是，当遇到意外的 404 错误并且又不涉及静态文件服务时，应当首先检查是否在对应的 location 配置块中恰当地配置了 content 阶段的模块指令，例如 content_by_lua、 echo 以及 proxy_pass 之类。当然，Nginx 的 error.log 文件一般总是会提供各种意外问题的答案，例如对于上面这个例子，我的 error.log 中有下面这条错误信息：
[error] 9364#0: *1 open() "/home/agentzh/test/html/auth" failed (2: No such file or directory)
相关推荐
lua-upstream-nginx-module, Nginx C 模块将Lua向ngx_lua公开，用于 Nginx upstreams 电子邮件名称ngx_http_lua_upstream - Nginx MODULE，用于向 Nginx upstreams公开Lua到 ngx_lua目录NAME状态概要说明函数get_...
【Nginx 限制连接数 ngx_http_limit_conn_module 模块详解】 在互联网服务中，服务器经常面临流量异常、负载过大的情况，尤其在遭受大流量恶意攻击时，带宽的浪费、服务器压力的增大都会对业务造成严重影响。为了...
2. 配置Nginx：在编译Nginx时，需要将模块添加到配置选项中。例如，如果你已经下载了Nginx的源代码，可以使用`--add-module=路径/ngx_http_proxy_connect_module`命令行选项。 3. 编译和安装：运行`./configure`，...
ngx_cache_purge 是 nginx 模块，此模块可以清理 nginx 的 FastCGI、proxy、 SCGI 和 uWSGI 的缓存。配置指令（相同位置语法）fastcgi_cache_purgesyntax: fastcgi_cache_purge on|off|<method> [from all|<ip> [.....
ngx_sqlite 是嵌入 sqlite 数据库的 nginx 模块。通过强大的nginx server，可以使用http协议访问sqlite数据库。环境- sqlite 3- nginx-1.6.3 安装```sh $ git clone https://github.com/rryqszq4/ngx_sqlite.git...
这个版本2.4.2的压缩包包含了ngx_cache_purge模块的所有源代码及相关文件，以便开发者在自己的Nginx环境中集成和使用。 Nginx是一款高性能、轻量级的Web服务器和反向代理服务器，广泛应用于互联网服务。其内置的...
ngx_devel_kit（通常缩写为 NDK）是一个针对Nginx的模块开发工具集，它为构建自定义Nginx模块提供了便利。在Nginx生态系统中，NDK是一个重要的扩展工具，允许开发者利用C语言直接操作Nginx的内部结构，以实现更高级...
ngx_lua_module是一款强大的扩展模块，专为Nginx服务器设计，允许在Nginx配置文件中直接嵌入Lua脚本，极大地增强了Nginx的功能和灵活性。这个"ngx_lua_module-windows-1.1.2.0"是该模块的一个Windows版本，适应于...
使用nginx作为http/https正向代理ipm包，包含ngx_http_proxy_connect_module 模块，附带了第三方图片代理配置，带有缓存，可直接做图片服务器 下载后执行：rpm -ivh nginx-1.12.2-1.el7_4.ngx.x86_64.rpm 打包教程：...
NGX_STREAM_SSL_PREREAD_MODULE 模块在 nginx-1.14 中自带，nginx-1.10.2 中没有该模块。最新版的该模块可直接用 nginx-1.16 中直接替换。编译时候需要打开 --with-stream 和 --with-stream_ssl_preread_module 选项...
3. `conf`: 配置文件示例，展示如何在 Nginx 配置中启用模块。 4. `Makefile`: 用于编译源代码的文件。 5. `LICENSE`: 许可证文件，说明该模块的开源许可条款。 **知识点详解：** 1. **Nginx 服务器：** Nginx 是...
ngx_req_status用来展示nginx请求状态信息，类似于apache的status，nginx自带的模块只能显示连接数等等信息，我们并不能知道到底有哪些请求、以及各url域名所消耗的带宽是多少。ngx_req_status提供了这些功能. 1、按...
在本文中，我们将深入探讨如何进行Nginx的模块二次开发，特别关注“ngx_http_mytest_module.zip_nginx_world”这个示例项目。这个压缩包包含了一个基础的Nginx自定义模块，可以视为模块开发的"Hello, World!"级别...
- 配置Nginx的配置文件，例如`/etc/nginx/nginx.conf`，以启用ngx_lua模块和WAF相关的指令。 - 使用Lua编写WAF规则，这些规则通常包含在单独的Lua脚本文件中，通过`set_by_lua_file`或`access_by_lua_file`指令...
ngx_devel_kit是Nginx的一个重要扩展模块，它为Nginx提供了一系列的开发工具，方便开发者在Nginx上构建自定义模块。这个0.2.19版本的压缩包“ngx_devel_kit-0.2.19.tar.gz”包含了用于编译和开发Nginx模块所需的源...
ngx_upload模块是Nginx的一个扩展模块，专门用于处理HTTP请求中的文件上传功能。... - 配置Nginx，添加ngx_upload_module和ngx_cache_purge模块，执行`./configure --prefix=/usr/local/nginx --with-pcre --with-...
ngx_http_dav_ext_module.so centos7 nginx 1.18 可以作为模块加载
这时，ngx_log_if模块就能发挥作用，通过配置指令来决定何时写入日志。 该模块的核心在于`if`条件判断，它允许我们在日志记录语句前添加条件表达式。例如，我们可以设置如下的配置： ```nginx log_format custom '...
ngx_python 是为 nginx 嵌入 python 脚本的模块。环境- python 2.7.*- nginx-1.6.3 安装```sh git clone https://github.com/rryqszq4/ngx_python.git wget 'http://nginx.org/download/nginx-1.6.3.tar.gz' ...