登录
当前位置： 首页 > 工具软件 > ngx-masonry > 使用案例 >

Nginx官方文档(四十八)【ngx_stream_log_module|ngx_stream_proxy_module】

闻人梓
2023-12-01

ngx_stream_log_module

ngx_stream_log_module 模块（1.11.4）按指定的格式写入会话日志。

示例配置

log_format basic '$remote_addr [$time_local] '
                 '$protocol $status $bytes_sent $bytes_received '
                 '$session_time';

access_log /spool/logs/nginx-access.log basic buffer=32k;

指令

access_log

-说明
语法access_log path format [buffer=size] [gzip[=level]] [flush=time] [if=condition];
access_log off;
默认access_log off;
上下文stream、server

设置缓冲日志写入的路径、格式和配置。可以在同一级别指定多个日志。可通过在第一个参数中指定 syslog: 前缀来配置记录到 syslog。特殊值 off 取消当前级别的所有 access_log 指令。

如果使用 buffer 或 gzip 参数，则将缓冲 log 的写入。

缓冲区大小不得超过磁盘文件的原子写入大小。对于 FreeBSD 而言，这个大小是无限制的。

启用缓冲后，以下情况数据将写入文件：

  • 如果下一个日志行不能放入缓冲区
  • 如果缓冲的数据早于 flush 参数指定的数据
  • 当 worker 进程重新打开日志文件或正在关闭时

如果使用 gzip 参数，将写入文件之前将压缩缓冲的数据。压缩级别可以设置为 1（最快，压缩级别低）到 9（最慢，压缩级别最高）之间。默认情况下，缓冲区大小等于 64K 字节，压缩级别设置为 1。由于数据是以原子块压缩，因此日志文件可以随时通过 zcat 解压缩或读取。

示例：

access_log /path/to/log.gz basic gzip flush=5m;

要使 gzip 压缩起作用，必须在构建 nginx 使用 zlib 库。

文件路径可以包含变量，但是这样的日志有一些约束：

  • 被 worker 进程使用凭据的用户应具有在具有此类日志的目录中创建文件的权限
  • 缓冲写入将不起作用
  • 每个日志写入都会打开和关闭文件。但是，由于频繁使用的文件的描述符可以存储在缓存中，因此可以在 open_log_file_cache 指令的 valid 参数指定的时间内继续写入旧文件

if 参数启用条件日志。如果 condition 计值为 0 或空字符串，则不会记录会话。

log_format

-说明
语法log_format name [escape=default\|json\|none] string ...;
默认——
上下文stream

指定日志格式，例如：

log_format proxy '$remote_addr [$time_local] '
                 '$protocol $status $bytes_sent $bytes_received '
                 '$session_time "$upstream_addr" '
                 '"$upstream_bytes_sent" "$upstream_bytes_received" "$upstream_connect_time"';

escape 参数（1.11.8）允许在变量中设置转义的 json 或 default 字符，默认情况下，使用 default 转义。 none 参数（1.13.10）禁用转义。

open_log_file_cache

-说明
语法open_log_file_cache max=N [inactive=time] [min_uses=N] [valid=time];
open_log_file_cache off;
默认open_log_file_cache off;
上下文stream、server

定义一个缓存，用于存储名称中包含变量的常用日志的文件描述符。该指令有以下参数：

  • max

    设置缓存中的最大描述符数，如果缓存变满，则最近最少使用（LRU）的描述符将被关闭

  • inactive

    如果在此期间没有发生访问，则设置关闭缓存描述符的时间。默认为 10 秒

  • min_uses

    设置在 inactive 参数定义的时间内文件使用的最小数量，使描述符在缓存中保持打开状态。默认为 1

  • valid

    设置检查同名文件是否仍然存在的时间。默认为 60 秒

  • off

    禁用缓存

用法示例：

open_log_file_cache max=1000 inactive=20s valid=1m min_uses=2;

原文档

http://nginx.org/en/docs/stream/ngx_stream_log_module.html

ngx_stream_proxy_module

ngx_stream_proxy_module 模块（1.9.0）允许通过 TCP、UDP（1.9.13）和 UNIX 域套接字代理数据流。

示例配置

server {
    listen 127.0.0.1:12345;
    proxy_pass 127.0.0.1:8080;
}

server {
    listen 12345;
    proxy_connect_timeout 1s;
    proxy_timeout 1m;
    proxy_pass example.com:12345;
}

server {
    listen 53 udp reuseport;
    proxy_timeout 20s;
    proxy_pass dns.example.com:53;
}

server {
    listen [::1]:12345;
    proxy_pass unix:/tmp/stream.socket;
}

指令

proxy_bind

-说明
语法proxy_bind address [transparent] | off;
默认——
上下文stream、server
提示该指令在 1.9.2 版本中出现

使到被代理服务器的出站连接源自指定的本地 IP 地址（address）。参数值可以包含变量（1.11.2）。特殊值 off 指定不继承上级 proxy_bind 指令配置，这使系统可以自动分配本地 IP 地址。

transparent 参数（1.11.0）允许到被代理服务器的出站连接源自非本地 IP 地址，例如，来自一个客户端的真实 IP 地址：

proxy_bind $remote_addr transparent;

为了使此参数生效，通常必须使用超级用户特权运行 nginx worker 进程。在 Linux上，如果指定了 transparent 则不需要（1.13.8），worker 进程从 master 进程继承 CAP_NET_RAW 能力。还需要配置内核路由表以拦截来自被代理服务器的网络流量。

proxy_buffer_size

-说明
语法limit_conn_log_level size;
默认proxy_buffer_size 16k;
上下文stream、server
提示该指令在 1.9.4 版本中出现

设置读取被代理服务器数据的缓冲区的大小（size）。也用于设置读取客户端数据的缓冲区的大小（size）。

proxy_connect_timeout

-说明
语法proxy_connect_timeout time;
默认proxy_connect_timeout 60s;
上下文stream、server

设置与被代理服务器建立连接的超时时间。

proxy_download_rate

-说明
语法proxy_download_rate rate;
默认proxy_download_rate 0;
上下文stream、server
提示该指令在 1.9.3 版本中出现

限制读取被代理服务器数据的速率。rate 以每秒字节数指定。零值禁用速率限制。该限制是针对每个连接设置的，因此，如果 nginx 同时打开两个与被代理服务器的连接，则总速率将是指定限制速率的两倍。

参数值可以包含变量（1.17.0）。如果需要根据特定条件限制速率，可参考以下配置示例：

map $slow $rate {
    1     4k;
    2     8k;
}

proxy_download_rate $rate;

proxy_next_upstream

-说明
语法proxy_next_upstream on | off;
默认proxy_next_upstream on;
上下文stream、server

当连接无法与某个被代理服务器建立连接时，是否将客户端连接传递给下一个服务器。

将连接传递到下一个服务器可能会受到尝试次数和时间的限制。

proxy_next_upstream_timeout

-说明
语法proxy_next_upstream_timeout time;
默认proxy_next_upstream_timeout 0;
上下文stream、server

设置将连接传递到下一个服务器的超时时间。0 值关闭此限制。

proxy_next_upstream_tries

-说明
语法proxy_next_upstream_tries number;
默认proxy_next_upstream_tries 0;
上下文stream、server

设置将连接传递到下一个服务器的尝试次数。0 值关闭此限制。

proxy_pass

-说明
语法proxy_pass address;
默认——
上下文server

设置被代理服务器的地址。该地址可以指定为一个域名或 IP 地址以及端口：

proxy_pass localhost:12345;

或作为 UNIX 域套接字路径：

proxy_pass unix:/tmp/stream.socket;

如果一个域名解析为多个地址，则所有这些地址都将以轮询的方式使用。另外，可以将地址指定为一个服务器组。

也可以使用变量（1.11.3）指定地址：

proxy_pass $upstream;

在这种情况下，在配置的服务器组中查找服务器名称，如果找不到，则使用一个 resolver确定服务器名称。

proxy_protocol

-说明
语法proxy_protocol on | off;
默认proxy_protocol off;
上下文stream、server
提示该指令在 1.9.2 版本中出现

为到被代理服务器的连接启用 PROXY 协议。

proxy_requests

-说明
语法proxy_requests number;
默认proxy_requests 0;
上下文stream、server
提示该指令在 1.15.7 版本中出现

设置丢弃客户端和现有 UDP 流会话之间绑定的客户端数据报的数量。在收到指定数量的数据报后，来自同一客户端的下一个数据报将启动一个新会话。当所有客户端数据报都发送到被代理服务器并接收到预期的响应数时，或者达到超时时间时，会话将终止。

proxy_responses

-说明
语法proxy_responses number;
默认——
上下文stream、server
提示该指令在 1.9.13 版本中出现

如果使用 UDP 协议，设置响应客户端数据报中来自被代理服务器的数据报期望数。该数字用作会话终止的提示。默认情况下，数据报的数量不受限制。

如果指定零值，则不会响应。但如果收到响应并且会话仍未完成，则该响应将被处理。

proxy_session_drop

-说明
语法proxy_session_drop on | off;
默认proxy_session_drop off;
上下文stream、server
提示该指令在 1.15.8 版本中出现

设置在将被代理服务器从组中删除或标记为永久不可用后，是否可以终止与被代理服务器的所有会话。在重新解析或使用了 API DELETE 命令时，可能会发生这种情况。如果服务器处于不健康状态或使用 API PATCH 命令修改，服务器可标记为永久不可用。当为客户端或被代理服务器处理下一个读取或写入事件时，每个会话都会终止。

该指令为商业订阅部分。

proxy_socket_keepalive

-说明
语法proxy_socket_keepalive on | off;
默认proxy_socket_keepalive off;
上下文stream、server
提示该指令在 1.15.6 版本中出现

为到被代理服务器的出站连接配置 TCP keepalive 行为。默认情况下，操作系统的设置影响到套接字。如果指令设置为 on 值，则将为套接字打开 SO_KEEPALIVE 套接字选项。

proxy_ssl

-说明
语法proxy_ssl on | off;
默认proxy_ssl off;
上下文stream、server

为到被代理服务器的连接启用 SSL/TLS 协议。

proxy_ssl_certificate

-说明
语法proxy_ssl_certificate file;
默认——
上下文stream、server

指定一个 PEM 格式的证书文件，用于验证被代理服务器的身份。

proxy_ssl_certificate_key

-说明
语法proxy_ssl_certificate_key file;
默认——
上下文stream、server

指定一个 PEM 格式的私钥文件，用于验证被代理服务器的身份。

proxy_ssl_ciphers

-说明
语法proxy_ssl_ciphers ciphers;
默认proxy_ssl_ciphers DEFAULT;
上下文stream、server

指定连接到被代理服务器启用的密码算法。密码算法需要 OpenSSL 库支持。

可以使用 openssl ciphers 命令查看完整的算法支持列表。

proxy_ssl_crl

-说明
语法proxy_ssl_crl file;
默认——
上下文stream、server

指定一个 PEM 格式的吊销证书（CRL）文件，用于验证被代理服务器的证书。

proxy_ssl_name

-说明
语法proxy_ssl_name name;
默认proxy_ssl_name 来自 proxy_pass 的 host;
上下文stream、server

允许覆盖用于验证被代理服务器证书的服务器名称，并在与被代理服务器建立连接时通过 SNI 传递。也可以使用变量（1.11.3）指定服务器名称。

默认情况下，使用 proxy_pass 地址的主机部分。

proxy_ssl_password_file

-说明
语法proxy_ssl_password_file file;
默认——
上下文stream、server

指定一个保存有密钥密码的文件，每个密码独占一行。加载密钥时依次尝试使用这些密码。

proxy_ssl_protocols

-说明
语法proxy_ssl_protocols [SSLv2] [SSLv3] [TLSv1] [TLSv1.1] [TLSv1.2] [TLSv1.3];
默认proxy_ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
上下文stream、server

为到被代理服务器的连接启用指定协议。

proxy_ssl_server_name

-说明
语法proxy_ssl_server_name on | off;
默认proxy_ssl_server_name off;
上下文stream、server

与被代理服务器建立连接时，启用或禁用通过 TLS 服务器名称指示扩展（SNI、RFC 6066）传递服务器名称。

proxy_ssl_session_reuse

-说明
语法proxy_ssl_session_reuse on | off;
默认proxy_ssl_session_reuse on;
上下文stream、server

在使用被代理服务器时是否可以重用 SSL 会话。如果日志中出现错误 SSL3_GET_FINISHED:digest check failed，请尝试禁用会话重用。

proxy_ssl_trusted_certificate

-说明
语法proxy_ssl_trusted_certificate file;
默认——
上下文stream、server

指定一个 PEM 格式的可信 CA 证书文件，该证书用于验证被代理服务器的证书。

proxy_ssl_verify

-说明
语法proxy_ssl_verify on | off;
默认proxy_ssl_verify off;
上下文stream、server

启用或禁用被代理服务器证书验证。

proxy_ssl_verify_depth

-说明
语法proxy_ssl_verify_depth number;
默认proxy_ssl_verify_depth 1;
上下文stream、server

设置被代理服务器证书链验证深度。

proxy_timeout

-说明
语法proxy_timeout timeout;
默认proxy_timeout 10m;
上下文stream、server

设置客户端或被代理服务器连接两次连续读取或写入操作之间的超时时间（timeout）。如果在此时间内没有数据传输，则连接将关闭。

proxy_upload_rate

-说明
语法proxy_upload_rate rate;
默认proxy_upload_rate 0;
上下文stream、server
提示该指令在 1.9.3 版本中出现

限制读取客户端数据的速率。该速率以每秒字节数指定。零值禁用速率限制。该限制只针对单个连接，因此，如果客户端同时打开两个连接，则总速率将是指定限制速率的两倍。

参数值可以包含变量（1.17.0）。如果需要根据特定条件设置限制速率，可参考以下配置示例：

map $slow $rate {
    1     4k;
    2     8k;
}

proxy_upload_rate $rate;

原文档

http://nginx.org/en/docs/stream/ngx_stream_proxy_module.html

 类似资料：

相关阅读

Laravel 5.5官方推荐的Nginx配置学习教程官方文档中的pyspark线性回归示例-错误的结果？官方文档在哪里说Java的并行流操作使用fork / join？在ASP.NET 2.0中操作数据之四十八：对SqlDataSource控件使用开放式并发科学知识：二进制、八进制、十进制、十六进制转换

相关文章

二进制数、八进制数和十六进制数人保科技二面（三十分钟：三位面试官）OpenCV绘制四方形递四方 java 二面Nginx配置文件

相关问答

官方文档在哪里说Java的并行流操作使用fork/join？PYQT5中的QThreads:这是官方QThread文档的C++到Python的正确翻译吗？vue3,vite,vant4，组件显示不出来，都是按照官方文档配置的？OpenJDK 11.0.4二进制文件官方下载官方舱单在哪里。Chrome托管应用的json文档？（书签/快捷方式应用程序）

相关文档

Electron 官方文档Mithril 官方文档yog2 官方文档mpvue 官方文档Sublime 官方中文文档
快捷导航： 新手教程 算法原理 架构设计 Java进阶 数据库进阶 大厂专栏 面试经验 编程笔记 编程问答 所有专题 文档资料 工具软件 电子书籍 小牛导航
在线工具： 房贷计算器 个税计算器 Linux命令查询 Json格式化 正则表达式 颜色转换 AES加解密 SHA1加密 MD5加密 毒鸡汤 字数统计 随机密码生成 进制转换 Base64编解码 励志句子
Copyright © 2019-2024 小牛知识库@xnip.cn. All Rights Reserved.