什么是 Headscale？
Headscale 是一款开源、自托管的 Tailscale 控制服务器实现。它让您可以运行自己的协调服务器，构建基于 WireGuard 的私有 mesh 网络，使您的设备之间可以安全地互联，而无需依赖 Tailscale 托管的控制平面——同时仍然使用标准的 Tailscale 客户端。
🚀 为什么最新版本很重要：Headscale 与 Tailscale 协议同步演进，不断加入对新客户端功能的支持、ACL 改进和稳定性修复。运行最新版本可以确保您与当前的 Tailscale 客户端保持兼容。
⚡ Headscale 的核心功能
🔐 自托管控制平面
运行您自己的协调服务器——无需依赖第三方托管服务。
🌐 WireGuard Mesh 网络
在您所有设备之间提供快速、加密的点对点连接。
📱 标准客户端
兼容桌面、移动设备和服务器上的官方 Tailscale 客户端。
📜 ACL 策略
细粒度的访问控制规则，用于划分和保护您的网络。
🎯 为什么选择 Headscale？
- 完全掌控：拥有协调服务器和您的网络数据
- 无厂商锁定：托管控制平面的开源替代方案
- 使用官方客户端：保留精致的 Tailscale 应用体验
- 轻量级：单个易于部署的 Go 二进制文件
🆕 亮点
- 协调服务器：自托管的 Tailscale 控制平面
- WireGuard：现代化的加密 mesh 网络
- ACL：基于策略的访问控制
- 多用户：使用命名空间分隔设备和用户
📦 从 debian.griffo.io 安装
步骤 1：添加仓库
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://debian.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/debian.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/debian.griffo.io.gpg] https://debian.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/debian.griffo.io.list > /dev/null
sudo apt update
install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://debian.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/debian.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/debian.griffo.io.gpg] https://debian.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/debian.griffo.io.list > /dev/null
apt update
步骤 2：安装 headscale
# Install latest headscale
sudo apt install headscale
# Verify installation
headscale version
# Install latest headscale
apt install headscale
# Verify installation
headscale version
🎯 基本使用示例
# Show version
headscale version
# Create a user
headscale users create alice
# Generate a pre-auth key for a user
headscale preauthkeys create --user alice --reusable
# List connected nodes
headscale nodes list
# Serve the control server
headscale serve
🚀 为什么选择 debian.griffo.io？
📊 仓库对比：
- 官方 Debian：通常落后数月，缺少最新功能
- debian.griffo.io：发布后数小时内即可获取最新版本
- 手动安装：需要手动下载并配置 PATH
- 我们的仓库：预构建、开箱即用的软件包
- ✅ 最新功能：立即获取最新的 Headscale 功能和改进
- ✅ 无需手动配置：预构建的二进制文件，通过 apt 安装和更新
- ✅ 自动更新：软件包在上游发布后数小时内完成更新
- ✅ 正确的依赖管理：正确打包所有所需的库
- ✅ 多发行版支持：支持 Bookworm、Trixie 和 Sid
- ✅ 易于维护：使用简单的 apt 命令即可完成更新
📦 软件包构建仓库
Debian 软件包在此 GitHub 仓库中自动构建和维护：
- 📁 headscale-debian - Latest release builds
🔗 相关软件包
也可从 debian.griffo.io 获取：
🎯 适用人群：希望使用 Tailscale 客户端搭建私有、安全的 mesh VPN，同时完全掌控协调服务器和自身数据的自托管用户和组织。
💝 支持此项目
如果这个仓库为您节省了时间和精力，请考虑支持它！