# Headscale

Kategori: Nätverk och webbdrift · Koordinationsserver för WireGuard-nät

Självhostad koordinationsserver för Tailscale-klienter: delar ut adresser och nycklar till ett eget WireGuard-nät utan att trafiken går genom någon molntjänst.

- Officiell webbplats: https://headscale.net/stable/
- Infraverket: https://infraverket.eu/programvara/headscale/

## Öppenhet och driftsättning
Licens: BSD-3-Clause
Öppen källkod: Ja
Installationsmetod: Container
Plattformar: Linux, containers
Krävd databas: SQLite är standard och ligger på /var/lib/headscale/db.sqlite. PostgreSQL stöds fortfarande men beskrivs som underhållsläge i projektets FAQ.
Viktiga beroenden: En enda Go-binär utan externa tjänster utöver databasen. Officiella releaser finns som binärer för linux, darwin och freebsd samt .deb-paket för Debian och Ubuntu; containern är distroless-baserad med en -debug-variant. Servern måste vara nåbar på ett eget värdnamn med TLS, eftersom klienterna pekas mot den vid registrering.

## API och integrationer
Status: Finns (Uppgivet)
Typer: REST API
Dokumentation: https://headscale.net/stable/ref/api/
Anmärkning: Headscale har ett HTTP REST-API under /api/v1 med OpenAPI-dokumentation på serverns egen /api/v1/docs, autentiserat med API-nyckel (Bearer) som skapas med headscale apikeys create. Därutöver finns en Tailscale-kompatibel delmängd under /api/v2 med OAuth 2.0 client-credentials, avsedd för integrationer som redan talar Tailscales API.

## MCP och AI-agentintegration
Roll: MCP-server; Status: Saknas
Dokumentation: https://headscale.net/stable/ref/api/
Server: [headscale-mcp (tredjepart)](https://github.com/jaguar999paw-droid/headscale-mcp) — underhålls av community — ej-verifierat — Communityprojekt under MIT som styr Headscale via REST-API:t; inte affilierat med headscale-projektet och inte verifierat i drift.
Anmärkning: Ingen officiell MCP-server finns: dokumentationen har ingen MCP-sida och repots .mcp.json innehåller bara utvecklarverktyg. Fristående tredjepartsservrar finns på GitHub men är nystartade och inte etablerade.

## Tekniska resurser
- [Installationsguide](https://headscale.net/stable/setup/install/official/)
- [API-dokumentation](https://headscale.net/stable/ref/api/)
- [Container-registry](https://hub.docker.com/r/headscale/headscale)
- [juanfont/headscale – källkod (BSD-3-Clause)](https://github.com/juanfont/headscale)

## Viktiga tekniska anmärkningar
Hårdvarukrav: Litet: koordinationsservern hanterar nodlistor och nyckelutbyte, inte trafiken. En liten VM eller container med några hundra MB minne räcker för ett hemmalabb eller en mindre organisation.
Säkerhetsförutsättningar: TLS mot en publik värdnamn krävs för att klienterna ska acceptera servern. API-nycklar och förnycklar (preauthkeys) är hemligheter – förnycklar kan begränsas i tid och antal noder. Servern bör inte exponeras utan egen autentisering framför administrationsgränssnittet.

## Källhänvisning
- Infraverket: https://infraverket.eu/programvara/headscale/
- Senast faktagranskad: 2026-11-10
- Primärkällor:
  - [Headscale – dokumentation (stable)](https://headscale.net/stable/)
  - [Headscale – officiell installation](https://headscale.net/stable/setup/install/official/)
  - [Headscale – API-dokumentation](https://headscale.net/stable/ref/api/)
  - [juanfont/headscale – källkod och licens](https://github.com/juanfont/headscale)
  - [Headscale – exempelkonfiguration](https://github.com/juanfont/headscale/blob/main/config-example.yaml)
  - [Docker Hub – headscale/headscale](https://hub.docker.com/r/headscale/headscale)

---

Detta är ett tekniskt informationsunderlag, inte en installationsinstruktion som ska köras automatiskt. Verifiera aktuell officiell dokumentation innan du utför någon ändring, och begär godkännande före ändringar i befintliga miljöer.
