Linux怎么配置Nginx作为TCP代理 Nginx Stream模块实战详解-LINUX-PHP中文网

nginx stream模块需显式加载且配置位置正确，否则报unknown directive "stream"；须用nginx -t验证，确认load_module路径正确、stream块与http平级、proxy_responses等参数适配协议特性。

linux怎么配置nginx作为tcp代理 nginx stream模块实战详解

Nginx 的 stream 模块不是“装了就能用”，必须确认已加载且配置位置正确，否则会报 unknown directive "stream" 或连接直接被拒绝。

检查 stream 模块是否真正可用

很多人运行 nginx -V 看到 --with-stream 就以为万事大吉，但实际可能没加载动态模块。更可靠的验证方式是：

执行 nginx -t —— 如果提示 unknown directive "stream"，说明模块未加载，哪怕编译参数里有
检查配置中是否漏了 load_module 行：主流发行版（如 Ubuntu 22.04+、CentOS 8+）通常需显式启用，例如：
```
load_module modules/ngx_stream_core_module.so;
```
路径可能为 /usr/lib64/nginx/modules/ngx_stream_module.so 或 /usr/share/nginx/modules/*.conf，具体看 nginx -V 输出的 --modules-path
Debian/Ubuntu 用户可改用 nginx-full 包（含 stream），避免手动加载；RHEL/CentOS 8+ 推荐 yum install nginx-all-modules

stream 块必须放在 http 块之外

stream 和 http 是 Nginx 配置树中平级的 main 上下文块，绝不能嵌套。常见错误配置：

把 stream { ... } 写在 http { ... } 里面 → 直接 nginx -t 失败
把 upstream 放在 server 块内 → 语法错误
监听端口写成 listen 3306 ssl（stream 不支持 SSL 终止，只支持 TLS 透传）

正确结构示例（/etc/nginx/nginx.conf 顶部或末尾）：

load_module modules/ngx_stream_core_module.so;

stream {
    upstream mysql_backend {
        server 192.168.10.20:3306 max_fails=3 fail_timeout=30s;
        server 192.168.10.21:3306 backup;
    }

    server {
        listen 3306;
        proxy_pass mysql_backend;
        proxy_timeout 1h;
        proxy_responses 1;
    }
}

proxy_timeout 和 proxy_responses 的取值逻辑

这两个参数直接影响连接是否“看似正常但实际失败”。MySQL、PostgreSQL 等协议在握手成功前不发响应包，若设错会导致客户端超时或反复重连：

proxy_timeout 控制空闲连接超时（非请求超时），MySQL 长连接建议设为 1h 或更长；Redis 默认连接空闲 300s 断开，这里可设 305s 避免早于后端断连
proxy_responses 1 表示 Nginx 等待后端返回**第一个响应包**后才认为连接建立成功，这对 MySQL handshake 阶段健康检测至关重要；设为 0（默认）则仅 TCP 握手成功就转发，容易把半死连接当健康节点
proxy_connect_timeout 控制与后端建连的超时（如网络抖动），建议设为 3s~5s，太短易误判，太长拖慢故障转移

UDP 代理和负载均衡策略的特殊写法

UDP 场景（如 DNS、Syslog、游戏 UDP 流）需显式声明 udp，且不支持 proxy_responses（UDP 无可靠响应概念）：

DNS 代理示例：

stream {
    upstream dns_upstream {
        server 8.8.8.8:53;
        server 114.114.114.114:53;
    }
    server {
        listen 53 udp;
        proxy_pass dns_upstream;
        proxy_timeout 30s;
    }
}

哈希保持客户端一致性（如 DNS 查询源 IP 固定）：hash $remote_addr consistent; 必须写在 upstream 块第一行，不能放在 server 里
least_conn 在 UDP 下意义有限（UDP 无连接状态），更适合 TCP 类场景如 Redis

最容易被忽略的是日志缺失——stream 模块默认不记录访问日志，出问题时只能靠 error_log 和抓包。务必在 stream 块内配 log_format 和 access_log，否则排查连接拒绝、超时、转发失败将极其困难。

Zynq Linux Hardware Debug

Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。

下载