如何在Docker中快速部署HeadplaneHeadscale的终极Web管理界面指南【免费下载链接】headplaneA feature-complete Web UI for Headscale项目地址: https://gitcode.com/gh_mirrors/he/headplaneHeadplane是Headscale的完整功能Web管理界面让您能够轻松管理Tailscale节点、网络配置和用户访问。作为Headscale的终极Web UI解决方案它提供了与官方Tailscale产品相媲美的管理体验。本文将为您提供简单快速的Docker部署教程即使是新手也能在10分钟内搭建起功能强大的Headscale管理平台。 为什么选择HeadplaneHeadscale是目前最流行的自托管Tailscale解决方案但默认情况下缺少Web管理界面。Headplane填补了这一空白提供了完整的Web UI功能包括设备管理查看、重命名、移动和过期设备网络配置管理DNS服务器、MagicDNS和子网路由访问控制配置ACL规则和标签策略用户管理支持OpenID Connect单点登录远程SSH通过Web界面直接访问Tailscale节点Headplane设备管理界面 - 显示所有连接的Tailscale设备状态 环境准备在开始部署之前请确保您的系统满足以下要求Docker和Docker Compose已安装Headscale 0.26.0或更高版本已部署并运行基本的Linux命令行操作知识如果您还没有安装Docker可以通过以下命令快速安装# Ubuntu/Debian系统 curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh sudo usermod -aG docker $USER # 安装Docker Compose sudo apt-get install docker-compose-plugin⚡ 快速开始基础部署步骤1准备配置文件首先从项目仓库下载配置文件示例wget https://gitcode.com/gh_mirrors/he/headplane/raw/main/config.example.yaml -O config.yaml编辑配置文件设置关键的Headscale连接信息server: host: 0.0.0.0 port: 3000 base_url: http://localhost:3000 cookie_secret: 生成一个安全的32字符密钥 data_path: /var/lib/headplane headscale: url: http://your-headscale-server:8080 api_key: 您的Headscale API密钥步骤2创建Docker Compose文件创建一个简单的docker-compose.yml文件version: 3.8 services: headplane: image: ghcr.io/tale/headplane:latest container_name: headplane restart: unless-stopped ports: - 3000:3000 volumes: - ./config.yaml:/etc/headplane/config.yaml - ./data:/var/lib/headplane environment: - TZAsia/Shanghai步骤3启动服务运行以下命令启动Headplanedocker-compose up -d等待几秒钟后访问http://localhost:3000/admin即可看到登录界面。 获取Headscale API密钥要登录Headplane您需要Headscale API密钥。在Headscale环境中执行# 创建90天有效期的API密钥 headscale apikeys create --expiration 90d # 或者创建永不过期的密钥不推荐用于生产 headscale apikeys create --expiration 0将生成的API密钥复制到Headplane配置文件的headscale.api_key字段中。 核心功能介绍设备管理Headplane的设备管理界面让您能够轻松管理所有连接的Tailscale设备。您可以查看设备在线状态和详细信息重命名设备以便识别设置设备过期时间管理设备标签和路由设备详情页面 - 显示设备详细信息、路由设置和SSH访问选项DNS配置管理通过Headplane的DNS管理界面您可以配置Tailnet域名添加和管理DNS服务器设置自定义DNS记录启用/禁用MagicDNSDNS配置界面 - 管理Tailnet域名和全局DNS服务器访问控制列表ACLHeadplane提供了直观的ACL配置界面支持基于JSON的ACL规则编辑用户组和标签管理实时ACL验证和测试导入/导出ACL配置ACL配置界面 - 编辑JSON格式的访问控制规则⚙️ 高级功能配置启用网络管理功能要启用完整的网络管理功能包括DNS配置和网络设置您需要将Headplane和Headscale部署在同一个Docker环境中version: 3.8 services: headplane: image: ghcr.io/tale/headplane:latest container_name: headplane restart: unless-stopped ports: - 3000:3000 volumes: - ./config.yaml:/etc/headplane/config.yaml - ./data:/var/lib/headplane - ./headscale/config.yaml:/etc/headscale/config.yaml - ./headscale/dns_records.json:/etc/headscale/dns_records.json - /var/run/docker.sock:/var/run/docker.sock:ro labels: - me.tale.headplane.targetheadscale headscale: image: headscale/headscale:0.26.0 container_name: headscale restart: unless-stopped command: serve ports: - 8080:8080 volumes: - ./headscale/config.yaml:/etc/headscale/config.yaml - ./headscale/dns_records.json:/etc/headscale/dns_records.json - ./headscale/data:/var/lib/headscale在Headplane配置中启用Docker集成integration: docker: enabled: true headscale: config_path: /etc/headscale/config.yaml dns_records_path: /etc/headscale/dns_records.json启用远程Web SSHHeadplane支持通过Web界面直接SSH到Tailscale节点在Tailscale节点上启用SSHtailscale up --ssh参考官方文档docs/features/agent.md 配置Headplane Agent配置单点登录SSOHeadplane支持通过OpenID Connect提供商进行单点登录参考官方文档docs/features/sso.md 获取详细配置指南配置您的身份提供商如Google、GitHub等在Headplane中启用OIDC认证SSO用户管理界面 - 支持OpenID Connect身份提供商集成 生产环境部署建议使用反向代理在生产环境中建议使用反向代理如Nginx、Caddy或Traefik# Nginx配置示例 server { listen 80; server_name headscale.example.com; location /admin { proxy_pass http://localhost:3000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } location / { proxy_pass http://localhost:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }启用TLS加密为您的域名配置SSL证书可以使用Lets Encrypt免费证书# 使用certbot获取证书 sudo apt-get install certbot python3-certbot-nginx sudo certbot --nginx -d headscale.example.com 常见问题解答Q1: Headplane无法连接到Headscale解决方案检查Headscale服务是否正在运行docker ps | grep headscale验证API密钥是否正确确认网络连接和防火墙设置Q2: 页面显示Internal Server Error解决方案检查Docker容器日志docker logs headplane验证配置文件格式是否正确确保数据目录有正确的权限Q3: 无法保存DNS配置解决方案确认Headplane和Headscale共享了配置文件卷检查文件权限ls -la /etc/headscale/验证Docker集成已启用Q4: SSO登录失败解决方案检查OIDC提供商配置验证回调URL设置查看浏览器控制台错误信息 性能优化建议资源分配为Headplane容器分配足够的CPU和内存资源数据库优化定期清理旧数据保持数据库性能缓存策略配置适当的缓存策略减少API调用监控告警设置监控系统跟踪服务状态 总结与下一步通过本文的指南您已经成功部署了Headplane - Headscale的完整功能Web管理界面。Headplane不仅提供了直观的设备管理体验还支持高级功能如网络配置、ACL管理和远程SSH。下一步建议探索更多功能尝试配置ACL规则和用户组集成监控将Headplane与Prometheus/Grafana集成自动化部署使用Ansible或Terraform自动化部署流程备份策略建立定期备份Headplane数据的策略Headplane的持续开发确保了与Headscale的紧密集成和功能更新。定期检查项目更新获取最新功能和安全性改进。SSH终端界面 - 通过Web界面直接访问Tailscale节点的终端开始使用Headplane享受更简单、更高效的Headscale管理体验吧【免费下载链接】headplaneA feature-complete Web UI for Headscale项目地址: https://gitcode.com/gh_mirrors/he/headplane创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何在Docker中快速部署Headplane：Headscale的终极Web管理界面指南
如何在Docker中快速部署HeadplaneHeadscale的终极Web管理界面指南【免费下载链接】headplaneA feature-complete Web UI for Headscale项目地址: https://gitcode.com/gh_mirrors/he/headplaneHeadplane是Headscale的完整功能Web管理界面让您能够轻松管理Tailscale节点、网络配置和用户访问。作为Headscale的终极Web UI解决方案它提供了与官方Tailscale产品相媲美的管理体验。本文将为您提供简单快速的Docker部署教程即使是新手也能在10分钟内搭建起功能强大的Headscale管理平台。 为什么选择HeadplaneHeadscale是目前最流行的自托管Tailscale解决方案但默认情况下缺少Web管理界面。Headplane填补了这一空白提供了完整的Web UI功能包括设备管理查看、重命名、移动和过期设备网络配置管理DNS服务器、MagicDNS和子网路由访问控制配置ACL规则和标签策略用户管理支持OpenID Connect单点登录远程SSH通过Web界面直接访问Tailscale节点Headplane设备管理界面 - 显示所有连接的Tailscale设备状态 环境准备在开始部署之前请确保您的系统满足以下要求Docker和Docker Compose已安装Headscale 0.26.0或更高版本已部署并运行基本的Linux命令行操作知识如果您还没有安装Docker可以通过以下命令快速安装# Ubuntu/Debian系统 curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh sudo usermod -aG docker $USER # 安装Docker Compose sudo apt-get install docker-compose-plugin⚡ 快速开始基础部署步骤1准备配置文件首先从项目仓库下载配置文件示例wget https://gitcode.com/gh_mirrors/he/headplane/raw/main/config.example.yaml -O config.yaml编辑配置文件设置关键的Headscale连接信息server: host: 0.0.0.0 port: 3000 base_url: http://localhost:3000 cookie_secret: 生成一个安全的32字符密钥 data_path: /var/lib/headplane headscale: url: http://your-headscale-server:8080 api_key: 您的Headscale API密钥步骤2创建Docker Compose文件创建一个简单的docker-compose.yml文件version: 3.8 services: headplane: image: ghcr.io/tale/headplane:latest container_name: headplane restart: unless-stopped ports: - 3000:3000 volumes: - ./config.yaml:/etc/headplane/config.yaml - ./data:/var/lib/headplane environment: - TZAsia/Shanghai步骤3启动服务运行以下命令启动Headplanedocker-compose up -d等待几秒钟后访问http://localhost:3000/admin即可看到登录界面。 获取Headscale API密钥要登录Headplane您需要Headscale API密钥。在Headscale环境中执行# 创建90天有效期的API密钥 headscale apikeys create --expiration 90d # 或者创建永不过期的密钥不推荐用于生产 headscale apikeys create --expiration 0将生成的API密钥复制到Headplane配置文件的headscale.api_key字段中。 核心功能介绍设备管理Headplane的设备管理界面让您能够轻松管理所有连接的Tailscale设备。您可以查看设备在线状态和详细信息重命名设备以便识别设置设备过期时间管理设备标签和路由设备详情页面 - 显示设备详细信息、路由设置和SSH访问选项DNS配置管理通过Headplane的DNS管理界面您可以配置Tailnet域名添加和管理DNS服务器设置自定义DNS记录启用/禁用MagicDNSDNS配置界面 - 管理Tailnet域名和全局DNS服务器访问控制列表ACLHeadplane提供了直观的ACL配置界面支持基于JSON的ACL规则编辑用户组和标签管理实时ACL验证和测试导入/导出ACL配置ACL配置界面 - 编辑JSON格式的访问控制规则⚙️ 高级功能配置启用网络管理功能要启用完整的网络管理功能包括DNS配置和网络设置您需要将Headplane和Headscale部署在同一个Docker环境中version: 3.8 services: headplane: image: ghcr.io/tale/headplane:latest container_name: headplane restart: unless-stopped ports: - 3000:3000 volumes: - ./config.yaml:/etc/headplane/config.yaml - ./data:/var/lib/headplane - ./headscale/config.yaml:/etc/headscale/config.yaml - ./headscale/dns_records.json:/etc/headscale/dns_records.json - /var/run/docker.sock:/var/run/docker.sock:ro labels: - me.tale.headplane.targetheadscale headscale: image: headscale/headscale:0.26.0 container_name: headscale restart: unless-stopped command: serve ports: - 8080:8080 volumes: - ./headscale/config.yaml:/etc/headscale/config.yaml - ./headscale/dns_records.json:/etc/headscale/dns_records.json - ./headscale/data:/var/lib/headscale在Headplane配置中启用Docker集成integration: docker: enabled: true headscale: config_path: /etc/headscale/config.yaml dns_records_path: /etc/headscale/dns_records.json启用远程Web SSHHeadplane支持通过Web界面直接SSH到Tailscale节点在Tailscale节点上启用SSHtailscale up --ssh参考官方文档docs/features/agent.md 配置Headplane Agent配置单点登录SSOHeadplane支持通过OpenID Connect提供商进行单点登录参考官方文档docs/features/sso.md 获取详细配置指南配置您的身份提供商如Google、GitHub等在Headplane中启用OIDC认证SSO用户管理界面 - 支持OpenID Connect身份提供商集成 生产环境部署建议使用反向代理在生产环境中建议使用反向代理如Nginx、Caddy或Traefik# Nginx配置示例 server { listen 80; server_name headscale.example.com; location /admin { proxy_pass http://localhost:3000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } location / { proxy_pass http://localhost:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }启用TLS加密为您的域名配置SSL证书可以使用Lets Encrypt免费证书# 使用certbot获取证书 sudo apt-get install certbot python3-certbot-nginx sudo certbot --nginx -d headscale.example.com 常见问题解答Q1: Headplane无法连接到Headscale解决方案检查Headscale服务是否正在运行docker ps | grep headscale验证API密钥是否正确确认网络连接和防火墙设置Q2: 页面显示Internal Server Error解决方案检查Docker容器日志docker logs headplane验证配置文件格式是否正确确保数据目录有正确的权限Q3: 无法保存DNS配置解决方案确认Headplane和Headscale共享了配置文件卷检查文件权限ls -la /etc/headscale/验证Docker集成已启用Q4: SSO登录失败解决方案检查OIDC提供商配置验证回调URL设置查看浏览器控制台错误信息 性能优化建议资源分配为Headplane容器分配足够的CPU和内存资源数据库优化定期清理旧数据保持数据库性能缓存策略配置适当的缓存策略减少API调用监控告警设置监控系统跟踪服务状态 总结与下一步通过本文的指南您已经成功部署了Headplane - Headscale的完整功能Web管理界面。Headplane不仅提供了直观的设备管理体验还支持高级功能如网络配置、ACL管理和远程SSH。下一步建议探索更多功能尝试配置ACL规则和用户组集成监控将Headplane与Prometheus/Grafana集成自动化部署使用Ansible或Terraform自动化部署流程备份策略建立定期备份Headplane数据的策略Headplane的持续开发确保了与Headscale的紧密集成和功能更新。定期检查项目更新获取最新功能和安全性改进。SSH终端界面 - 通过Web界面直接访问Tailscale节点的终端开始使用Headplane享受更简单、更高效的Headscale管理体验吧【免费下载链接】headplaneA feature-complete Web UI for Headscale项目地址: https://gitcode.com/gh_mirrors/he/headplane创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考