Tailscale

[!NOTE] This document is partially generated by AI.

Cloudflare Warp (based on the Masque/QUIC protocol) is a service that provides a secure and fast connection to the internet. In yuhaiin, it is supported as an outbound protocol.

Network Support

• TCP: Supported (tunneled through Tailscale).
• UDP: Supported (tunneled through Tailscale).
  • NAT Type: Full-Cone NAT.

Outbound Configuration

The tailscale block allows you to join your Tailnet as a userspace node.

Configuration Fields

• auth_key (string): The authentication key generated from your Tailscale admin console. This key allows the yuhaiin node to join your Tailnet automatically.
• hostname (string): The name of the node as it will appear in your Tailnet (e.g., yuhaiin-client).
• control_url (string): (Optional) The URL of the Tailscale control plane. If you use Headscale instead of the official Tailscale service, set this to your Headscale server address.
• debug (bool): If enabled, prints detailed Tailscale internal logs for troubleshooting.

Example Configuration

{
  "name": "My-Tailnet-Outbound",
  "protocols": [
    {
      "tailscale": {
        "auth_key": "tskey-auth-...",
        "hostname": "yuhaiin-node",
        "debug": false
      }
    }
  ]
}

Developer Details

Node Connectivity

Once the tailscale outbound is active, yuhaiin can dial any node in your Tailnet using either its internal Tailscale IP (e.g., 100.x.y.z) or its MagicDNS name.

Implementation

This protocol utilizes the tailscale/tailscale library to run a full userspace WireGuard-based node (tsnet) within the yuhaiin process.