Headscale Docs doc.tailscale.20140412.xyz
CONTROL PLANE · 自建 Headscale

组一张属于你自己的
安全 overlay 网络

这里托管着 tailscale.20140412.xyz 控制平面与节点文档。 基于 Headscale 自建，WireGuard 加密，DNS-01 自动签发证书，全程容器化部署。

快速接入节点 查看 API
控制平面
● 在线
域名
tailscale.20140412.xyz
DERP / STUN
:3478/udp
证书签发
Let's Encrypt

快速开始

三步把一台机器接入网络
# 1. 安装 tailscale 客户端并指向自建控制平面
tailscale up --login-server https://tailscale.20140412.xyz

# 2. 浏览器打开下面的链接完成授权（会跳到 Headscale）
#    复制返回的 node key，到服务器执行注册
headscale nodes register --user default --key <nodekey>

# 3. 验证连通
tailscale status
tailscale ping <对端节点名>

常用文档

点击卡片直达

节点接入

Linux / macOS / Windows 客户端注册到自建控制平面的完整流程。

API 与密钥

生成 PreAuth key、调用 Headscale API 管理用户与节点。

DERP 中继

NAT 穿透失败时走自建 DERP 中继，配置与调试方法。

ACL 策略

编写 policy.json，精细控制节点之间的访问权限。

API 示例

Headscale gRPC / REST
# 列出所有节点
curl -H "Authorization: Bearer $API_KEY" \
  https://tailscale.20140412.xyz/api/v1/node

# 创建一次性 PreAuth key
headscale preauthkeys create --user default --reusable=false --ephemeral=false