Golang基于gVisor TCP/IP栈实现的tun2socks网络隧道插件库tun2socks的使用

特性

• 通用代理：透明地将任何应用程序的所有网络流量通过代理路由
• 多协议支持：支持HTTP/SOCKS4/SOCKS5/Shadowsocks代理，可选认证
• 跨平台：在Linux/macOS/Windows/FreeBSD/OpenBSD上运行，具有平台特定优化
• 网关模式：作为第3层网关，路由来自同一网络其他设备的流量
• 完整的IPv6兼容性：原生支持IPv6；无缝隧道IPv4 over IPv6和反之亦然
• 用户空间网络：利用gVisor网络栈提高性能和灵活性

基准测试

在各种使用场景下，tun2socks表现最佳。

使用示例

下面是一个完整的Golang示例，展示如何使用tun2socks库创建网络隧道：

package main

import (
	"log"
	"os"
	"os/signal"
	"syscall"

	"github.com/xjasonlyu/tun2socks/v2/core/device"
	"github.com/xjasonlyu/tun2socks/v2/core/device/tun"
	"github.com/xjasonlyu/tun2socks/v2/core/option"
	"github.com/xjasonlyu/tun2socks/v2/proxy/proxy"
	"github.com/xjasonlyu/tun2socks/v2/tunnel"
)

func main() {
	// 1. 创建TUN设备
	tunDevice, err := tun.CreateTUN("tun0", 1500)
	if err != nil {
		log.Fatalf("Failed to create TUN device: %v", err)
	}

	// 2. 配置代理
	proxyURL := "socks5://127.0.0.1:1080" // 本地SOCKS5代理
	p, err := proxy.FromURL(proxyURL)
	if err != nil {
		log.Fatalf("Failed to parse proxy URL: %v", err)
	}

	// 3. 配置隧道选项
	opts := []option.Option{
		option.WithDevice(tunDevice),
		option.WithProxy(p),
		option.WithLogger(&myLogger{}), // 自定义日志记录器
	}

	// 4. 创建隧道
	t, err := tunnel.New(opts...)
	if err != nil {
		log.Fatalf("Failed to create tunnel: %v", err)
	}

	// 5. 启动隧道
	if err := t.Start(); err != nil {
		log.Fatalf("Failed to start tunnel: %v", err)
	}
	defer t.Stop()

	log.Println("tun2socks started successfully")

	// 6. 等待终止信号
	sigCh := make(chan os.Signal, 1)
	signal.Notify(sigCh, syscall.SIGINT, syscall.SIGTERM)
	<-sigCh

	log.Println("Shutting down tun2socks...")
}

// 自定义日志记录器实现
type myLogger struct{}

func (l *myLogger) Debug(format string, args ...interface{}) {
	log.Printf("[DEBUG] "+format, args...)
}

func (l *myLogger) Info(format string, args ...interface{}) {
	log.Printf("[INFO] "+format, args...)
}

func (l *myLogger) Warn(format string, args ...interface{}) {
	log.Printf("[WARN] "+format, args...)
}

func (l *myLogger) Error(format string, args ...interface{}) {
	log.Printf("[ERROR] "+format, args...)
}

更复杂的示例

下面是一个更完整的示例，包含更多配置选项：

package main

import (
	"log"
	"net"
	"os"
	"os/signal"
	"syscall"

	"github.com/xjasonlyu/tun2socks/v2/core/device"
	"github.com/xjasonlyu/tun2socks/v2/core/device/tun"
	"github.com/xjasonlyu/tun2socks/v2/core/option"
	"github.com/xjasonlyu/tun2socks/v2/proxy/proxy"
	"github.com/xjasonlyu/tun2socks/v2/tunnel"
)

func main() {
	// 配置TUN设备
	tunName := "tun0"
	mtu := 1500
	address := "10.0.0.1/24" // TUN设备IP地址
	gateway := "10.0.0.1"     // 网关地址

	// 创建TUN设备
	tunDevice, err := tun.CreateTUN(tunName, mtu)
	if err != nil {
		log.Fatalf("Failed to create TUN device: %v", err)
	}

	// 设置TUN设备IP地址
	if err := setTUNAddress(tunName, address, gateway, mtu); err != nil {
		log.Fatalf("Failed to set TUN address: %v", err)
	}

	// 配置SOCKS5代理
	proxyURL := "socks5://user:password@127.0.0.1:1080" // 带认证的SOCKS5代理
	p, err := proxy.FromURL(proxyURL)
	if err != nil {
		log.Fatalf("Failed to parse proxy URL: %v", err)
	}

	// 高级配置选项
	opts := []option.Option{
		option.WithDevice(tunDevice),
		option.WithProxy(p),
		option.WithMTU(uint32(mtu)),
		option.WithTCPModerateReceiveBuffer(true),
		option.WithTCPBufferSize(4*1024*1024, 4*1024*1024), // 4MB TCP缓冲区
		option.WithUDPBufferSize(1*1024*1024),              // 1MB UDP缓冲区
		option.WithUDPTimeout(30),                          // 30秒UDP超时
		option.WithLogger(&myLogger{}),
	}

	// 创建并启动隧道
	t, err := tunnel.New(opts...)
	if err != nil {
		log.Fatalf("Failed to create tunnel: %v", err)
	}

	if err := t.Start(); err != nil {
		log.Fatalf("Failed to start tunnel: %v", err)
	}
	defer t.Stop()

	log.Printf("tun2socks started on %s with proxy %s", tunName, proxyURL)

	// 等待终止信号
	sigCh := make(chan os.Signal, 1)
	signal.Notify(sigCh, syscall.SIGINT, syscall.SIGTERM)
	<-sigCh

	log.Println("Shutting down tun2socks...")
}

// 设置TUN设备IP地址和路由
func setTUNAddress(name, addr, gateway string, mtu int) error {
	// 这里应该包含平台特定的代码来配置TUN设备
	// 例如在Linux上使用ip命令:
	// ip addr add <addr> dev <name>
	// ip link set <name> up
	// ip route add default via <gateway> dev <name> mtu <mtu>
	return nil
}

// 自定义日志记录器实现
type myLogger struct{}

func (l *myLogger) Debug(format string, args ...interface{}) {
	log.Printf("[DEBUG] "+format, args...)
}

func (l *myLogger) Info(format string, args ...interface{}) {
	log.Printf("[INFO] "+format, args...)
}

func (l *myLogger) Warn(format string, args ...interface{}) {
	log.Printf("[WARN] "+format, args...)
}

func (l *myLogger) Error(format string, args ...interface{}) {
	log.Printf("[ERROR] "+format, args...)
}

注意事项

1. 使用tun2socks需要管理员/root权限来创建TUN设备
2. 在Windows上需要安装Wintun驱动程序
3. 需要正确配置系统路由表以将流量定向到TUN设备
4. 对于生产环境，建议添加适当的错误处理和重试逻辑

许可证

所有v2.6.0及更高版本均可在MIT许可证条款下使用。