datachannels

package
v0.13.1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Oct 11, 2023 License: Apache-2.0 Imports: 18 Imported by: 0

Documentation

Overview

Package datachannels provides a WebRTC data channel API for port forwarding.

Index

Constants

View Source 
const DefaultWireGuardProxyBuffer = 1024 * 1024

DefaultWireGuardProxyBuffer is the default buffer size for the WireGuard proxy. TODO: Make this configurable.

Variables

This section is empty.

Functions

This section is empty.

Types

type ClientChannel 

type ClientChannel interface {
	// Ready returns a channel that is closed when the data channel is ready.
	Ready() <-chan struct{}
	// Errors returns a channel for receiving errors.
	Errors() <-chan error
	// Closed returns a channel for receiving a notification when the data channel is closed.
	Closed() <-chan struct{}
	// Open opens a new data channel.
	Open(ctx context.Context, proto string) (io.ReadWriteCloser, error)
	// Close closes the peer connection and all data channels.
	Close() error
}

ClientChannel is a client-side data channel.

func NewClientChannel 

func NewClientChannel(ctx context.Context, rt transport.WebRTCSignalTransport) (ClientChannel, error)

NewClientChannel creates a new client-side data channel.

type ClientOptions 

type ClientOptions struct {
	// Client is the webmesh client for performing ICE negotiation.
	Client v1.WebRTCClient
	// NodeID is the node ID to request for connection channels.
	NodeID string
	// Protocol is the protocol to request for connection channels.
	Protocol string
	// Destination is the destination address to request for connection channels.
	Destination string
	// Port is the destination port to request for connection channels.
	// A port of 0 with the udp protocol indicates WireGuard interface traffic.
	Port uint32
}

ClientOptions are options for configuring a client peer connection.

type ManagedServerChannel 

type ManagedServerChannel interface {
	// Offer returns the offer for the data channel.
	Offer() string
	// AnswerOffer answers the offer from the peer.
	AnswerOffer(offer string) error
	// Candidates returns a channel for receiving ICE candidates.
	Candidates() <-chan string
	// AddCandidate adds an ICE candidate.
	AddCandidate(candidate string) error
	// Closed returns a channel for receiving a notification when the data channel is closed.
	Closed() <-chan struct{}
	// Close closes the data channel.
	Close() error
}

ManagedServerChannel is a channel that is managed for a particular purpose. This is currently used for the WireGuard proxy and the port-forwarding data channels.

type OfferOptions 

type OfferOptions struct {
	// Proto is the protocol used for the connection.
	// Defaults to "tcp".
	Proto string
	// SrcAddress is the source address and port of the client that
	// initiated the connection.
	SrcAddress string
	// DstAddress is the destination address and port of the connection.
	DstAddress string
	// STUNServers is a list of STUN servers to use for the connection.
	STUNServers []string
}

Offer represents an offer to be sent to a peer.

type PeerConnectionClient 

type PeerConnectionClient struct {
	// PeerConnection is the underlying WebRTC peer connection.
	*webrtc.PeerConnection
	// contains filtered or unexported fields
}

PeerConnectionClient is a WebRTC peer connection for port forwarding.

func NewPeerConnectionClient 

func NewPeerConnectionClient(ctx context.Context, protocol string, rt transport.WebRTCSignalTransport) (*PeerConnectionClient, error)

NewPeerConnectionClient creates a new peer connection client.

func (*PeerConnectionClient) Closed 

func (pc *PeerConnectionClient) Closed() <-chan struct{}

Closed returns a channel for receiving a notification when the peer connection is closed.

func (*PeerConnectionClient) Errors 

func (pc *PeerConnectionClient) Errors() <-chan error

Errors returns a channel for receiving errors from the peer connection.

func (*PeerConnectionClient) Handle 

func (pc *PeerConnectionClient) Handle(conn net.Conn)

Handle handles the given connection.

func (*PeerConnectionClient) ListenAndServe 

func (pc *PeerConnectionClient) ListenAndServe(ctx context.Context, proto, addr string) error

ListenAndServe creates a listener and passes incoming connections to the handler.

func (*PeerConnectionClient) Ready 

func (pc *PeerConnectionClient) Ready() <-chan struct{}

Ready returns a channel for receiving a notification when the peer connection is ready.

func (*PeerConnectionClient) Serve 

func (pc *PeerConnectionClient) Serve(ctx context.Context, l net.Listener) error

Serve handles connections on the given listener.

type PeerConnectionServer 

type PeerConnectionServer struct {
	// PeerConnection is the underlying WebRTC peer connection.
	*webrtc.PeerConnection
	// contains filtered or unexported fields
}

PeerConnectionServer represents a connection to a peer where we forward traffic for the other end.

func NewPeerConnectionServer 

func NewPeerConnectionServer(ctx context.Context, opts *OfferOptions) (*PeerConnectionServer, error)

NewPeerConnectionServer creates a new peer connection server with the given options.

func (*PeerConnectionServer) AddCandidate 

func (pc *PeerConnectionServer) AddCandidate(cand string) error

AddCandidate adds an ICE candidate to the peer connection.

func (*PeerConnectionServer) AnswerOffer 

func (pc *PeerConnectionServer) AnswerOffer(answer string) error

AnswerOffer answers the given offer from the peer.

func (*PeerConnectionServer) Candidates 

func (pc *PeerConnectionServer) Candidates() <-chan string

Candidates returns a channel that will receive potential ICE candidates for the peer.

func (*PeerConnectionServer) Closed 

func (pc *PeerConnectionServer) Closed() <-chan struct{}

Closed returns a channel that will be closed when the peer connection is closed.

func (*PeerConnectionServer) IsClosed 

func (pc *PeerConnectionServer) IsClosed() bool

IsClosed returns true if the peer connection is closed.

func (*PeerConnectionServer) Offer 

func (pc *PeerConnectionServer) Offer() string

Offer returns the offer to be sent to the peer.

func (*PeerConnectionServer) Ready 

func (pc *PeerConnectionServer) Ready() <-chan struct{}

Ready returns a channel that will be closed when the peer connection is ready.

type ServerChannel 

type ServerChannel interface {
	// Accept accepts a new connection channel.
	Accept() (proto string, rw io.ReadWriteCloser, err error)
	// Ready returns a channel that is closed when the data channel is ready.
	Ready() <-chan struct{}
	// Errors returns a channel for receiving errors.
	Errors() <-chan error
	// Closed returns a channel for receiving a notification when the data channel is closed.
	Closed() <-chan struct{}
	// Close closes the data channel.
	Close() error
}

ServerChannel is a server-side data channel.

func NewServerChannel 

func NewServerChannel(ctx context.Context, rt transport.WebRTCSignalTransport) (ServerChannel, error)

NewServerChannel creates a new server-side data channel.

type WireGuardProxyClient 

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

WireGuardProxyClient is a WireGuard proxy client. It is used for outgoing requests to establish a WireGuard proxy connection.

func NewWireGuardProxyClient 

func NewWireGuardProxyClient(ctx context.Context, rt transport.WebRTCSignalTransport, targetPort uint16) (*WireGuardProxyClient, error)

NewWireGuardProxyClient creates a new WireGuardProxyClient using the given signaling transport. Traffic will be proxied to the wireguard interface listening on targetPort. It contains a method for retrieving the local address to use as a WireGuard endpoint for the peer on the other side of the proxy.

func (*WireGuardProxyClient) Close 

func (w *WireGuardProxyClient) Close() error

Close closes the proxy.

func (*WireGuardProxyClient) Closed 

func (w *WireGuardProxyClient) Closed() <-chan struct{}

Closed returns a channel that is closed when the proxy is closed.

func (*WireGuardProxyClient) LocalAddr 

func (w *WireGuardProxyClient) LocalAddr() *net.UDPAddr

LocalAddr returns the local UDP address for the proxy. This should be used as the endpoint for the WireGuard interface.

type WireGuardProxyServer 

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

WireguardProxyServer is a WebRTC datachannel proxy for WireGuard. It is used for incoming requests to proxy traffic to a WireGuard interface.

func NewWireGuardProxyServer 

func NewWireGuardProxyServer(ctx context.Context, stunServers []string, targetPort uint16) (*WireGuardProxyServer, error)

NewWireGuardProxyServer creates a new WireGuardProxyServer using the given STUN servers for ICE negotiation. Traffic will be proxied to the wireguard interface listening on targetPort.

func (*WireGuardProxyServer) AddCandidate 

func (w *WireGuardProxyServer) AddCandidate(cand string) error

AddCandidate adds an ICE candidate to the peer connection.

func (*WireGuardProxyServer) AnswerOffer 

func (w *WireGuardProxyServer) AnswerOffer(answer string) error

AnswerOffer sets the answer to the offer returned by the peer.

func (*WireGuardProxyServer) Candidates 

func (w *WireGuardProxyServer) Candidates() <-chan string

Candidates returns a channel that will receive potential ICE candidates to be sent to the peer.

func (*WireGuardProxyServer) Close 

func (w *WireGuardProxyServer) Close() error

Close closes the peer connection.

func (*WireGuardProxyServer) Closed 

func (w *WireGuardProxyServer) Closed() <-chan struct{}

Closed returns a channel that will be closed when the peer connection is closed.

func (*WireGuardProxyServer) Offer 

func (w *WireGuardProxyServer) Offer() string

Offer returns the offer to be sent to the peer.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.