ScaleTail 是基于 Tailscale 源码裂变的自建网络客户端，主要面向 Headscale/ScaleForge 私有控制服务器。项目目标是把新手原本需要在 CMD 里执行的连接、状态、netcheck、出口节点、宣告路由等操作移动到桌面可视化窗口中。
| 项目项 | 当前说明 |
|---|---|
| 裂变来源 | 基于 tailscale/tailscale 主线源码改造，项目 module 已改为 scaletail.com |
| 当前产品版本 | v0.0.6 |
| 对标官方版本 | 已按官方 Tailscale v1.98.5 的关键客户端修复做定向审计和回补 |
| Go 版本 | go.mod 使用 Go 1.26.2 |
| 桌面端 | Electron 38 + Vue 3 + TypeScript |
| 配套服务端 | 推荐配套 ScaleForge + Headscale-Admin-AE |
注意：ScaleTail 不是对官方 Tailscale 的整仓无损同步版本，而是保留自定义命名、Windows 服务、LocalAPI helper、Electron 桌面端和安装包逻辑后，对上游关键稳定性修复进行选择性回补。
- Electron 连接流程改为直接调用
scaletaildLocalAPI 新增的/localapi/v0/scaletail-up，执行等价up的连接逻辑，不再走隐藏 CLI 作为连接主路径。 scaletail-up支持控制服务器地址、设备名、预认证密钥、接受路由和 DNS 偏好，并在 daemon 内完成参数校验、Prefs 更新、启动和必要的交互式登录触发。- 修复平台上报配置保存时 Electron IPC 出现
An object could not be cloned的问题，保存前会转为可克隆的纯对象。 - 支持读取打包内置的
resources/report-config.json，便于安装包携带 ScaleForge 上报地址和客户端 token；用户配置仍优先覆盖内置配置。 - 安装包版本升级到
0.0.6，覆盖安装和卸载时会清理旧版tailscale.exe、tailscaled.exe、tailscale-localapi.exe进程和旧服务残留。
- 产品命名统一为 ScaleTail，核心命令为
scaletail，核心服务为scaletaild，LocalAPI helper 为scaletail-localapi。 - Windows 桌面端使用 Electron 38 + Vue 3 + TypeScript 实现，安装后由托盘常驻。
- 服务端连接页支持控制服务器 IP/域名、端口、HTTP/HTTPS、设备名、预认证密钥、接受路由。
- 连接页展示等价命令，便于核对实际执行逻辑，例如
scaletail up --login-server=http://host:port --auth-key=...。 - 已修正预认证密钥连接逻辑：填写 key 时不再触发浏览器交互式认证。
- 仪表盘展示连接状态、本机名称、本机 ScaleTail IP、节点数量、节点列表和节点流量。
- 节点页支持
netcheck、出口节点选择、宣告子网路由。 netcheck通过 LocalAPI 调用，不再依赖外露 CMD 窗口。- 托盘左键直接唤起已有窗口，不重复打开多个仪表盘。
- Windows 安装包包含
ScaleTailUI.exe、scaletail.exe、scaletaild.exe、scaletail-localapi.exe、wintun.dll。 - 安装、覆盖安装和卸载会尝试关闭相关进程、停止服务、清理旧服务和残留文件。
- 新增平台上报能力：客户端可定时向 ScaleForge 上报流量、请求连接摘要、策略应用状态。
- 新增策略领取能力：客户端可领取 ScaleForge 下发的限速/配额策略。
- 新增客户端版本检查能力：支持接收 ScaleForge 发布的建议更新/强制更新，并在 Windows 桌面端提示。
- Windows 上传限速通过系统 QoS 尝试应用；下载限速字段已预留，但暂未做 TUN/内核级强制，后续进入
scaletaild核心流量路径实现。
| 场景 | 难度 | 说明 |
|---|---|---|
| 直接安装 Windows exe 安装包 | 低 | 推荐方式。需要管理员权限安装 Windows 服务和 Wintun。 |
| 从源码构建 Windows 安装包 | 中 | 需要 Go、Node.js、npm、Inno Setup 6。构建脚本已自动处理 Electron 和 Wintun。 |
| Linux 客户端命令行包 | 中 | 可按原项目 Linux 编译链路打包，图形窗口可选。 |
| macOS 未签名包 | 中高 | 可以通过 GitHub Actions macOS runner 构建，未签名包需要用户手动信任。 |
| 自行深度改核心网络 | 高 | 涉及 scaletaild、LocalAPI、Wintun/TUN、路由、DNS 和控制面协议。 |
前置要求：
- Go 1.26+
- Node.js + npm
- Inno Setup 6
- PowerShell
默认依赖缓存目录：
D:\workspace-qoder\deps
如果 Inno Setup 不在 D:\Inno Setup 6\ISCC.exe，可以设置 ISCC 环境变量指向 ISCC.exe。
在项目根目录执行：
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\build-windows-installer.ps1输出文件：
dist\installer\ScaleTail-0.0.6-windows-amd64-setup-custom.exe
cd client\electron
npm ci
npm run typecheck
npm run build完整联调建议使用构建脚本生成 dist\electron\win-unpacked\ScaleTailUI.exe，或直接安装生成的 Windows 安装包。
ScaleTail 客户端
|
| Tailscale/headscale 控制协议 + LocalAPI
v
Headscale-Admin-AE 控制服务
|
| 共享数据库/API
v
ScaleForge 管理平台
ScaleTail 负责客户端连接和桌面体验；Headscale-Admin-AE 负责控制面和节点注册；ScaleForge 负责可视化管理、策略、流量统计、安全审计。
- Electron
npm run typecheck通过。 - Electron
npm run build通过。 - Windows 安装包脚本完整通过。
- Inno Setup 6 编译通过，安装包内确认包含
scaletail.exe、scaletaild.exe、scaletail-localapi.exe和wintun.dll。
- 下载限速进入
scaletaild核心流量路径实现，避免只做页面字段但无强制效果。 - 继续减少上游残留命名和注释中的 Tailscale 字样。
- macOS 未签名安装包通过 GitHub Actions macOS runner 自动构建。
- Linux 图形端作为可选包输出，服务器场景默认只安装命令行和服务。
欢迎加入 ScaleForge 交流群，一起交流自建 Headscale、ScaleTail、ScaleForge 的部署、使用和二次开发经验。
群号：1041671099
如果这个项目帮你节省了部署和维护时间，可以请作者喝杯咖啡。打赏二维码维护在 ScaleForge 仓库中：
感谢支持，项目会继续围绕自建 Headscale/ScaleTail 网络的易用性、稳定性和安全可视化迭代。