---
title: "TCP 接收缓冲区大小配置"
date: 2026-02-21
lastmod: 2026-02-21
description: "network.tcp.receive_buffer_size 配置项用于控制 TCP 套接字的接收缓冲区大小。"
tags: ["网络", "TCP", "缓冲区", "性能优化"]
summary: "配置项作用 #  network.tcp.receive_buffer_size 配置项用于控制TCP 套接字的接收缓冲区大小。
此配置决定了操作系统为 TCP 连接分配的接收缓冲区大小，影响网络数据的接收性能和内存使用。
配置项属性 #   配置路径: network.tcp.receive_buffer_size 数据类型: ByteSizeValue（字节大小值） 默认值: -1（不设置，使用系统默认） 最小值: 无明确限制（受操作系统限制） 最大值: 受操作系统限制（通常 1-2MB） 是否可选: 是 作用域: NodeScope（节点级别） 动态更新: 否（需要重启节点生效）  配置项详解 #  工作机制 #  TCP 接收缓冲区 网络数据 → 接收缓冲区 → 应用程序 小缓冲区 (32KB): ┌─────────────┐ │ 接收缓冲区 │ 32KB └─────────────┘ │ ↓ 满得快 应用程序处理延迟 ↑ 大缓冲区 (256KB): ┌─────────────────────┐ │ 接收缓冲区 │ 256KB └─────────────────────┘ │ ↓ 满得慢 应用程序处理延迟 ↓ 缓冲区作用 #  接收缓冲区的作用 1."
---


## 配置项作用

`network.tcp.receive_buffer_size` 配置项用于控制**TCP 套接字的接收缓冲区大小**。

此配置决定了操作系统为 TCP 连接分配的接收缓冲区大小，影响网络数据的接收性能和内存使用。

## 配置项属性

- **配置路径**: `network.tcp.receive_buffer_size`
- **数据类型**: `ByteSizeValue`（字节大小值）
- **默认值**: `-1`（不设置，使用系统默认）
- **最小值**: 无明确限制（受操作系统限制）
- **最大值**: 受操作系统限制（通常 1-2MB）
- **是否可选**: 是
- **作用域**: NodeScope（节点级别）
- **动态更新**: 否（需要重启节点生效）

## 配置项详解

## 工作机制

```
TCP 接收缓冲区

网络数据 → 接收缓冲区 → 应用程序


小缓冲区 (32KB):
┌─────────────┐
│  接收缓冲区 │  32KB
└─────────────┘
    │
    ↓  满得快
应用程序处理延迟 ↑


大缓冲区 (256KB):
┌─────────────────────┐
│     接收缓冲区      │  256KB
└─────────────────────┘
    │
    ↓  满得慢
应用程序处理延迟 ↓
```

## 缓冲区作用

```
接收缓冲区的作用

1. 吸收突发流量
   网络突发:
   ├── 大量数据快速到达
   ├── 缓冲区吸收
   └── 应用程序按处理


2. 流量控制
   接收窗口:
   ├── 基于缓冲区大小
   ├── 告诉发送端剩余空间
   └── 控制发送速率


3. 性能优化
   大小权衡:
   ├── 大缓冲: 更多内存，更高吞吐
   └── 小缓冲: 更少内存，可能更多系统调用
```

## 默认值行为

```
值为 -1 时的行为

receive_buffer_size = -1:
    │
    ↓
使用系统默认值
    │
    ├── Linux: 通常 auto-tuned
    ├── 调整范围: 128KB - 4MB
    ├── Windows: 取决于版本
    └── macOS: 通常 256KB


系统自动调整:
├── 根据可用内存
├── 根据网络条件
├── 动态优化
└── 通常表现良好 ✅
```

## 配置建议

## 生产环境（默认）

```yaml
network:
  tcp:
    receive_buffer_size: -1  # 默认值
```

**建议**: 保持默认值 `-1`。使用系统默认值。

## 高吞吐场景

```yaml
network:
  tcp:
    receive_buffer_size: 256kb  # 增加缓冲
```

**建议**: 设置为 `128kb-512kb`。高吞吐量数据传输。

## 内存受限环境

```yaml
network:
  tcp:
    receive_buffer_size: 32kb  # 减少缓冲
```

**建议**: 设置为 `16kb-64kb`。内存受限时使用。

## 最大性能配置

```yaml
network:
  tcp:
    receive_buffer_size: 2mb  # 最大缓冲
```

**建议**: 设置为 `1mb-2mb`。需要最大吞吐时使用。

## 代码示例

## easysearch.yml 基础配置

```yaml
network:
  tcp:
    receive_buffer_size: -1
```

## 高性能配置

```yaml
network:
  tcp:
    receive_buffer_size: 256kb
    send_buffer_size: 256kb
```

## 内存受限配置

```yaml
network:
  tcp:
    receive_buffer_size: 32kb
    send_buffer_size: 32kb
```

## 完整 TCP 配置

```yaml
network:
  tcp:
    receive_buffer_size: -1
    send_buffer_size: -1
    no_delay: true
    keep_alive: true
```

## 相关配置

| 配置项 | 作用 | 默认值 |
|--------|------|--------|
| `network.tcp.receive_buffer_size` | 接收缓冲区大小 | -1 |
| `network.tcp.send_buffer_size` | 发送缓冲区大小 | -1 |
| `network.tcp.no_delay` | 禁用 Nagle 算法 | true |

## 性能影响分析

| receive_buffer_size 设置 | 优点 | 缺点 |
|---------------------------|------|------|
| 16-32KB | 内存占用小 | 可能更多系统调用 |
| 64-128KB | 平衡内存和性能 | 标准设置 |
| 256KB | 更高吞吐 | 占用更多内存 |
| 512KB+ | 最大吞吐 | 内存占用大 |

## 吞吐量对比

```
不同缓冲区的吞吐量

假设 1Gbps 网络，小包传输

32KB 缓冲:
├── 系统调用频繁
├── 吞吐量: ~600 Mbps
└── CPU 占用: 高 ❌


128KB 缓冲:
├── 系统调用适中
├── 吞吐量: ~900 Mbps
└── CPU 占用: 中等 ✅


256KB 缓冲:
├── 系统调用少
├── 吞吐量: ~980 Mbps
└── CPU 占用: 低 ✅


512KB 缓冲:
├── 系统调用最少
├── 吞吐量: ~1000 Mbps
└── CPU 占用: 很低 ✅
```

## 使用场景

## 推荐使用默认值的场景

- **标准应用**: 正常的网络应用
- **系统调优**: 系统已自动优化
- **不确定需求**: 不确定具体需求时

## 推荐增加缓冲区的场景

- **大数据传输**: 需要传输大量数据
- **高吞吐需求**: 对吞吐量要求高
- **高速网络**: 10GbE 或更快的网络
- **充足内存**: 节点内存充足

## 推荐减少缓冲区的场景

- **内存受限**: 节点内存紧张
- **大量连接**: 连接数量很多
- **小数据传输**: 主要是小数据包
- **低延迟要求**: 希望低延迟而非高吞吐

## 与发送缓冲区的配合

```
接收和发送缓冲区的配合

配置 1: 标准配置
receive_buffer_size: -1
send_buffer_size: -1
├── 系统默认
├── 自动优化
└── 推荐使用 ✅


配置 2: 对称配置
receive_buffer_size: 256kb
send_buffer_size: 256kb
├── 大小一致
├── 平衡性能
└── 适合高吞吐 ✅


配置 3: 不对称配置
receive_buffer_size: 512kb
send_buffer_size: 128kb
├── 接收更大
└── 适合大数据接收场景


配置 4: 最小配置
receive_buffer_size: 32kb
send_buffer_size: 32kb
├── 最小内存占用
├── 适合内存受限
└── 牺牲一些性能 ⚠️
```

## 操作系统限制

```
OS 限制和建议

Linux:
/proc/sys/net/core/rmem_max
├── 最大接收缓冲区
├── 默认: 通常 128KB-4MB
└── 设置: echo 16777216 > /proc/sys/net/core/rmem_max


/proc/sys/net/core/rmem_default
├── 默认接收缓冲区
├── 默认: 通常 128KB
└── 设置: echo 262144 > /proc/sys/net/core/rmem_default


Windows:
注册表:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters
├── TcpWindowSize
└── 根据版本自动调整


建议:
receive_buffer_size ≤ OS rmem_max
    │
    ↓
否则:
├── 可能设置失败
├── 或被限制到最大值
└── 记录警告日志 ⚠️
```

## 内存使用分析

```
缓冲区内存占用

假设 1000 个连接

32KB 缓冲:
每连接: 32KB
总内存: 1000 × 32KB = 32MB ✅


128KB 缓冲:
每连接: 128KB
总内存: 1000 × 128KB = 128MB


256KB 缓冲:
每连接: 256KB
总内存: 1000 × 256KB = 256MB
├── 内存占用大 ⚠️
└── 需要评估


512KB 缓冲:
每连接: 512KB
总内存: 1000 × 512KB = 512MB
├── 内存占用很大 ❌
└── 谨慎使用
```

## 注意事项

1. **默认值**: 默认值为 `-1`，使用系统默认值。

2. **需要重启**: 修改此配置需要重启节点。

3. **字节单位**: 支持 kb、mb、gb 等单位。

4. **OS 限制**: 受操作系统最大值限制。

5. **内存占用**: 缓冲区越大，内存占用越大。

6. **连接数量**: 需要考虑连接数量。

7. **对称配置**: 通常与 send_buffer_size 配合。

8. **测试验证**: 配置变更后应验证性能。

9. **监控建议**: 监控网络吞吐和内存使用。

10. **合理设置**: 根据实际需求合理设置。

## 性能调优建议

```
性能调优步骤

1. 监控当前性能
   ├── 网络吞吐量
   ├── 系统调用频率
   └── 内存使用


2. 确定瓶颈
   ├── 吞吐量低 → 考虑增加缓冲区
   ├── 内存占用高 → 考虑减小缓冲区
   └── 系统调用多 → 考虑增加缓冲区


3. 测试不同配置
   ├── 32KB → 64KB → 128KB → 256KB
   ├── 测量吞吐量
   ├── 测量延迟
   └── 测量内存


4. 选择最优值
   ├── 平衡性能和内存
   ├── 验证稳定性
   └── 部署配置
```