目录

Headscale 部署:自建 Tailscale 控制面

这篇记录在 Gentoo Linux 上配置 Headscale,把 Tailscale 的控制面换到自己手里。

Gentoo 仓库里已经有 Headscale,直接装:

emerge -av headscale

编辑 /etc/headscale/config.yaml,至少把监听地址、server_url 和地址池改掉:

unix_socket: /run/headscale/headscale.sock
server_url: http://<your-ip>:8080
listen_addr: 0.0.0.0:8080
prefixes:
  v4: 100.64.0.0/10
  v6: fd7a:115c:a1e0::/48

Headscale 0.23 之后把 ip_prefixes 改成了 prefixes,命令里的 node/user 也改成了复数。下面的写法对应 0.23 及以上,老版本要按旧语法改。

启动并设置开机自启:

systemctl start headscale
systemctl status headscale
systemctl enable headscale

创建用户:

headscale users create homelab

Linux 客户端:

tailscale up --login-server=http://<your-ip>:8080 --accept-routes=true --accept-dns=false

打开输出的登录链接,页面上会给出注册命令,类似:

headscale nodes register --user homelab --key nodekey:df596243a3e117f45dbdcc7bba8741297e68efd731798c252b65586cacddf756

查看节点:

headscale nodes list

DERP 可以独立于 Headscale 部署,也可以部署多个。我用的是自己打包的镜像,源码在 slchris/derp-server。

部署 DERP 需要:

  • 一台有公网 IP 的 VPS;NAT 机器要做端口映射
  • 一个域名,A/AAAA/CNAME 解析到这台机器
  • 证书

先用 certbot 申请证书:

docker run -it --rm --name certbot \
  -p 80:80 \
  -v "/etc/letsencrypt:/etc/letsencrypt" \
  -v "/var/lib/letsencrypt:/var/lib/letsencrypt" \
  certbot/certbot certonly --standalone --agree-tos -m [email protected] -d example.com

启动 derper:

docker run --restart always \
  --name derper -p 12345:443 -p 3478:3478/udp \
  -v /etc/letsencrypt/live/example.com/fullchain.pem:/app/certs/example.com.crt \
  -v /etc/letsencrypt/live/example.com/privkey.pem:/app/certs/example.com.key \
  -e DERP_CERT_MODE=manual \
  -e DERP_DOMAIN=example.com \
  -d ghcr.io/slchris/derp-server:v1

example.com 换成你的域名,后面 Headscale 的 DERP 配置也要跟着改。

在 Headscale 服务端写 DERP 配置 /etc/headscale/derp.yaml:

regions:
  800:
    regionid: 800
    regioncode: hangzhou
    regionname: Hangzhou, China
    nodes:
      - name: hz
        regionid: 800
        hostname: hz.plz.ac
        stunport: 3478
        derpport: 12345

在主配置 /etc/headscale/config.yaml 里引用它:

derp:
  paths:
    - /etc/headscale/derp.yaml
  auto_update_enabled: true
  update_frequency: 24h

重启 Headscale:

systemctl restart headscale

客户端也重启一下,然后看连接情况:

systemctl restart tailscaled
tailscale netcheck