Repolode
juanfont

juanfont/headscale

开源、可自托管的 Tailscale 控制服务器实现,用于搭建自己的 WireGuard 组网。

可替代:Tailscale

Star
44,970
Fork
2,614
未关闭 Issue
135
最近提交
16小时前

这是什么?

Tailscale 是基于 WireGuard 构建的 VPN,通过 NAT 穿透把各设备连成覆盖网络。其控制服务器负责在节点之间交换 WireGuard 公钥、分配客户端 IP、划分用户边界、支持机器共享,并下发节点通告的路由。Headscale 是这一控制服务器的开源自托管实现,让你可以自己运行协调层,而不依赖 Tailscale 的托管服务。

Headscale 的范围较窄,面向个人或小型组织使用的单个 tailnet,并不覆盖商业服务的全部功能。官方 Tailscale 客户端可以指向 headscale 实例使用。项目使用 Go 编写,仓库提供 NixOS 模块以及 main 分支的开发构建。

该项目与 Tailscale Inc. 没有关联。项目方向由维护者共同决定,主要服务于自托管爱好者和个人用户。

核心功能

  • 01实现 Tailscale 控制服务器,协调 WireGuard 节点
  • 02分配 IP 地址并管理用户之间的访问边界
  • 03支持机器共享和节点间路由通告
  • 04提供 NixOS 模块以及容器和二进制构建

适用场景

  • 为家庭实验室或个人设备搭建私有组网
  • 为小型开源团队提供自托管的 tailnet
  • 将协调服务器掌握在自己手中,而非依赖托管服务

快速上手

  1. 1

    克隆仓库

  2. 2

    进入 Nix 开发环境(推荐)

    nix develop
  3. 3

    运行测试套件

    make test
  4. 4

    构建程序

    make build

使用前须知

  • README 明确不支持也不鼓励在反向代理或容器中运行 Headscale。
  • 需要自行托管控制服务器,并投入一定的部署与运维工作。

收录于专题

标签

常见问题

headscale 是什么?
开源、可自托管的 Tailscale 控制服务器实现,用于搭建自己的 WireGuard 组网。 Tailscale 是基于 WireGuard 构建的 VPN,通过 NAT 穿透把各设备连成覆盖网络。其控制服务器负责在节点之间交换 WireGuard 公钥、分配客户端 IP、划分用户边界、支持机器共享,并下发节点通告的路由。Headscale 是这一控制服务器的开源自托管实现,让你可以自己运行协调层,而不依赖 Tailscale 的托管服务。
headscale 可以免费使用吗?用的什么许可证?
headscale 以 BSD-3-Clause 许可证开源。用于商业产品前,请先确认许可证条款。
headscale 还在维护吗?
活跃维护中。headscale 最近一次提交是在 2026年10月24日。
headscale 适合用来做什么?
为家庭实验室或个人设备搭建私有组网 为小型开源团队提供自托管的 tailnet 将协调服务器掌握在自己手中,而非依赖托管服务
headscale 怎么安装和运行?
克隆仓库 进入 Nix 开发环境(推荐): nix develop 运行测试套件: make test 构建程序: make build
在哪里获取 headscale?
源代码和安装说明在 GitHub 上:https://github.com/juanfont/headscale

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目