Sing-box中direct类型inbound的TCP转发功能异常分析

问题背景

Sing-box是一款功能强大的网络工具，其direct类型的inbound功能常用于实现TCP端口转发。近期在1.11.0-alpha.6至1.11.0-alpha.17版本中，用户报告该功能出现异常，而在1.11.0-alpha.5及更早版本中则工作正常。

问题表现

用户配置了如下inbound规则：

{
    "type": "direct",
    "listen": "127.0.0.1",
    "listen_port": 10902,
    "network": "tcp",
    "override_address": "192.168.1.1",
    "override_port": 10903
}

该配置本应将本地10902端口的TCP连接转发到192.168.1.1的10903端口，但在受影响版本中此功能失效。

技术分析

direct类型的inbound是Sing-box中用于实现简单端口转发的组件，其核心功能包括：

1. 监听指定本地IP和端口
2. 接收传入的TCP连接
3. 将连接重定向到override_address和override_port指定的目标地址

这种功能在网络架构中常用于：

• 服务端口映射
• 内部网络服务暴露
• 简单的流量转发场景

影响范围

该问题影响从1.11.0-alpha.6开始的所有alpha版本，直到1.11.4版本才得到修复。在此期间，所有依赖direct inbound进行TCP转发的配置都无法正常工作。

解决方案

用户确认在1.11.4版本中该问题已修复。对于遇到类似问题的用户，建议：

1. 升级到1.11.4或更高版本
2. 如果必须使用受影响版本，可考虑以下替代方案：
   • 使用系统自带的iptables或nftables进行端口转发
   • 使用socat等工具临时替代

最佳实践

在使用direct inbound时，建议：

1. 明确指定network参数为"tcp"（如示例所示）
2. 测试转发功能是否正常工作
3. 保持Sing-box版本更新，以获取最新的功能修复
4. 对于关键业务，建议在升级前在测试环境验证功能

总结

端口转发是网络配置中的基础功能，Sing-box通过direct inbound提供了简洁的实现方式。虽然在某些版本中出现过异常，但通过及时更新可以确保功能正常。理解这类问题的表现和解决方案，有助于网络管理员更好地维护服务稳定性。