Files
appstore/apps/headscale
okxlin 9a5682d88b Update headscale and immich local apps
Add Headscale 0.27.1 as a sequential upgrade target from 0.26.1, fix the 0.26.1 command/config defaults, and migrate legacy Headscale config keys during upgrade while preserving unrelated custom sections.

Add Immich 1.132.3 as the safe intermediate upgrade required before newer Immich releases. Leave Tailscale unchanged because the newer patch/minor Docker tags are not available.
2026-06-26 22:48:37 +08:00
..
2023-12-13 23:05:14 +08:00
2026-06-25 01:44:50 +08:00

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

参考资料