Files
stacks/headscale/config.yaml
T
valknar 6e96e33875 feat(traefik,headscale): restrict falcon.pivoine.art to Tailscale mesh only
Add a Traefik IP allowlist so *.falcon.pivoine.art rejects any source
outside the Tailscale/Headscale CIDR ranges, even though DNS still
resolves publicly. Pair it with a headscale MagicDNS override so
tailnet clients resolve the hostname straight to the VPS's tailscale
IP and route correctly.

Requires Docker's userland-proxy disabled on the VPS host
(/etc/docker/daemon.json) so Traefik sees real client source IPs
instead of the docker bridge gateway — done manually, not tracked
in this repo.
2026-08-16 16:51:53 +02:00

73 lines
1.7 KiB
YAML

# Base Headscale config. Host-specific values (server_url, listen addrs) are
# overridden via HEADSCALE_* environment variables in compose.yml, following
# headscale's viper env-binding (HEADSCALE_SERVER_URL overrides server_url, etc).
# Full reference: https://github.com/juanfont/headscale/blob/main/config-example.yaml
server_url: https://headscale.example.com
listen_addr: 0.0.0.0:8080
metrics_listen_addr: 127.0.0.1:9090
grpc_listen_addr: 127.0.0.1:50443
grpc_allow_insecure: false
noise:
private_key_path: /var/lib/headscale/noise_private.key
prefixes:
v4: 100.64.0.0/10
v6: fd7a:115c:a1e0::/48
allocation: sequential
derp:
server:
enabled: false
urls:
- https://controlplane.tailscale.com/derpmap/default
paths: []
auto_update_enabled: true
update_frequency: 24h
disable_check_updates: false
node:
ephemeral:
inactivity_timeout: 30m
database:
type: sqlite
sqlite:
path: /var/lib/headscale/db.sqlite
write_ahead_log: true
unix_socket: /var/run/headscale/headscale.sock
unix_socket_permission: "0770"
log:
format: text
level: info
policy:
mode: file
path: ""
dns:
magic_dns: true
base_domain: hs.internal
nameservers:
global:
- 1.1.1.1
- 1.0.0.1
search_domains: []
# Served only to tailnet clients via MagicDNS: overrides falcon.pivoine.art
# app hostnames to resolve to the VPS's tailscale IP instead of its public
# one, so VPN-connected clients route straight over the tunnel and satisfy
# Traefik's falcon-vpn-only IP allowlist.
extra_records:
- name: "triggershell.falcon.pivoine.art"
type: "A"
value: "100.64.0.3"
# TLS is terminated by Traefik; headscale itself serves plain HTTP internally.
tls_letsencrypt_hostname: ""
tls_cert_path: ""
tls_key_path: ""