Update On Wed Nov 5 19:38:45 CET 2025

nodepass/docs/zh/configuration.md

@@ -262,6 +262,43 @@ nodepass "server://0.0.0.0:10101/0.0.0.0:8080?log=info&tls=1&proxy=1&rate=100"
 - 头部格式遵循HAProxy PROXY协议v1规范
 - 如果目标服务不支持PROXY协议，将导致连接失败
 
+## TCP支持控制
+
+NodePass默认支持TCP流量隧道。`notcp`参数允许您在只需要处理UDP流量时禁用TCP支持，这样可以减少资源使用并简化配置。
+
+- `notcp`: TCP支持控制（默认: 0）
+  - 值为0：启用TCP支持 - TCP和UDP流量都将被隧道传输
+  - 值为1：禁用TCP支持 - 仅UDP流量将被隧道传输，TCP连接被忽略
+  - 适用于客户端和服务器模式
+  - 禁用时，不分配TCP相关资源（缓冲区、连接、会话）
+
+示例：
+```bash
+# 启用TCP支持（默认行为）
+nodepass "server://0.0.0.0:10101/0.0.0.0:8080?notcp=0"
+
+# 禁用TCP支持，仅处理UDP场景
+nodepass "server://0.0.0.0:10101/0.0.0.0:8080?notcp=1"
+
+# 客户端禁用TCP
+nodepass "client://server.example.com:10101/127.0.0.1:8080?notcp=1"
+
+# 与其他参数结合
+nodepass "server://0.0.0.0:10101/0.0.0.0:8080?log=info&tls=1&notcp=1"
+```
+
+**TCP支持控制使用场景：**
+- **仅UDP服务**：仅需要隧道传输UDP应用时禁用TCP
+- **资源优化**：通过避免TCP处理开销减少内存和CPU使用
+- **安全性**：防止受限环境中的TCP攻击或不需要的流量
+- **简化配置**：不需要TCP隧道时更容易设置
+- **网络隔离**：更好地控制TCP和UDP流量处理
+
+**重要说明：**
+- 禁用TCP时，发送到隧道的任何TCP连接将被静默丢弃
+- 切换到notcp=1时，现有的TCP会话将被终止
+- 当notcp=1时，TCP缓冲池和会话管理被禁用
+
 ## UDP支持控制
 
 除了TCP之外，NodePass还支持UDP流量隧道。`noudp`参数允许您在只需要处理TCP流量时禁用UDP支持，这样可以减少资源使用并简化配置。
@@ -373,6 +410,7 @@ NodePass支持通过URL查询参数进行灵活配置，不同参数在 server
 | `rate`    | 带宽速率限制         | `0`       |   O    |   O    |   X    |
 | `slot`    | 最大连接数限制       | `65536`   |   O    |   O    |   X    |
 | `proxy`   | PROXY协议支持        | `0`       |   O    |   O    |   X    |
+| `notcp`   | TCP支持控制          | `0`       |   O    |   O    |   X    |
 | `noudp`   | UDP支持控制          | `0`       |   O    |   O    |   X    |
 
 - O：参数有效，推荐根据实际场景配置
@@ -383,6 +421,7 @@ NodePass支持通过URL查询参数进行灵活配置，不同参数在 server
 - client/server 双端握手模式建议根据流量和资源情况调整连接池容量（min/max），优化性能。
 - 当自动检测不符合部署需求时或需要跨环境一致行为时，使用运行模式控制（mode）。
 - 配置速率限制（rate）以控制带宽使用，防止共享环境中的网络拥塞。
+- 仅需要隧道传输UDP流量时设置`notcp=1`，以减少资源使用并简化配置。
 - 仅需要隧道传输TCP流量时设置`noudp=1`，以减少资源使用并简化配置。
 - 日志级别（log）可在所有模式下灵活调整，便于运维和排查。