## 前言
Tailscale好用但数据在别人服务器上？Headscale是Tailscale的开源自建替代方案，所有数据都在你自己的服务器上！本教程零基础手把手教你部署。
## 一、Headscale是什么？
Headscale是Tailscale控制服务器的开源实现：
– 自建服务器，数据完全自控
– 兼容Tailscale客户端
– 轻量，1C1G即可运行
– 完全免费开源
## 二、服务器准备
| 项目 | 要求 |
|——|——|
| 系统 | Ubuntu 22.04/Debian 12 |
| CPU | 1核 |
| 内存 | 1GB |
| 带宽 | 有公网IP |
开放端口：443（HTTPS）、8080（HTTP）、3478（UDP）
## 三、Docker部署Headscale
创建docker-compose.yml并配置目录后启动：
docker compose up -d
下载配置模板并修改server_url为你的域名或IP。
## 四、创建用户和API Key
docker exec headscale headscale users create myuser
docker exec headscale headscale apikeys create
## 五、客户端连接
Linux：tailscale up –login-server http://你的IP:8080
Windows/Mac：安装Tailscale客户端后指向自建服务器
## 六、常见报错解决
| 报错 | 解决方案 |
|——|———|
| 连接超时 | 开放8080和443端口 |
| API Key无效 | 重新生成Key |
| MagicDNS不工作 | 检查配置 |
| 无法打洞 | 自建DERP中继 |
## 七、避坑总结
1. 开放8080和443端口
2. server_url要填对
3. 设备连接后需服务端批准
4. NAT穿透不理想可自建DERP
本教程由技术保姆网原创，转载请注明出处。