Versions in this module Expand all Collapse all v0 v0.3.7 Sep 11, 2026 v0.3.6 Sep 11, 2026 v0.3.5 Sep 10, 2026 v0.3.4 Sep 9, 2026 v0.3.3 Sep 8, 2026 v0.3.2 Sep 8, 2026 v0.3.1 Sep 5, 2026 v0.2.2 Aug 31, 2026 Changes in this version + var ErrDeviceAlreadyAttached = errors.New("tailscale: wgo device API already attached") + var ErrDeviceRequired = errors.New("tailscale: wgo device API required") type Client + func (c *Client) AttachDevice(api device.DeviceAPI) error + func (c *Client) Device() device.DeviceAPI v0.1.0 Aug 30, 2026 Changes in this version + const DefaultControlURL + const DefaultTransportID + var ErrAlreadyStarted = errors.New("tailscale: client already started") + var ErrClosed = errors.New("tailscale: client closed") + var ErrControlNodeKeyMismatch = errors.New(...) + var ErrInteractionNotFound = errors.New("tailscale: interaction not found") + var ErrNodeIdentityChanged = errors.New("tailscale: cached node identity does not match the wgo device") + var ErrNodeKeyExpired = errors.New(...) + var ErrNotStarted = errors.New("tailscale: client not started") + var ErrPeerConflict = errors.New("tailscale: peer public key is already owned by another wgo controller") + var ErrPeerNotFound = errors.New("tailscale: peer not found") + var ErrZeroNodeKey = errors.New("tailscale: wgo device has no private node key") + type ACLDestination struct + Bits *int + IP string + Ports PortRange + type ACLRule struct + CapabilityGrants []json.RawMessage + Destinations []ACLDestination + IPProtocols []int + SourceBits []int + SourceIPs []string + type ACLView struct + NamedRules map[string][]ACLRule + Revision uint64 + Rules []ACLRule + func (view ACLView) FirewallConfig() *gonnect.FirewallConfig + type CacheCallbacks struct + Load func(context.Context) ([]byte, error) + Store func(context.Context, []byte) error + type Client struct + func New(network gonnect.Network, dev WGODevice, options Options) (*Client, error) + func (c *Client) ACL() ACLView + func (c *Client) ACLAllows(source, destination netip.Addr, protocol int, port uint16) bool + func (c *Client) ACLFirewallConfig() *gonnect.FirewallConfig + func (c *Client) Close() error + func (c *Client) ConfirmPeer(ctx context.Context, id string) error + func (c *Client) CurrentInteraction() *Interaction + func (c *Client) DERP() DERPView + func (c *Client) DNS() DNSView + func (c *Client) DesiredNetworkConfiguration() NetworkConfiguration + func (c *Client) Done() <-chan struct{} + func (c *Client) Info() ClientInfo + func (c *Client) Peer(id string) (PeerInfo, bool) + func (c *Client) Peers() []PeerInfo + func (c *Client) Resolver() *MagicDNSResolver + func (c *Client) ResumeInteraction(id uint64) error + func (c *Client) RevokePeerConfirmation(ctx context.Context, id string) error + func (c *Client) Snapshot() Snapshot + func (c *Client) Start(parent context.Context) error + func (c *Client) State() State + func (c *Client) Subscribe(buffer int) (<-chan Event, func()) + func (c *Client) Wait() error + type ClientInfo struct + AuthenticatedAt time.Time + BackendLogID string + CapabilityVersion int + ControlURL string + DiscoPublicKey string + DisplayName string + Ephemeral bool + Hostname string + LoginName string + MachineAuthorized bool + MachinePublicKey string + MapSequence int64 + MapSessionHandle string + NodePublicKey device.NoisePublicKey + PeerConfirmation bool + PreferredDERP int64 + ProfilePicURL string + StartedAt time.Time + TransportID device.TransportID + UserID int64 + type ConfirmationState string + const PeerAwaitingConfirmation + const PeerConfirmationNotRequired + const PeerConfirmed + type DERPLatencySource string + const DERPLatencyHTTPS + const DERPLatencySTUN + type DERPNode struct + CertName string + DERPPort int + HostName string + IPv4 string + IPv6 string + InsecureForTests bool + Name string + RegionID int64 + STUNOnly bool + STUNPort int + STUNTestIP string + type DERPRegion struct + Code string + ID int64 + Latency time.Duration + LatencyMeasuredAt time.Time + LatencySource DERPLatencySource + Latitude float64 + Longitude float64 + Name string + NoMeasureNoHome bool + Nodes []DERPNode + type DERPView struct + Home int64 + Regions []DERPRegion + Revision uint64 + type DNSRecord struct + Name string + Type string + Value string + type DNSView struct + CertDomains []string + Nameservers []netip.Addr + Proxied bool + Records []DNSRecord + Resolvers []json.RawMessage + Revision uint64 + Routes map[string][]json.RawMessage + SearchDomains []string + type Event struct + At time.Time + Err error + Kind EventKind + Revision uint64 + type EventKind string + const EventACL + const EventDERP + const EventDNS + const EventError + const EventInteraction + const EventMetadata + const EventNetwork + const EventPeerPath + const EventPeers + const EventSelf + const EventState + const EventUsers + type Interaction struct + ID uint64 + Kind InteractionKind + Message string + Since time.Time + URL string + type InteractionKind string + const InteractionAuthenticate + const InteractionControlURL + const InteractionNodeKeyExpired + type LocalEndpoint struct + Address netip.AddrPort + Source string + type MagicDNSResolver struct + func (r *MagicDNSResolver) LookupAddr(ctx context.Context, address string) ([]string, error) + func (r *MagicDNSResolver) LookupHost(ctx context.Context, host string) ([]string, error) + func (r *MagicDNSResolver) LookupNetIP(ctx context.Context, network, host string) ([]netip.Addr, error) + type NetworkConfiguration struct + Addresses []netip.Prefix + DNS DNSView + InterfaceName string + MTU int + Revision uint64 + Routes []Route + Up bool + type NodeInfo struct + Addresses []netip.Prefix + AllowedIPs []netip.Prefix + Capabilities []string + CapabilityMap map[string][]json.RawMessage + CapabilityVersion int + ComputedName string + ComputedNameWithHost string + Created time.Time + DataPlaneAuditLogID string + DiscoPublicKey string + Endpoints []netip.AddrPort + ExitNodeDNSResolvers []json.RawMessage + Expired bool + HomeDERP int64 + HostinfoJSON json.RawMessage + ID int64 + IsJailed bool + IsWireGuardOnly bool + KeyExpiry time.Time + KeySignature []byte + LastSeen *time.Time + LegacyDERPString string + MachineAuthorized bool + MachinePublicKey string + Name string + Online *bool + PrimaryRoutes []netip.Prefix + PublicKey device.NoisePublicKey + RawJSON json.RawMessage + SelfNodeV4MasqAddrForThisPeer *netip.Addr + SelfNodeV6MasqAddrForThisPeer *netip.Addr + SharerID int64 + StableID string + Tags []string + UnsignedPeerAPIOnly bool + UserID int64 + type Options struct + AuthKey string + AuthenticationPollInterval time.Duration + Cache CacheCallbacks + ConfirmPeers bool + ControlURL string + DisableDERP bool + DisableDiscovery bool + Ephemeral bool + Hostname string + InterfaceName string + ListenPort uint16 + Logger *slog.Logger + MTU int + Obfuscation *device.AmneziaWGConfig + ReconnectMax time.Duration + ReconnectMin time.Duration + TLSConfig *tls.Config + TransportID device.TransportID + UseDefaultTransportForDirectPeers bool + type PathKind string + const PathDERP + const PathDirect + const PathNone + type PeerInfo struct + AppliedToWGO bool + Confirmation ConfirmationState + Direct netip.AddrPort + LastError string + Node NodeInfo + Path PathKind + PathLatency time.Duration + PathUpdated time.Time + PeerID string + type PortRange struct + First uint16 + Last uint16 + type Route struct + PeerID string + PeerPublicKey device.NoisePublicKey + Prefix netip.Prefix + Primary bool + type Snapshot struct + ACL ACLView + At time.Time + Client ClientInfo + ControlTime *time.Time + DERP DERPView + DNS DNSView + Domain string + Health []string + Interaction *Interaction + LastError string + LocalEndpoints []LocalEndpoint + Network NetworkConfiguration + Peers []PeerInfo + Revision uint64 + Self *NodeInfo + State State + Users []UserProfile + type State string + const StateDegraded + const StateNeedsAuthentication + const StateNew + const StateRunning + const StateStarting + const StateStopped + const StateStopping + type UserProfile struct + DisplayName string + Groups []string + ID int64 + LoginName string + ProfilePicURL string + type WGODevice interface + AddTransport func(device.TransportID, device.TransportConfig) error + DeletePeer func(device.NoisePublicKey) (bool, error) + PeerSpec func(device.NoisePublicKey) (device.PeerSpec, bool) + PrivateKey func() device.NoisePrivateKey + RemoveTransport func(device.TransportID) error + UpsertPeer func(device.PeerSpec) error
Go to main page