Merge pull request #19 from shadowy-pycoder/ipv6

Experimental support for IPv6

Author: shadowy-pycoder

README.md

@@ -24,6 +24,7 @@
   - [ARP spoofing](#arp-spoofing)
   - [UDP support](#udp-support)
   - [Android support](#android-support)
+  - [IPv6 support](#ipv6-support)
 - [Traffic sniffing](#traffic-sniffing)
   - [JSON format](#json-format)
   - [Colored format](#colored-format)
@@ -107,10 +108,10 @@ You can download the binary for your platform from [Releases](https://github.com
 Example:
 
 ```shell
-GOHPTS_RELEASE=v1.11.2; wget -v https://github.com/shadowy-pycoder/go-http-proxy-to-socks/releases/download/$GOHPTS_RELEASE/gohpts-$GOHPTS_RELEASE-linux-amd64.tar.gz -O gohpts && tar xvzf gohpts && mv -f gohpts-$GOHPTS_RELEASE-linux-amd64 gohpts && ./gohpts -h
+GOHPTS_RELEASE=v1.12.0; wget -v https://github.com/shadowy-pycoder/go-http-proxy-to-socks/releases/download/$GOHPTS_RELEASE/gohpts-$GOHPTS_RELEASE-linux-amd64.tar.gz -O gohpts && tar xvzf gohpts && mv -f gohpts-$GOHPTS_RELEASE-linux-amd64 gohpts && ./gohpts -h
 ```
 
-Alternatively, you can install it using `go install` command (requires Go [1.24](https://go.dev/doc/install) or later):
+Alternatively, you can install it using `go install` command (requires Go [1.26](https://go.dev/doc/install) or later):
 
 ```shell
 CGO_ENABLED=0 go install -ldflags "-s -w" -trimpath github.com/shadowy-pycoder/go-http-proxy-to-socks/cmd/gohpts@latest
@@ -160,6 +161,7 @@ OPTIONS:
   -u        User for SOCKS5 proxy authentication. This flag invokes prompt for password (not echoed to terminal)
   -i        Bind proxy to specific network interface (either by interface name or index)
   -f        Path to server configuration file in YAML format (overrides proxy flags above)
+  -6        Enable IPv6 support for TCP and UDP
 
   Logs:
   -d        Show logs in DEBUG mode
@@ -578,6 +580,40 @@ GOHPTS_RELEASE=v1.10.2; wget -v https://github.com/shadowy-pycoder/go-http-proxy
 sudo ./gohpts -s remote -t 8888 -Tu :8989 -M tproxy -sniff -body -auto -mark 100 -d -arpspoof "fullduplex true;debug false"
 ```
 
+### IPv6 support
+
+To enable IPv6 handling just add `-6` flag, for example when using with transparent proxy:
+
+```shell
+sudo ./gohpts -T 8888 -M redirect -sniff -body -auto -mark 100 -d -6
+```
+
+For this to work, your ISP and remote socks5 proxy should have active IPv6 support, you can visit [https://test-ipv6.com/](https://test-ipv6.com/) to find out you can access IPv6 addresses.
+To test proxy in IPv6 mode you can use any Linux VM:
+
+1. On your virtual machine:
+
+```shell
+# add your host machine as gateway for VM
+export GATEWAY="<host IPv4 address>"
+ip route add 0.0.0.0/1 via "$GATEWAY"
+ip route add 128.0.0.0/1 via "$GATEWAY"
+
+# add your host machine as gateway IPv6 for VM
+export GATEWAY6="<host IPv6 address>"
+ip -6 route add ::/1 via "$GATEWAY6" dev eth0
+ip -6 route add 8000::/1 via "$GATEWAY6" dev eth0
+```
+
+2. On your host:
+
+```shell
+# run proxy on your host
+sudo ./gohpts -T 8888 -Tu 8889 -M tproxy -sniff -body -auto -d -6
+```
+
+3. Visit any website on your virtual machine and see traffic in proxy logs
+
 ## Traffic sniffing
 
 [[Back]](#table-of-contents)

cmd/gohpts/cli.go

@@ -45,6 +45,7 @@ OPTIONS:
   -u        User for SOCKS5 proxy authentication. This flag invokes prompt for password (not echoed to terminal)
   -i        Bind proxy to specific network interface (either by interface name or index)
   -f        Path to server configuration file in YAML format (overrides proxy flags above)
+  -6        Enable IPv6 support for TCP and UDP
 
   Logs:
   -d        Show logs in DEBUG mode
@@ -98,6 +99,7 @@ func root(args []string) error {
 		"",
 		"Path to server configuration file in YAML format (overrides other proxy flags)",
 	)
+	flags.BoolVar(&conf.IPv6Enabled, "6", false, "Enable IPv6 support for TCP and UDP")
 	flags.StringVar(&conf.Interface, "i", "", "Bind proxy to specific network interface")
 	flags.BoolFunc("I", "Display list of network interfaces and exit", func(flagValue string) error {
 		if err := network.DisplayInterfaces(false); err != nil {

colorize.go

@@ -18,7 +18,7 @@ import (
 
 var (
 	ipPortPattern = regexp.MustCompile(
-		`(?:\[(?:[0-9a-fA-F:.]+)\]|(?:\d{1,3}\.){3}\d{1,3})(?::(6553[0-5]|655[0-2]\d|65[0-4]\d{2}|6[0-4]\d{3}|[1-5]?\d{1,4}))?`,
+		`(?:\[(?:[0-9a-fA-F:.]+(?:%[a-zA-Z0-9_.-]+)?)\]|(?:\d{1,3}\.){3}\d{1,3})(?::(6553[0-5]|655[0-2]\d|65[0-4]\d{2}|6[0-4]\d{3}|[1-5]?\d{1,4}))?`,
 	)
 	domainPattern = regexp.MustCompile(
 		`\b(?:[a-zA-Z0-9-]{1,63}\.)+(?:com|net|org|io|co|uk|ru|de|edu|gov|info|biz|dev|app|ai|tv)(?::(6553[0-5]|655[0-2]\d|65[0-4]\d{2}|6[0-4]\d{3}|[1-5]?\d{1,4}))?\b`,
@@ -167,7 +167,7 @@ func colorizeHTTP(
 		if body && len(*reqBodySaved) > 0 {
 			b := colorizeBody(reqBodySaved, nocolor)
 			if b != "" {
-				sb.WriteString("\n")
+				sb.WriteString("\033[K\n")
 				fmt.Fprintf(&sb, "%s ", colorizeTimestamp(time.Now(), nocolor))
 				sb.WriteString(id)
 				sb.WriteString(colors.RedBgDark(" req_body: ").String())
@@ -177,13 +177,14 @@ func colorizeHTTP(
 		if body && len(*respBodySaved) > 0 {
 			b := colorizeBody(respBodySaved, nocolor)
 			if b != "" {
-				sb.WriteString("\n")
+				sb.WriteString("\033[K\n")
 				fmt.Fprintf(&sb, "%s ", colorizeTimestamp(time.Now(), nocolor))
 				sb.WriteString(id)
 				sb.WriteString(colors.RedBgDark(" resp_body: ").String())
 				sb.WriteString(b)
 			}
 		}
+		sb.WriteString("\033[K")
 	}
 	return sb.String()
 }
@@ -241,7 +242,7 @@ func colorizeTLS(req *layers.TLSClientHello, resp *layers.TLSServerHello, id str
 			sb.WriteString(colors.BlueBg(fmt.Sprintf(" ALPN: %v", req.ALPN)).String())
 		}
 		sb.WriteString(colors.MagentaBg(" →  ").String())
-		sb.WriteString("\n")
+		sb.WriteString("\033[K\n")
 		fmt.Fprintf(&sb, "%s ", colorizeTimestamp(time.Now(), nocolor))
 		sb.WriteString(id)
 		sb.WriteString(colors.LightBlue(fmt.Sprintf(" %s ", resp.TypeDesc)).Bold())
@@ -260,6 +261,7 @@ func colorizeTLS(req *layers.TLSClientHello, resp *layers.TLSServerHello, id str
 		if resp.ExtensionLength > 0 {
 			sb.WriteString(colors.BeigeBg(fmt.Sprintf(" ExtLen: %d", resp.ExtensionLength)).String())
 		}
+		sb.WriteString("\033[K")
 	}
 	return sb.String()
 }
@@ -335,7 +337,7 @@ func colorizeDNS(req, resp *layers.DNSMessage, id string, nocolor bool) string {
 		for _, rec := range req.AdditionalRRs {
 			sb.WriteString(colorizeRData(rec))
 		}
-		sb.WriteString("\n")
+		sb.WriteString("\033[K\n")
 		fmt.Fprintf(&sb, "%s ", colorizeTimestamp(time.Now(), nocolor))
 		sb.WriteString(id)
 		sb.WriteString(colors.Blue(fmt.Sprintf(" DNS %s (%s)", resp.Flags.OPCodeDesc, resp.Flags.QRDesc)).Bold())
@@ -352,6 +354,7 @@ func colorizeDNS(req, resp *layers.DNSMessage, id string, nocolor bool) string {
 		for _, rec := range resp.AdditionalRRs {
 			sb.WriteString(colorizeRData(rec))
 		}
+		sb.WriteString("\033[K")
 	}
 	return sb.String()
 }
@@ -457,12 +460,13 @@ func colorizeConnections(srcRemote, srcLocal, dstRemote, dstLocal net.Addr, id s
 		sb.WriteString(colors.Green(fmt.Sprintf(" Src: %s→ %s", srcRemote, srcLocal)).String())
 		sb.WriteString(colors.Magenta(" →  ").String())
 		sb.WriteString(colors.Blue(fmt.Sprintf("Dst: %s→ %s", dstLocal, dstRemote)).String())
-		sb.WriteString("\n")
+		sb.WriteString("\033[K\n")
 		fmt.Fprintf(&sb, "%s ", colorizeTimestamp(time.Now(), nocolor))
 		sb.WriteString(id)
 		sb.WriteString(colors.Gray(fmt.Sprintf(" %s ", r.Method)).String())
 		sb.WriteString(colors.YellowBg(fmt.Sprintf("%s ", r.Host)).String())
 		sb.WriteString(colors.BlueBg(fmt.Sprintf("%s ", r.Proto)).String())
+		sb.WriteString("\033[K")
 	}
 	return sb.String()
 }
@@ -489,6 +493,7 @@ func colorizeConnectionsTransparent(
 		sb.WriteString(colors.Magenta(" →  ").String())
 		sb.WriteString(colors.Blue(fmt.Sprintf("Dst: %s→ %s ", dstLocal, dstRemote)).String())
 		sb.WriteString(colors.BeigeBg(fmt.Sprintf("Orig Dst: %s", dst)).String())
+		sb.WriteString("\033[K")
 	}
 	return sb.String()
 }

go.mod

@@ -1,14 +1,14 @@
 module github.com/shadowy-pycoder/go-http-proxy-to-socks
 
-go 1.25.7
+go 1.26.0
 
 require (
 	github.com/goccy/go-yaml v1.18.0
 	github.com/google/uuid v1.6.0
 	github.com/rs/zerolog v1.34.0
 	github.com/shadowy-pycoder/arpspoof v0.0.1
 	github.com/shadowy-pycoder/colors v0.0.1
-	github.com/shadowy-pycoder/mshark v0.0.18
+	github.com/shadowy-pycoder/mshark v0.0.20
 	github.com/wzshiming/socks5 v0.5.2
 	golang.org/x/sys v0.33.0
 	golang.org/x/term v0.32.0

go.sum

@@ -36,8 +36,8 @@ github.com/shadowy-pycoder/arpspoof v0.0.1 h1:K5D+cVGc3SCTI4VxSB6oE2x8SJgxRjE72E
 github.com/shadowy-pycoder/arpspoof v0.0.1/go.mod h1:dsVZh4gbbQFA4BQLEmL2qpsjtytKwxaf4oA2tRmvCW8=
 github.com/shadowy-pycoder/colors v0.0.1 h1:weCj/YIOupqy4BSP8KuVzr20fC+cuAv/tArz7bhhkP4=
 github.com/shadowy-pycoder/colors v0.0.1/go.mod h1:lkrJS1PY2oVigNLTT6pkbF7B/v0YcU2LD5PZnss1Q4U=
-github.com/shadowy-pycoder/mshark v0.0.18 h1:SaNsl7U2N1LaDc8ZGfdOclRI0UsyiDE/39NjxU2dHnQ=
-github.com/shadowy-pycoder/mshark v0.0.18/go.mod h1:Txx0p8JxYOGd+0V+6N9MeCUGtGdfHAATWE8KB1nd7H0=
+github.com/shadowy-pycoder/mshark v0.0.20 h1:xZTvrh3nFHIagPsv756P4gNEz1IOj3Fc4+fRc0feWhc=
+github.com/shadowy-pycoder/mshark v0.0.20/go.mod h1:1XgkjUmooSY3p9ygd0iInTrijsYbcKMQ7RXJLNP0Ygs=
 github.com/stretchr/testify v1.9.0 h1:HtqpIVDClZ4nwg75+f6Lvsy/wHu+3BoSGCbBAcpTsTg=
 github.com/stretchr/testify v1.9.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
 github.com/wzshiming/socks5 v0.5.2 h1:LtoowVNwAmkIQSkP1r1Wg435xUmC+tfRxorNW30KtnM=