---
title: "Transport TCP 缓冲区大小配置"
date: 2026-01-21
lastmod: 2026-01-21
description: "transport.tcp.receive_buffer_size 和 transport.tcp.send_buffer_size 配置项用于控制 TCP 接收和发送缓冲区大小。"
tags: ["Transport", "TCP", "缓冲区", "性能优化"]
summary: "配置项作用 #  transport.tcp.receive_buffer_size 和 transport.tcp.send_buffer_size 配置项用于控制TCP 接收和发送缓冲区的大小。
配置项属性 #  transport.tcp.receive_buffer_size #   配置路径: transport.tcp.receive_buffer_size 数据类型: ByteSizeValue（字节大小） 默认值: -1（使用系统默认） 是否可选: 是 作用域: NodeScope（节点级别） 动态更新: 否（需要重启节点生效）  transport.tcp.send_buffer_size #   配置路径: transport.tcp.send_buffer_size 数据类型: ByteSizeValue（字节大小） 默认值: -1（使用系统默认） 是否可选: 是 作用域: NodeScope（节点级别） 动态更新: 否（需要重启节点生效）  配置建议 #  默认配置 #  transport: tcp: receive_buffer_size: -1 # 系统默认 send_buffer_size: -1 高吞吐场景 #  transport: tcp: receive_buffer_size: 128kb send_buffer_size: 128kb 注意事项 #    非动态更新: 需要重启节点生效。"
---


## 配置项作用

`transport.tcp.receive_buffer_size` 和 `transport.tcp.send_buffer_size` 配置项用于控制**TCP 接收和发送缓冲区的大小**。

## 配置项属性

## transport.tcp.receive_buffer_size

- **配置路径**: `transport.tcp.receive_buffer_size`
- **数据类型**: `ByteSizeValue`（字节大小）
- **默认值**: `-1`（使用系统默认）
- **是否可选**: 是
- **作用域**: NodeScope（节点级别）
- **动态更新**: 否（需要重启节点生效）

## transport.tcp.send_buffer_size

- **配置路径**: `transport.tcp.send_buffer_size`
- **数据类型**: `ByteSizeValue`（字节大小）
- **默认值**: `-1`（使用系统默认）
- **是否可选**: 是
- **作用域**: NodeScope（节点级别）
- **动态更新**: 否（需要重启节点生效）

## 配置建议

## 默认配置

```yaml
transport:
  tcp:
    receive_buffer_size: -1  # 系统默认
    send_buffer_size: -1
```

## 高吞吐场景

```yaml
transport:
  tcp:
    receive_buffer_size: 128kb
    send_buffer_size: 128kb
```

## 注意事项

1. **非动态更新**: 需要重启节点生效。

2. **系统默认**: -1 表示使用系统默认值。

3. **性能影响**: 合理设置可提高吞吐量。