中文 (中国)
Headplane 主机
Headplane 是一个浏览器管理控制台，用于现有的 Headscale 服务器，用于管理用户、节点和额外的 DNS 记录。
- 一键 部署
- 15 GB 所需磁盘空间
- 1 GB 内存 所需内存
- 来自 2 € 价格
无设置费
您在 AvaHost 上获得的服务
一键部署、自定义域名、免费HTTPS、自动应用更新和定期备份是每个云应用的标准配置。您可以在一台服务器上运行多个应用，并且包括终端访问。
此模板不包含数据库容器。
技术
- Docker 镜像
- ghcr.io/tale/headplane:latest
- 默认端口
- 0
Headplane 的工作原理
Headplane 是 Headscale 的网页管理界面，来自 tale 项目。Docker 指南说明需要与 Headscale 一起在 Docker 中运行，镜像为 ghcr.io/tale/headplane。你需要挂载 Headplane 配置、数据目录和 Headscale 配置文件（UI 被允许读取）。某些功能（包括网络管理）需要共享 Headscale 配置路径，在文档示例中，还需要对同一机器上的 Docker socket 进行只读访问。UI 在 /admin 路径下提供服务，通常与 Headscale 在同一主机名上，反向代理将该路径发送到 Headplane 的 3000 端口，其他所有流量发送到 Headscale。
需要 Headscale 0.26.0 或更高版本。如果该服务器缺失，Headplane 将无法管理任何内容。它不会注册 Tailscale 客户端，也不会替换这些客户端使用的协调 URL。tailnet 的 SQLite 或 PostgreSQL 数据库保留在 Headscale 内部。Headplane 保持自己的小型数据，包括从你设置的 cookie 密钥派生的会话材料。
Headplane 的主要功能
从浏览器中，当这些文件挂载在配置指定的位置时，你可以管理用户、节点和 DNS 额外记录。cookie 密钥必须是随机的且已存储，因为它会锁定会话。项目附带一个示例配置。有趣的字段是 headscale.url、cookie 密钥和 Headscale 文件的路径。当两个容器共享一个网络时，将 headscale.url 指向 Docker 内部地址，而不是浏览器使用的 URL。
AvaHost 自动更新 Headplane 并按计划备份其数据目录。该备份不是 Headscale 的备份。Headplane 本身不需要专用公网 IP。将公网地址放在 Headscale 应用上。Headplane 不包含应用邮件功能。Docker socket 访问权限很强大。仅启用上游指南描述的集成，并将该 socket 视为对主机容器的管理访问权限。
自托管 Headplane：需求和成本
基线配置为 512 MB RAM 和半个 CPU 核心，镜像为 ghcr.io/tale/headplane，无需自己的数据库。在 AvaHost 上，Headplane 的推荐最低配置为 Plan 1，价格为 €2。该软件包包括一键部署、Headscale 主机名上的主机名或路径、自动 HTTPS、自动更新和 Headplane 数据的定期备份。你必须已经拥有 Headscale 0.26 或更高版本。此应用不包括该服务器，也不包括专用公网 IP。
谁使用 Headplane
已经决定使用 Headscale 并想要一个类似 Tailscale 提供的控制台（在 /admin 下）的人会使用 Headplane。如果 Headscale 未运行，这是错误的首次购买。如果你对 Headscale CLI 感到满意且不想在同一配置文件上挂载另一个服务，这也是错误的软件包。
F.A.Q
Headplane 在计划 1 上起价 €2。该价格是针对管理 UI，不包括 Headscale，也不包括为客户端提供的专用地址。如果 Headscale 也在此处托管，它是一个独立的应用程序，具有自己的计划。该 UI 很轻量级。大部分容量讨论属于协调服务器和 DERP，而不是此容器。
是的。通常的配置是一个主机名：Headscale 在根目录，Headplane 在 /admin 下，该主机名上自动启用 HTTPS。代理必须将 /admin 转发到此应用，其他路径转发到 Headscale。您也可以使用单独的主机名。DNS 仍由您管理。客户端应该仍然配置 Headscale URL，而不是 /admin 路径。
AvaHost 自动更新 Headplane 并按计划备份其自身数据。Headscale 的数据库不包含在该备份中。更新后，登录 /admin 并确认节点列表仍能正常加载。妥善保管 cookie 密钥和已挂载的配置路径记录，因为挂载错误会导致服务器显示为空。
不行。上游要求 Headscale 0.26 或更新版本，UI 仅编辑该服务器。单独订购 Headplane 不会创建 tailnet。请先部署 Headscale，或同时部署两者并将 Headplane 指向它。Tailscale 客户端忽略 Headplane。它们与 Headscale 通信。