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 中继
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
参考文档
如果你觉得这篇文章对你有所帮助,欢迎赞赏~
赞赏