appstore/apps/headscale

Headscale

应用简介

Tailscale 控制服务器的开源自托管实现。

英文说明：An open source, self-hosted implementation of the Tailscale control server.

部署说明

• 本应用使用 Docker Compose 在 1Panel 中部署。
• 应用分类：工具。
• 支持架构：amd64。
• 可选版本：0.23.0-alpha3、0.26.1。
• 安装后按应用表单中的端口访问 Web UI、SSH 或对应服务。

端口

变量	说明	默认值	必填
PANEL_APP_PORT_HTTP	端口 (对应内部 8080)	40183	是

数据持久化

• "./data/config:/etc/headscale
• "./data/data:/var/lib/headscale

升级或迁移前，请在 1Panel 中备份上述数据目录。

配置项

变量	说明	默认值	必填
SUBNET	1panel-network 子网 IP (查看docker网络获取网段)	172.18.0.241	是

使用说明

宿主机可通过以下命令创建、获取所需

• 容器名按需修改

# 创建名为 "username" 的用户
docker exec -it headscale headscale users create username

# 创建一个有效期为 10000 天的 API 密钥
docker exec -it headscale headscale apikeys create -e 10000d

# 创建一个有效期为 10000 天、可重复使用的预授权密钥，并关联到特定的用户名 "username"
docker exec -it headscale headscale preauthkeys create -e 10000d --reusable -u username

1Panel 容器管理页面连接容器终端

# 创建名为 "username" 的用户
headscale users create username

# 创建一个有效期为 10000 天的 API 密钥
headscale apikeys create -e 10000d

# 创建一个有效期为 10000 天、可重复使用的预授权密钥，并关联到特定的用户名 "username"
headscale preauthkeys create -e 10000d --reusable -u username

参考资料

• 官网: https://headscale.net
• 源码: https://github.com/juanfont/headscale