The custom version of headscale utilized by myriation. This follows upstream main, with a couple of open PRs manually merged in.
https://ts.myriation.xyz
cmd/headscale | ||
docker | ||
.gitignore | ||
api.go | ||
app.go | ||
config.json.example | ||
db.go | ||
derp.yaml | ||
go.mod | ||
go.sum | ||
LICENSE | ||
machine.go | ||
namespaces.go | ||
README.md | ||
utils.go |
Headscale
An open source implementation of the Tailscale coordination server.
Status
- Basic functionality (nodes can communicate with each other)
- Node registration through the web flow
- Network changes are relied to the nodes
MultiuserNamespace support- Basic routing (advertise & accept)
- Share nodes between
usersnamespaces - Node registration via pre-auth keys
- ACLs
- DNS
... and probably lots of stuff missing
Roadmap 🤷
Basic multiuser support (multinamespace, actually) is now implemented. No node sharing or ACLs between namespaces yet though...
Pre-auth keys should also be feasible.
Suggestions/PRs welcomed!
Running it
- Compile the headscale binary
go build cmd/headscale/headscale.go
- Get youself a PostgreSQL DB running (yes, I know)
docker run --name headscale -e POSTGRES_DB=headscale -e \
POSTGRES_USER=foo -e POSTGRES_PASSWORD=bar -p 5432:5432 -d postgres
- Sort some stuff up (headscale Wireguard keys & the config.json file)
wg genkey > private.key
wg pubkey < private.key > public.key # not needed
cp config.json.example config.json
- Create a namespace (equivalent to a user in tailscale.com)
./headscale namespace create myfirstnamespace
- Run the server
./headscale serve
- Add your first machine
tailscale up -login-server YOUR_HEADSCALE_URL
-
Navigate to the URL you will get with
tailscale up
, where you'll find your machine key. -
In the server, register your machine to a namespace with the CLI
./headscale register YOURMACHINEKEY myfirstnamespace
Disclaimer
- I have nothing to do with Tailscale, or Tailscale Inc.
- The purpose of writing this was to learn how Tailscale works.
- I don't use Headscale myself.