Headscale 主机
Headscale 是一个开源协调服务器,用于 Tailscale 客户端,因此控制平面保持在您管理的基础设施上。
- 一键 部署
- 15 GB 所需磁盘空间
- 1 GB 内存 所需内存
- 来自 2 € 价格
您在 AvaHost 上获得的服务
一键部署、自定义域名、免费HTTPS、自动应用更新和定期备份是每个云应用的标准配置。您可以在一台服务器上运行多个应用,并且包括终端访问。
此模板不包含数据库容器。

技术
- Docker 镜像
- headscale/headscale:latest
- 默认端口
- 0

Headscale 的工作原理
Headscale 是开源协调服务器,Tailscale 客户端可以使用它来替代 Tailscale 的托管控制平面。设备仍然运行 Tailscale 客户端。它们指向您的 Headscale URL。服务器存储节点、用户和预授权密钥。容器镜像是 headscale/headscale。上游的需求页面要求公网 IP,并强烈建议在 443 端口上使用 HTTPS,因为客户端在某些情况下会假设这一点。SQLite 是默认数据库,PostgreSQL 是可选项。此基础配置保留 SQLite,不添加单独的数据库容器。
如果启用了嵌入式 DERP 中继,该页面说明 UDP 3478 必须可访问,同时还需要 TCP 443。9090 上的指标应保持私有。项目建议使用双栈公网地址,这不是此计划在 IPv4 专用地址之外能保证的内容。
Headscale 的主要功能
您创建用户和预授权密钥,并决定哪些设备可以加入。ACL 策略是您维护的文件。MagicDNS 和额外记录在 YAML 中配置,如果您稍后添加该 UI,Headplane 可以编辑。Docker 指南挂载一个配置目录和一个数据目录用于 SQLite 文件。只读根文件系统是上游示例的一部分。它们与 /var/lib/headscale 的卷兼容。
AvaHost 自动更新 Headscale 并按计划备份该数据目录。糟糕的升级可能会使客户端无法工作,直到 URL 再次响应,因此请在更改后通过打开健康检查 URL 来检查 headscale 的健康行为。需要专用公网 IP。Headscale 不包括应用程序邮件。Headplane 是单独的应用程序,此软件包不安装它。
Headscale 与 Tailscale 的对比
Headscale
Headscale 让您运营协调服务器。Tailscale 让该公司运营它,提供他们的管理控制台和定价。通常设置中笔记本电脑和手机上的客户端仍然是 Tailscale 的客户端。当您想要托管控制平面时,选择 Tailscale。当需要将该数据库保留在您的 VPS 上时,选择 Headscale。
Tailscale
DERP 中继是微妙的部分。嵌入式 DERP 需要 UDP 端口。使用 Tailscale 的公共 DERP 是上游的一个选项,具有不同的信任权衡。此页面不声称它们是相同的。
谁使用 Headscale
家庭实验室和喜欢 Tailscale 客户端但不会使用托管协调服务器的公司使用 Headscale。如果您从第一天就想要浏览器 UI 但还没有计划 Headplane,或者您无法发布 443 和嵌入式 DERP 的 UDP 3478,这不是一个好的选择。

自托管 Headscale:需求和成本
基础配置是 512 MB RAM 和 1 个 CPU 核心,镜像 headscale/headscale,SQLite 在磁盘上。在 AvaHost 上,Headscale 的推荐最低配置是 Plan 1,价格为 €2。该软件包包括一键部署、主机名、协调 URL 上的自动 HTTPS、自动更新和定期备份。此部署需要专用公网 IP,因为上游需要公网地址,并且对于嵌入式 DERP,需要公网 UDP 3478。客户端必须被告知您的服务器 URL。
F.A.Q
Headscale 在计划 1 上起价 €2。价格涵盖协调服务器及其 SQLite 文件,不包括 Headplane UI 和每台设备上的 Tailscale 客户端。PostgreSQL 是可选的上游组件,不在此最低配置中。大型 tailnet 可能需要超过 512 MB 的内存。DERP 流量体积是另一个需要监控的因素。
是的。向客户端提供您主机名上的 HTTPS URL。上游服务器倾向于在端口 443 上使用该 URL。一旦 DNS 指向专用地址,自动 HTTPS 会覆盖协调端点。您仍需使用密钥或身份验证流程注册每个设备。主机名必须与您在服务器配置中设置的内容相匹配。
AvaHost 自动更新 Headscale 并按计划备份数据目录。请阅读版本升级说明,因为当架构或 URL 破损时,协调服务器会导致客户端断连。更新后,确认健康检查端点以及现有节点仍能 ping 通。如果在数据卷外编辑 ACL 文件,请保存一份副本。
是的。Headscale 的要求是需要一个公网 IP、443 端口的 HTTPS 以及启用嵌入式 DERP 服务器时的 UDP 3478。AvaHost 为此套餐要求一个专用公网 IP,以确保端点保持稳定。该地址不会写入您的 ACL 策略。如果您需要浏览器界面,Headplane 是一个单独的部署。

