如何快速搭建Headscale-UI：Tailscale私有网络的终极Web管理界面 🚀
【免费下载链接】headscale-ui A web frontend for the headscale Tailscale-***patible coordination server 项目地址: https://gitcode.***/gh_mirrors/he/headscale-ui
Headscale-UI是一个为Headscale打造的网页前端工具，Headscale作为Tailscale兼容的服务协调器，能帮助用户轻松构建和管理私有网络。Headscale-UI提供了直观的操作界面，优化了跨域资源共享（CORS）问题，让网络管理更加灵活便捷。
📋 为什么选择Headscale-UI？5大核心优势解析
1️⃣ 自动化部署，一键上手
借助Docker容器化技术，Headscale-UI实现了快速配置和上线，即使是新手也能在几分钟内完成部署。无需复杂的环境配置，省去繁琐的安装步骤，让你专注于网络管理本身。
2️⃣ 灵活适配，多场景适用
可调整HTTP和HTTPS端口号，完美适应各种网络架构需求。无论是小型家庭网络还是大型企业环境，都能轻松应对，提供稳定可靠的服务。
3️⃣ 安全增强，数据无忧
内置CORS策略调整选项，有效增强跨域数据的安全性。让你的网络数据在传输和管理过程中得到全方位的保护，杜绝安全隐患。
4️⃣ 简洁界面，易用性强
提供简洁明了的用户界面，降低学习曲线。所有功能一目了然，操作流程清晰顺畅，让你轻松掌握网络管理的各项技能。
5️⃣ 强大兼容，无缝集成
作为静态站点部署在任何支持Web服务器上，如Nginx或Apache等。能与Headscale服务无缝集成，为你提供一体化的管理和访问接口。
Headscale-UI直观的操作界面，让网络管理变得简单高效。
🔧 最快配置方法：3步完成Headscale-UI部署
第1步：获取项目代码
通过以下命令克隆项目仓库：
git clone https://gitcode.***/gh_mirrors/he/headscale-ui
第2步：Docker快速启动
使用Docker ***pose快速部署Headscale和Headscale-UI：
version: '3.5'
services:
headscale:
image: headscale/headscale:stable
container_name: headscale
volumes:
- ./container-config:/etc/headscale
- ./container-data/data:/var/lib/headscale
***mand: serve
restart: unless-stopped
headscale-ui:
image: ghcr.io/guru***puting/headscale-ui:latest
restart: unless-stopped
container_name: headscale-ui
第3步：配置反向代理
以Caddy为例，配置反向代理实现域名访问：
https://hs.yourdomain.***.au {
reverse_proxy /web* http://headscale-ui:8080
reverse_proxy * http://headscale:8080
}
🛠️ 高级功能设置：解锁Headscale-UI全部潜力
自定义端口设置技巧
如果需要修改默认端口，可通过环境变量进行配置： | 变量 | 描述 | 示例 | |----|----|----| | HTTP_PORT | 设置HTTP端口 | 8080 | | HTTPS_PORT | 设置HTTPS端口 | 8443 |
跨域安装解决方案
若不想将Headscale-UI与Headscale配置在同一子域，可通过反向代理拦截Headscale流量修复CORS问题。以Caddy为例：
https://hs.yourdomain.***.au {
@hs-options {
host hs.yourdomain.***.au
method OPTIONS
}
handle @hs-options {
header {
A***ess-Control-Allow-Origin https://hs-ui.yourdomain.au
A***ess-Control-Allow-Headers *
A***ess-Control-Allow-Methods "POST, GET, OPTIONS, DELETE"
}
respond 204
}
}
Headscale-UI端口重映射操作演示，轻松适配不同网络环境。
📚 官方文档与资源
- 架构说明：documentation/architecture.md
- 开发指南：documentation/development.md
- 测试方法：documentation/testing.md
- 样式规范：documentation/style.md
❓ 常见问题解答
问题1：出现“Missing Bearer Prefix”错误怎么办？
这通常是API密钥未保存或反向代理未正确配置导致的。通过命令headscale apikeys create创建API密钥，并在Headscale-UI的设置中保存即可。
问题2：移动设备访问体验如何？
虽然移动设备可正常使用Headscale-UI的各项功能，但目前网页体验尚未针对移动设备进行优化，建议在桌面端使用以获得最佳效果。
问题3：使用 raw IPs 和端口访问时无法正常工作？
Headscale-UI必须与Headscale运行在同一子域，或配置CORS。使用 raw IPs 和端口访问会导致跨域问题，无法正常使用。
Headscale-UI凭借其出色的性能、简便的部署方式以及强大的社区支持，在众多网络管理工具中脱颖而出。无论你是正在寻找提高现有网络基础架构管理效率的方法，还是寻求创建一个更安全、更高效的企业内部网络系统，Headscale-UI都是一个不可多得的选择。立即尝试，让网络管理变得既高效又省心！
【免费下载链接】headscale-ui A web frontend for the headscale Tailscale-***patible coordination server 项目地址: https://gitcode.***/gh_mirrors/he/headscale-ui
