Web 服务器与网关 / 系统课时

配置 TCP 代理

配置 TCP 代理

本节解决 Nginx 代理非 HTTP 服务的问题。通过 stream 模块实现 TCP 四层转发,将数据库或自定义 TCP 服务暴露到统一入口,并配置连接超时、日志和上游服务组完成稳定代理。

学习目标

  • 理解 Nginx stream 与 HTTP 代理的区别。
  • 掌握 TCP 上游组和转发配置方法。
  • 能够验证 TCP 代理链路并定位连接失败原因。

理解 stream 四层代理模型

HTTP 代理工作在应用层,会解析 HTTP 请求头和路径;stream 模块工作在传输层,只关注 TCP 连接建立和数据转发。因此它适合代理 MySQL、Redis、自定义 TCP 服务等非 HTTP 协议。

TCP 代理不会理解业务内容,只负责客户端与后端服务之间建立可靠连接。

Nginx stream 四层代理数据流示意图

配置 stream 和 TCP 上游服务

stream 配置通常位于 nginx.conf 的顶层,与 http 模块并列。下面示例代理一个 TCP 服务端口。

nginx
stream {
    upstream backend_tcp {
        server 127.0.0.1:3306;
    }

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

    server {
        listen <PORT>;
        proxy_pass backend_tcp;
        proxy_connect_timeout 5s;
        proxy_timeout 60s;
        access_log /var/log/nginx/tcp-access.log tcp_log;
    }
}

预期结果

text
客户端连接 <PORT>
Nginx 建立到 127.0.0.1:3306 的 TCP 连接
双方开始转发 TCP 数据

proxy_connect_timeout 控制连接后端的等待时间,proxy_timeout 控制连接空闲超时。实际生产值需要根据业务长连接特征调整。

使用上游组管理多个 TCP 节点

当 TCP 服务存在多个节点时,可以使用 upstream 管理后端地址。Nginx 会根据配置策略选择目标节点。

nginx
stream {
    upstream mysql_cluster {
        server 10.0.0.10:3306;
        server 10.0.0.11:3306;
    }

    server {
        listen <PORT>;
        proxy_pass mysql_cluster;
    }
}

预期结果

text
客户端连接入口端口
请求被转发到 mysql_cluster 中可用节点

TCP 代理不像 HTTP 代理那样基于 URL 分流,如果需要按域名或协议内容选择后端,需要使用更适合的网关方案。

验证 TCP 代理和排查连接问题

配置完成后,需要先检查 Nginx 语法,再确认监听端口和后端连接状态。

bash
nginx -t
ss -lntp | grep <PORT>
nc -vz 127.0.0.1 <PORT>

预期结果

text
nginx: configuration file ... test is successful
LISTEN ... nginx
Connection to 127.0.0.1 <PORT> succeeded

如果客户端无法连接,检查 stream 是否编译启用、监听端口是否冲突、防火墙是否放行。如果连接成功但业务失败,需要进一步检查后端 TCP 服务状态。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置 TCP 代理

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通