Struct NodeInfo 

pub struct NodeInfo {

    pub id: i64,
    pub stable_id: StableId,
    pub hostname: String,
    pub capability_version: CapabilityVersion,
    pub status: NodeStatus,
    pub tailnet: Option<String>,
    pub node_capabilities: BTreeMap<String, Vec<String>>,
    pub tags: Vec<String>,
    pub tailnet_address: TailnetAddress,
    pub node_key: NodePublicKey,
    pub node_key_expiry: Option<DateTime<Utc>>,
    pub machine_key: Option<MachinePublicKey>,
    pub disco_key: Option<DiscoPublicKey>,
    pub tailnet_lock_key_signature: Option<Vec<u8>>,
    pub accepted_routes: Vec<IpNet>,
    pub underlay_addresses: Vec<SocketAddr>,
    pub derp_region: Option<RegionId>,
}

A node in a tailnet.

Fields

id: i64

The node’s id.

stable_id: StableId

The node’s stable id.

hostname: String

The node’s hostname.

capability_version: CapabilityVersion

The node’s capability version.

status: NodeStatus

Whether the node is connected to the control plane or not. If NodeStatus::Unknown, the control plane hasn’t told us yet.

This field does not indicate whether the node is reachable or visible from this device.

tailnet: Option<String>

The tailnet this node belongs to.

node_capabilities: BTreeMap<String, Vec<String>>

The node capabilities assigned to this node.

tags: Vec<String>

The tags assigned to this node.

tailnet_address: TailnetAddress

The address of the node in the tailnet.

node_key: NodePublicKey

The node’s NodePublicKey.

node_key_expiry: Option<DateTime<Utc>>

The node key’s expiration.

machine_key: Option<MachinePublicKey>

The node’s MachinePublicKey, if known.

disco_key: Option<DiscoPublicKey>

The node’s DiscoPublicKey, if known.

tailnet_lock_key_signature: Option<Vec<u8>>

The signature of the node’s public key with the Tailnet Lock signing key, if Tailnet Lock is enabled and the signature is known.

accepted_routes: Vec<IpNet>

The routes this node accepts traffic for.

underlay_addresses: Vec<SocketAddr>

The underlay addresses this node is reachable on (Endpoints in Go).

derp_region: Option<RegionId>

The DERP region for this node, if known.

Implementations

impl Node

pub fn apply_update(&mut self, update: &NodeUpdate)

Apply the given partial update to this Node.

Panics

If update.id does not match self.id. The caller must guarantee this method is only called with NodeUpdates for this Node.

pub fn fqdn(&self, trailing_dot: bool) -> String

The fully-qualified domain name of the node.

This is a string of the form $HOST.$TAILNET_DOMAIN.. For tailnets controlled by Tailscale’s control plane, this usually means $HOST.tail1234.ts.net.

The trailing_dot parameter specifies whether to include the trailing dot in the fqdn. This is included by the definition of FQDN, and is the way the Go codebase formats this field, but the parameter is included to allow turning it off for use in contexts that expect it to be absent.

pub fn fqdn_opt(&self, trailing_dot: bool) -> Option<String>

The fully-qualified domain name of the node, only returning Some if the tailnet component is present.

See Node::fqdn.

pub fn matches_name(&self, name: &str) -> bool

Report whether this node matches the given name.

name is checked for equality with both this node’s bare hostname and its fqdn. A trailing . may be present.

Trait Implementations

impl Clone for Node

fn clone(&self) -> Node

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Node

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Eq for Node

impl From<&Node<'_>> for Node

fn from(value: &Node<'_>) -> Node

Converts to this type from the input type.

impl Hash for Node

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Node

fn eq(&self, other: &Node) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Node