tun2socks项目Docker容器启动脚本解析

概述

tun2socks是一个将TUN设备流量通过SOCKS代理转发的工具，本文主要分析其Docker容器启动脚本entrypoint.sh的实现原理和配置方式。该脚本负责在容器启动时完成网络接口配置、路由规则设置等准备工作，最后启动tun2socks主程序。

核心功能模块

1. 网络接口创建

脚本首先创建一个TUN虚拟网络接口，并为其分配IP地址：

ip tuntap add mode tun dev "$TUN"
ip addr add "$ADDR" dev "$TUN"
ip link set dev "$TUN" up

• TUN变量默认为"tun0"，可通过环境变量覆盖
• ADDR变量默认为"198.18.0.1/15"，这是一个保留地址段

2. 路由表配置

脚本提供了两种路由表初始化方式：

1. 克隆主路由表（默认启用）：

   ip route show table main | while read -r route; do
     ip route add ${route%linkdown*} table "$TABLE"
   done
   

   这种方式会将主路由表的所有路由复制到自定义路由表中

2. 仅添加默认路由：

   ip route add default dev "$TUN" table "$TABLE"
   

   这种方式仅设置默认路由指向TUN设备

3. 策略路由配置

脚本设置了复杂的策略路由规则：

1. 标记数据包路由规则：

   ip rule add not fwmark "$FWMARK" table "$TABLE"
   ip rule add fwmark "$FWMARK" to "$ADDR" prohibit
   

2. 包含路由（TUN_INCLUDED_ROUTES）：

   for addr in $(echo "$TUN_INCLUDED_ROUTES" | tr ',' '\n'); do
     ip rule add to "$addr" table "$TABLE"
   done
   

3. 排除路由（TUN_EXCLUDED_ROUTES）：

   for addr in $(echo "$TUN_EXCLUDED_ROUTES" | tr ',' '\n'); do
     ip rule add to "$addr" table main
   done
   

配置参数详解

基础参数

• TUN: TUN设备名称，默认tun0
• ADDR: TUN设备IP地址，默认198.18.0.1/15
• LOGLEVEL: 日志级别，默认info
• TABLE: 路由表ID，默认0x22b
• FWMARK: 防火墙标记，默认0x22b
• CLONE_MAIN: 是否克隆主路由表，默认1(是)

高级参数

• MTU: 设置最大传输单元
• RESTAPI: 启用REST API监听地址
• UDP_TIMEOUT: UDP会话超时时间
• TCP_SNDBUF: TCP发送缓冲区大小
• TCP_RCVBUF: TCP接收缓冲区大小
• TCP_AUTO_TUNING: 启用TCP自动调优
• MULTICAST_GROUPS: 加入的多播组列表

路由控制参数

• TUN_INCLUDED_ROUTES: 强制通过TUN设备的路由，逗号分隔
• TUN_EXCLUDED_ROUTES: 排除不使用TUN设备的路由，逗号分隔
• EXTRA_COMMANDS: 额外执行的shell命令

使用建议

1. 基本使用：只需设置PROXY环境变量指定SOCKS代理地址即可运行

2. 路由控制：

   • 使用TUN_INCLUDED_ROUTES指定必须走代理的IP段
   • 使用TUN_EXCLUDED_ROUTES指定不走代理的IP段

3. 性能调优：

   • 根据网络情况调整MTU值
   • 对延迟敏感应用可调整UDP_TIMEOUT
   • 大流量传输可调整TCP缓冲区大小

4. 调试：

   • 设置LOGLEVEL=debug获取详细日志
   • 通过EXTRA_COMMANDS添加调试命令

实现原理

该脚本的核心思想是利用Linux的策略路由功能，将特定流量引导至TUN设备。通过防火墙标记(fwmark)和自定义路由表实现流量的灵活控制。tun2socks会处理到达TUN设备的所有流量，并通过配置的SOCKS代理转发。

这种设计使得：

• 可以精细控制哪些流量走代理
• 保持系统原有路由表不变
• 实现透明代理功能
• 支持多种代理协议

总结

tun2socks的Docker启动脚本提供了高度可配置的网络代理方案，通过合理的路由策略和参数调优，可以满足各种网络环境下的代理需求。理解其配置参数和工作原理，有助于在实际部署中实现最佳的网络性能和稳定性。