sing-box 旁路部署中的 TUN 模式配置指南

前言

sing-box 是一款功能强大的网络工具，支持多种协议和网络模式。在 Linux 系统上部署 sing-box 作为旁路网关时，TUN 模式的配置尤为关键。本文将详细介绍如何在 Debian 12 系统上正确配置 sing-box 的 TUN 模式，实现局域网设备的网络功能。

核心配置解析

基础网络架构

典型的旁路部署架构包含以下组件：

• 主路由器：负责基础网络连接和 DHCP 服务
• sing-box 旁路设备：运行 sing-box 提供网络和 DNS 服务
• 客户端设备：网关指向主路由，DNS 指向 sing-box

关键配置参数

在 sing-box 配置文件中，TUN 模式的核心参数包括：

{
  "type": "tun",
  "tag": "tunIn",
  "interface_name": "tun0",
  "address": "172.19.0.1/30",
  "auto_route": true,
  "auto_redirect": true,
  "strict_route": true,
  "stack": "system",
  "sniff": true
}

各参数作用如下：

• auto_route: 自动设置系统路由规则
• auto_redirect: 自动重定向流量到 TUN 设备
• strict_route: 启用严格路由模式
• stack: 指定网络协议栈实现

常见问题解决方案

DNS 解析异常

当启用 TUN 模式后出现 DNS 解析问题时，可尝试以下解决方案：

1. 检查 DNS 入站配置： 确保有独立的 DNS 入站监听，并将 DNS 流量路由到正确的出站

2. 调整路由规则： 在路由配置中添加 DNS 协议的特殊处理规则

{
  "protocol": "dns",
  "outbound": "dnsOut"
}

3. 关闭 strict_route： 在某些环境下，strict_route 参数可能导致 DNS 查询被错误拦截

性能优化建议

1. GSO 参数调整： 在部分网络环境下，关闭 GSO(Generic Segmentation Offload)可提高稳定性

{
  "gso": false
}

2. MTU 设置： 根据实际网络环境调整 MTU 值，推荐设置为 9000 以提升大包传输效率

系统级配置注意事项

1. 主路由设置：

   • 添加静态路由 198.18.0.0/16 指向 sing-box 设备
   • 确保不与其他网络服务冲突

2. 系统 DNS 服务：

   • 如果使用 systemd-resolved，需协调端口占用问题
   • 考虑将 systemd-resolved 的上游设置为 sing-box 的 DNS 监听端口

3. 防火墙规则：

   • 确保放行相关端口和协议
   • 特别注意 NAT 规则的处理

最佳实践配置示例

以下是一个经过验证的稳定配置示例：

{
  "inbounds": [
    {
      "type": "tun",
      "tag": "tunIn",
      "interface_name": "tun0",
      "address": "172.19.0.1/30",
      "auto_route": true,
      "stack": "mixed",
      "sniff": true,
      "sniff_override_destination": true
    }
  ],
  "outbounds": [
    {
      "type": "direct",
      "tag": "directOut"
    },
    {
      "type": "dns",
      "tag": "dnsOut"
    }
  ],
  "route": {
    "rules": [
      {
        "protocol": "dns",
        "outbound": "dnsOut"
      },
      {
        "ip_is_private": true,
        "outbound": "directOut"
      }
    ]
  }
}

总结

sing-box 的 TUN 模式在旁路部署中提供了强大的流量处理能力，但需要仔细调整各项参数才能获得最佳效果。通过本文介绍的配置方法和问题解决方案，用户可以构建一个稳定高效的网络环境。实际部署时，建议根据具体网络环境进行适当调整，并通过逐步测试验证各项功能。