ngx_stream_keyval_module 模块
配置示例 指令 keyval keyval_zone |
ngx_stream_keyval_module
模块 (1.13.7) 创建变量,其值取自由 API 管理的键值对,或者也可以通过 njs 设置的变量。
此模块作为我们的商业订阅的一部分提供。
配置示例
http { server { ... location /api { api write=on; } } } stream { keyval_zone zone=one:32k state=/var/lib/nginx/state/one.keyval; keyval $ssl_server_name $name zone=one; server { listen 12345 ssl; proxy_pass $name; ssl_certificate /usr/local/nginx/conf/cert.pem; ssl_certificate_key /usr/local/nginx/conf/cert.key; } }
指令
语法 |
keyval |
---|---|
默认值 | — |
上下文 |
stream |
创建一个新的 $variable
,其值通过在键值数据库中查找 key
来获取。匹配规则由 keyval_zone
指令的 type
参数定义。数据库存储在由 zone
参数指定的共享内存区域中。
语法 |
keyval_zone |
---|---|
默认值 | — |
上下文 |
stream |
设置保存键值数据库的共享内存区域的 name
和 size
。键值对由 API 管理。
可选的 state
参数指定一个 file
,用于以 JSON 格式保存键值数据库的当前状态,使其在 nginx 重启后持久化。应避免直接修改文件内容。
示例
keyval_zone zone=one:32k state=/var/lib/nginx/state/one.keyval; # path for Linux keyval_zone zone=one:32k state=/var/db/nginx/state/one.keyval; # path for FreeBSD
可选的 timeout
参数 (1.15.0) 设置键值对从区域中移除的时间。
可选的 type
参数 (1.17.1) 激活一个额外的索引,该索引针对匹配特定类型的键进行了优化,并在评估 keyval $variable
时定义匹配规则。
该索引存储在同一个共享内存区域中,因此需要额外的存储空间。
type=string
- 默认值,未启用索引;变量查找使用记录键和搜索键的精确匹配来执行
type=ip
- 搜索键是 IPv4 或 IPv6 地址或 CIDR 范围的文本表示;要匹配记录键,搜索键必须属于记录键指定的子网或精确匹配一个 IP 地址
type=prefix
- 变量查找使用记录键和搜索键的前缀匹配来执行 (1.17.5);要匹配记录键,记录键必须是搜索键的前缀
可选的 sync
参数 (1.15.0) 启用共享内存区域的同步。同步需要设置 timeout
参数。
如果启用了同步,键值对的移除(无论是移除一个还是全部)将只在目标集群节点上执行。其他集群节点上的相同键值对将在达到 timeout
时移除。