pingtunnel

README

Pingtunnel

pingtunnel是把udp流量伪装成icmp流量进行转发的工具，类似于kcptun。用于突破网络封锁，或是绕过WIFI网络的登陆验证。可以与kcptun很方便的结合使用。
Pingtunnel is a tool that advertises udp traffic as icmp traffic for forwarding, similar to kcptun. Used to break through the network blockade, or to bypass the WIFI network login verification. Can be combined with kcptun very convenient.

Sample

如把本机的:4455的UDP流量转发到www.yourserver.com:4455：For example, the UDP traffic of the machine: 4545 is forwarded to www.yourserver.com:4455:

• 在www.yourserver.com的服务器上用root权限运行。Run with root privileges on the server at www.yourserver.com

sudo ./pingtunnel -type server

• 在你本地电脑上用管理员权限运行。Run with administrator privileges on your local computer

pingtunnel.exe -type client -l :4455 -s www.yourserver.com -t www.yourserver.com:4455

• 如果看到客户端不停的ping、pong日志输出，说明工作正常。If you see the client ping, pong log output, it means normal work

ping www.xx.com 2018-12-23 13:05:50.5724495 +0800 CST m=+3.023909301 8 0 1997 2
pong from xx.xx.xx.xx 210.8078ms

注意

对于某些网络，比如长城宽带、宽带通，需要特殊处理才能正常工作。方法是

• 关闭服务器的系统ping，例如

echo 1 > /proc/sys/net/ipv4/icmp_echo_ignore_all 

• 客户端添加catch参数，用来主动抓取服务器回包，100就是每秒主动抓100个包

pingtunnel.exe -type client -l :4455 -s www.yourserver.com -t www.yourserver.com:4455 -catch 100

• 这个是在某开放wifi上，利用shadowsocks、kcptun、pingtunnel绕过验证直接上网，可以看到wifi是受限的，但是仍然可以通过远程访问网络，ip地址显示是远程服务器的地址，因为他没有禁ping

Usage

通过伪造ping，把udp流量通过远程服务器转发到目的服务器上。用于突破某些运营商封锁UDP流量。
By forging ping, the udp traffic is forwarded to the destination server through the remote server. Used to break certain operators to block UDP traffic.

Usage:

pingtunnel -type server

pingtunnel -type client -l LOCAL_IP:4455 -s SERVER_IP -t SERVER_IP:4455

-type     服务器或者客户端
          client or server

-l        本地的地址，发到这个端口的流量将转发到服务器
          Local address, traffic sent to this port will be forwarded to the server

-s        服务器的地址，流量将通过隧道转发到这个服务器
          The address of the server, the traffic will be forwarded to this server through the tunnel

-t        远端服务器转发的目的地址，流量将转发到这个地址
          Destination address forwarded by the remote server, traffic will be forwarded to this address

-timeout  本地记录连接超时的时间，单位是秒
          The time when the local record connection timed out, in seconds

-sproto   客户端发送ping协议的协议，默认是13
          The protocol that the client sends the ping. The default is 13.

-rproto   客户端接收ping协议的协议，默认是14
          The protocol that the client receives the ping. The default is 14.

-catch    主动抓模式，每秒从服务器主动抓多少个reply包，默认0
          Active capture mode, how many reply packets are actively captured from the server per second, default 0

-key      设置的密码，默认0
          Set password, default 0

Documentation

Index

• Constants
• func GetMd5String(s string) string
• func UniqueId() string
• type CatchMsg
• type Client
  • func NewClient(addr string, server string, target string, timeout int, sproto int, rproto int, ...) (*Client, error)
  • func (p *Client) Accept() error
  • func (p *Client) Addr() string
  • func (p *Client) Close(clientConn *ClientConn)
  • func (p *Client) IPAddr() *net.UDPAddr
  • func (p *Client) Run()
  • func (p *Client) ServerAddr() string
  • func (p *Client) ServerIPAddr() *net.IPAddr
  • func (p *Client) TargetAddr() string
• type ClientConn
• type MyMsg
  • func (p *MyMsg) Len(proto int) int
  • func (p *MyMsg) LenData(data []byte) int
  • func (p *MyMsg) LenString(s string) int
  • func (p *MyMsg) Marshal(proto int) ([]byte, error)
  • func (p *MyMsg) MarshalData(data []byte) []byte
  • func (p *MyMsg) MarshalString(s string) []byte
  • func (p *MyMsg) Unmarshal(b []byte) error
  • func (p *MyMsg) UnmarshalData(b []byte) []byte
  • func (p *MyMsg) UnmarshalString(b []byte) string
• type Packet
• type Server
  • func NewServer(timeout int, key int) (*Server, error)
  • func (p *Server) Close(conn *ServerConn)
  • func (p *Server) Recv(conn *ServerConn, id string, src *net.IPAddr)
  • func (p *Server) Run()
• type ServerConn

Constants

const (
	DATA  uint32 = 0x01010101
	PING  uint32 = 0x02020202
	CATCH uint32 = 0x03030303
	END   uint32 = 0xAAAABBBB
)

Functions

func GetMd5String

func GetMd5String(s string) string

func UniqueId

func UniqueId() string

Types

type CatchMsg

type CatchMsg struct {
	// contains filtered or unexported fields
}

type Client

type Client struct {
	// contains filtered or unexported fields
}

func NewClient

func NewClient(addr string, server string, target string, timeout int, sproto int, rproto int, catch int, key int) (*Client, error)

func (*Client) Accept

func (p *Client) Accept() error

func (*Client) Addr

func (p *Client) Addr() string

func (*Client) Close

func (p *Client) Close(clientConn *ClientConn)

func (*Client) IPAddr

func (p *Client) IPAddr() *net.UDPAddr

func (*Client) Run

func (p *Client) Run()

func (*Client) ServerAddr

func (p *Client) ServerAddr() string

func (*Client) ServerIPAddr

func (p *Client) ServerIPAddr() *net.IPAddr

func (*Client) TargetAddr

func (p *Client) TargetAddr() string

type ClientConn

type ClientConn struct {
	// contains filtered or unexported fields
}

type MyMsg

type MyMsg struct {
	TYPE    uint32
	ID      string
	TARGET  string
	Data    []byte
	RPROTO  uint16
	CATCH   uint16
	KEY     uint32
	ENDTYPE uint32
}

func (*MyMsg) Len

func (p *MyMsg) Len(proto int) int

Len implements the Len method of MessageBody interface.

func (*MyMsg) LenData

func (p *MyMsg) LenData(data []byte) int

func (*MyMsg) LenString

func (p *MyMsg) LenString(s string) int

func (*MyMsg) Marshal

func (p *MyMsg) Marshal(proto int) ([]byte, error)

Marshal implements the Marshal method of MessageBody interface.

func (*MyMsg) MarshalData

func (p *MyMsg) MarshalData(data []byte) []byte

func (*MyMsg) MarshalString

func (p *MyMsg) MarshalString(s string) []byte

func (*MyMsg) Unmarshal

func (p *MyMsg) Unmarshal(b []byte) error

Marshal implements the Marshal method of MessageBody interface.

func (*MyMsg) UnmarshalData

func (p *MyMsg) UnmarshalData(b []byte) []byte

func (*MyMsg) UnmarshalString

func (p *MyMsg) UnmarshalString(b []byte) string

type Packet

type Packet struct {
	// contains filtered or unexported fields
}

type Server

type Server struct {
	// contains filtered or unexported fields
}

func NewServer

func NewServer(timeout int, key int) (*Server, error)

func (*Server) Close

func (p *Server) Close(conn *ServerConn)

func (*Server) Recv

func (p *Server) Recv(conn *ServerConn, id string, src *net.IPAddr)

func (*Server) Run

func (p *Server) Run()

type ServerConn

type ServerConn struct {
	// contains filtered or unexported fields
}