什么是 Headscale?
Headscale 是一款开源、自托管的 Tailscale 控制服务器实现。它让你可以运行自己的协调服务器,构建基于 WireGuard 的私有 mesh 网络,使你的设备之间可以安全地互联,而无需依赖 Tailscale 托管的控制平面——同时仍然使用标准的 Tailscale 客户端。
⚡ Headscale 的核心功能
🔐 自托管控制平面
运行你自己的协调服务器——无需依赖第三方托管服务。
🌐 WireGuard Mesh 网络
在你所有设备之间提供快速、加密的点对点连接。
📱 标准客户端
兼容桌面、移动设备和服务器上的官方 Tailscale 客户端。
📜 ACL 策略
细粒度的访问控制规则,用于划分和保护你的网络。
🎯 为什么选择 Headscale?
- 完全掌控:拥有协调服务器和你的网络数据
- 无厂商锁定:托管控制平面的开源替代方案
- 使用官方客户端:保留精致的 Tailscale 应用体验
- 轻量级:单个易于部署的 Go 二进制文件
🆕 亮点
- 协调服务器:自托管的 Tailscale 控制平面
- WireGuard:现代化的加密 mesh 网络
- ACL:基于策略的访问控制
- 多用户:使用命名空间分隔设备和用户
📦 从 deb.griffo.io 安装
步骤 1:添加仓库
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt updatesudo apt install extrepo
sudo extrepo enable griffo
sudo apt update🆓 有一个永久免费的镜像。 deb-free.griffo.io 永久免费提供软件包 — 无需账号、无需订阅,最多落后上游 2 个月,安全修复立即发布。目前收录 cliamp、Ghostty、lazydocker、Oh My Posh 和 Zed;Headscale 不在其中,因此今天只能通过上面的仓库安装 — 提出请求即可将其加入。
🧩 关于 extrepo 选项。 extrepo 是 Debian 官方用于管理第三方仓库的工具:它会替你写好 sources 文件并安装签名密钥,并在使用前先对照签名元数据校验该密钥。本仓库以 griffo 之名登记其中,永久免费镜像则为 griffo-free,因此在 Debian(bookworm、trixie、forky、sid)上,上面的命令就是全部配置。
extrepo 只负责 sources 文件和密钥,订阅凭据仍然要写入 /etc/apt/auth.conf.d/deb.griffo.io.conf。Ubuntu 不在覆盖范围内,因为 extrepo 只发布 Debian 各套件的元数据:在 Ubuntu 上请使用 sudo 或 root 的命令。
步骤 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🚀 为什么选择 deb.griffo.io?
- 官方 Debian:通常落后数月,缺少最新功能
- deb.griffo.io:发布后数小时内即可获取最新版本
- 手动安装:需要手动下载并配置 PATH
- 我们的仓库:预构建、开箱即用的软件包
- ✅ 最新功能:立即获取最新的 Headscale 功能和改进
- ✅ 无需手动配置:预构建的二进制文件,通过 apt 安装和更新
- ✅ 自动更新:软件包在上游发布后数小时内完成更新
- ✅ 正确的依赖管理:正确打包所有所需的库
- ✅ 多发行版支持:支持 Bookworm、Trixie 和 Sid
- ✅ 易于维护:使用简单的 apt 命令即可完成更新
📦 软件包构建仓库
Debian 软件包在此 GitHub 仓库中自动构建和维护:
- 📁 headscale-debian - Latest release builds
🔗 相关软件包
也可从 deb.griffo.io 获取:
💝 支持此项目
如果这个仓库为你节省了时间和精力,请考虑支持它!