test(net): TLS-enabled docker stack and active e2e test

The docker-compose stack now serves Headscale (and its embedded DERP)
over TLS on port 8443 with a self-signed cert covering localhost,
127.0.0.1, and the docker-network hostname `headscale`. Tailscale
peers trust the cert via SSL_CERT_FILE; our test daemon uses
`derp_tls_insecure: true` (gated on the SUNBEAM_NET_TEST_DERP_INSECURE
env var) since pinning a self-signed root in tests is more trouble
than it's worth.

With TLS DERP working, the previously-ignored
`test_e2e_tcp_through_tunnel` test now passes: the daemon spawns,
registers, completes a Noise handshake over TLS, opens a TLS DERP
relay session, runs a real WireGuard handshake with peer-a (verified
via boringtun ↔ tailscale interop), and TCP-tunnels an HTTP GET
through smoltcp ↔ engine ↔ proxy ↔ test client. The 191-byte echo
response round-trips and the test asserts on its body.

- tests/config/headscale.yaml: tls_cert_path + tls_key_path, listen on
  8443, server_url=https://headscale:8443
- tests/config/test-cert.pem + test-key.pem: 365-day self-signed RSA
  cert with SAN DNS:localhost, DNS:headscale, IP:127.0.0.1
- tests/docker-compose.yml: mount certs into headscale + both peers,
  set SSL_CERT_FILE on the peers, expose 8443 instead of 8080
- tests/run.sh: switch to https://localhost:8443, set
  SUNBEAM_NET_TEST_DERP_INSECURE=1
- tests/integration.rs: drop the #[ignore] on test_e2e_tcp_through_tunnel,
  read derp_tls_insecure from env in all four test configs
This commit is contained in:
2026-04-07 15:29:03 +01:00
parent 2624a13952
commit 94fb6155f7
6 changed files with 90 additions and 20 deletions

View File

@@ -18,11 +18,13 @@ services:
image: headscale/headscale:0.23
command: serve
ports:
- "8080:8080" # control plane (TS2021 Noise + HTTP API)
- "8443:8443" # control plane + embedded DERP, both over TLS
- "3478:3478/udp" # STUN
- "9090:9090" # metrics
volumes:
- ./config/headscale.yaml:/etc/headscale/config.yaml:ro
- ./config/test-cert.pem:/etc/headscale/test-cert.pem:ro
- ./config/test-key.pem:/etc/headscale/test-key.pem:ro
- headscale-data:/var/lib/headscale
healthcheck:
test: ["CMD", "headscale", "nodes", "list"]
@@ -46,11 +48,15 @@ services:
TS_AUTHKEY: "${PEER_A_AUTH_KEY}"
TS_STATE_DIR: /var/lib/tailscale
TS_USERSPACE: "false"
TS_EXTRA_ARGS: --login-server=http://headscale:8080
TS_EXTRA_ARGS: --login-server=https://headscale:8443
# Pin the WireGuard listen port (passed to tailscaled itself) so we
# can publish it to the host — without this our test daemon (running
# outside docker) can't reach peer-a's UDP endpoint.
TS_TAILSCALED_EXTRA_ARGS: --port=41641
# Trust the self-signed test cert so the tailscale Go client can
# verify HTTPS connections to headscale + the embedded DERP. Go
# honors SSL_CERT_FILE for net/http TLS verification.
SSL_CERT_FILE: /etc/headscale/test-cert.pem
cap_add:
- NET_ADMIN
- NET_RAW
@@ -60,6 +66,7 @@ services:
- "41641:41641/udp"
volumes:
- peer-a-state:/var/lib/tailscale
- ./config/test-cert.pem:/etc/headscale/test-cert.pem:ro
# Tailscale doesn't have a great healthcheck, but it registers fast
healthcheck:
test: ["CMD", "tailscale", "status", "--json"]
@@ -78,7 +85,8 @@ services:
TS_AUTHKEY: "${PEER_B_AUTH_KEY}"
TS_STATE_DIR: /var/lib/tailscale
TS_USERSPACE: "false"
TS_EXTRA_ARGS: --login-server=http://headscale:8080
TS_EXTRA_ARGS: --login-server=https://headscale:8443
SSL_CERT_FILE: /etc/headscale/test-cert.pem
cap_add:
- NET_ADMIN
- NET_RAW
@@ -86,6 +94,7 @@ services:
- /dev/net/tun:/dev/net/tun
volumes:
- peer-b-state:/var/lib/tailscale
- ./config/test-cert.pem:/etc/headscale/test-cert.pem:ro
healthcheck:
test: ["CMD", "tailscale", "status", "--json"]
interval: 5s