headscale-routing

Configure subnet routers and exit nodes in Headscale-managed mesh networks.

40|6|Updated Jul 11, 2026
One-click install
npx skills add https://github.com/magnus919/agent-skills --skill headscale-routing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: headscale-routing
Source: https://github.com/magnus919/agent-skills/tree/main/bundles/tailscale/skills/headscale-routing
Command: npx skills add https://github.com/magnus919/agent-skills --skill headscale-routing

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, tailscale, curl, and includes scripts (resource) components.

What problem does it solve?

This skill simplifies the complex task of configuring and managing subnet routers and exit nodes within a Headscale-managed tailnet, ensuring secure and reliable network access.

Core Features & Use Cases

  • Subnet Routing: Easily advertise local LAN subnets to your tailnet to allow remote access to non-Tailscale devices like NAS boxes or printers.
  • Exit Node Management: Configure gateway nodes to route internet traffic through your home network for enhanced privacy on untrusted public Wi-Fi.
  • Route Lifecycle: Provides automated tools to list, approve, and reject advertised routes, ensuring only authorized traffic flows through your network gateways.

Quick Start

Use the headscale-routing skill to advertise the local subnet 192.168.1.0/24 on the current node and then approve the resulting route on the Headscale server.

Frequently Asked Questions about headscale-routing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I advertise local subnets in a Headscale tailnet?

To advertise local subnets in a Headscale tailnet, you configure subnet routers on gateway nodes to broadcast local LAN subnets, allowing remote access to non-Tailscale devices like NAS boxes. You must then approve these advertised routes on the Headscale server.

Can I route internet traffic through my home network using Headscale?

Yes, you can route internet traffic through your home network using Headscale by configuring exit nodes on gateway nodes. This secures internet traffic and enhances privacy when connected to untrusted public Wi-Fi networks.

What is needed to manage Tailscale subnet routes with Headscale?

Managing Tailscale subnet routes with Headscale requires python3, tailscale, and curl installed. You also need access to the Headscale CLI or REST API and administrative privileges on the gateway nodes to approve routes.

How do I approve advertised routes across distributed infrastructure in Headscale?

You approve advertised routes across distributed infrastructure in Headscale by using automated tools to list and authorize network routes. This ensures only approved traffic flows through your network gateways during the route lifecycle.

Does this approach work for accessing non-Tailscale devices like printers remotely?

Yes, this approach works for accessing non-Tailscale devices like printers remotely by advertising local LAN subnets to your tailnet. Subnet routing extends tailnet connectivity to local area networks without requiring Tailscale installation on every device.

Why are my advertised subnet routes not working in Headscale?

Advertised subnet routes may not be working in Headscale because they require explicit approval on the Headscale server before traffic can flow. You must use the Headscale CLI or REST API to list and approve the routes advertised by your gateway nodes.