nginx无内置命令列出模块所有指令，需结合nginx -v查编译模块、官方文档查指令语法与作用域（如allow仅限http/server/location）、nginx -t验证配置——未知指令报“unknown directive”，作用域错误报“not allowed here”。

Nginx 本身不提供“列出某模块所有可用指令”的内置命令，但你可以通过三种互补方式准确获知一个模块支持哪些配置指令：查编译参数确认模块存在、查官方文档明确指令语法与作用域、用 nginx -t 实时验证配置合法性。

看 nginx -V 确认模块是否已编译进当前版本

运行 nginx -V（注意大写 V），输出中会显示完整编译参数。重点找以 --with- 开头的项：

• --with-http_access_module → 表示 allow、deny 指令可用
• --with-http_rewrite_module → 表示 rewrite、return、if 等指令可用
• --with-http_ssl_module → 表示 ssl_certificate、ssl_protocols 等指令可用

若看到 --without-xxx-module，说明该模块被显式禁用，对应指令自然不可用。

查官方文档定位指令归属与作用域限制

每个 Nginx 指令在官方文档中都有明确归属模块和允许出现的位置（context）。这是最权威的依据：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

• limit_req 属于 ngx_http_limit_req_module，只允许出现在 http、server、location 块中
• geo 属于 ngx_http_geo_module，只能放在 http 块顶层，不能嵌套在 server 或 location 内
• auth_basic 属于 ngx_http_auth_basic_module，支持 http、server、location，但不支持 if

直接访问 nginx.org/en/docs/，搜索指令名即可跳转到对应模块页，里面会清楚标注 “Syntax”、“Default”、“Context” 和 “Example”。

用 nginx -t 验证指令是否存在及是否用对位置

把疑似指令写入配置文件后执行 nginx -t，Nginx 会立即反馈具体错误类型：

• unknown directive "xxx" → 指令名拼错，或所属模块未编译（如用了 grpc_pass 但没启用 http_grpc_module）
• "xxx" directive is not allowed here → 指令放错了块，比如在 if 块里写了 allow
• invalid number of arguments → 参数个数或格式不对，例如 allow 后漏了 IP 地址或 CIDR 表达式

这个方法不依赖记忆，也不依赖文档检索，是上线前必做的实操校验步骤。

不需要背指令列表，掌握这三步——查编译参数、查文档 context、用 -t 验证——就能精准知道任意模块提供了什么指令、在哪能用、怎么写才对。