Tailscale 配置指南

Tailscale 是 HiTerm 的核心依赖。 PC 和手机都必须安装 Tailscale 并登录同一个账号，否则 HiTerm 无法工作。

为什么需要 Tailscale？

HiTerm 的设备发现和通信完全依赖 Tailscale：

  • 设备发现：手机通过 Tailscale 找到你的 PC
  • P2P 直连：数据在设备间直接传输，不经过云端中转
  • 安全性：所有通信通过 WireGuard 加密
  • NAT 穿透：无需公网 IP 或端口转发即可连接
┌──────────────┐         Tailscale VPN         ┌──────────────┐
│   PC (hicli) │ ◄══════════════════════════► │  手机 App     │
│              │     P2P 直连，端到端加密       │  (hitermux)  │
└──────────────┘                               └──────────────┘

下载 Tailscale

统一下载地址：https://tailscale.com/download

打开后会自动识别你的操作系统，提供对应的安装包。

平台 下载方式
Linux 命令行安装（见下方）或从官网下载 .deb / .rpm
macOS 从官网下载或 brew install --cask tailscale
Windows / WSL2 从官网下载 Windows 版安装包
Android Google Play Store 搜索 "Tailscale"
iOS App Store 搜索 "Tailscale"

注册 Tailscale 账号

  1. 访问 https://tailscale.com 注册账号（免费）
  2. 可以使用 Google、GitHub、Microsoft 或邮箱注册
  3. 注册后登录 Tailscale 管理面板：https://login.tailscale.com

一个账号支持最多 100 台设备（免费计划），足够个人使用。

PC 端安装

Linux

curl -fsSL https://tailscale.com/install.sh | sh

安装完成后启动并登录：

sudo tailscale up

浏览器会自动打开 Tailscale 登录页面，授权即可。

macOS

brew install --cask tailscale

或从 https://tailscale.com/download/mac 下载。安装后打开 Tailscale App，登录账号。

Windows WSL2

方法一：在 Windows 上安装（推荐）

  1. 从 https://tailscale.com/download/windows 下载 Windows 版 Tailscale
  2. 安装并登录
  3. WSL2 会自动获得 Tailscale 网络（通过 Windows 主机的网络桥接）

方法二：在 WSL2 内安装

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up

验证 PC 端安装

# 查看 Tailscale 状态
tailscale status

# 查看 Tailscale IP（hicli 需要这个）
tailscale ip -4

你应该看到类似输出：

100.x.x.x  your-pc-name  linux  -

100.x.x.x 就是你的 Tailscale IP。

手机端安装

Android

  1. 从 Google Play Store 搜索 "Tailscale" 安装
  2. 或从官网下载：https://tailscale.com/download/android
  3. 打开 App，登录 与 PC 相同的账号

验证手机端

打开 Tailscale App，你应该能看到你的 PC 出现在设备列表中。

验证两端互通

在 PC 上检查

tailscale status

你应该看到类似：

100.x.x.x  your-pc-name   linux  -
100.y.y.y  your-phone-name android -

两端都显示在线说明连接正常。

在手机上检查

打开 Tailscale App → 设备列表，PC 应该显示为在线状态。

⚠️ 常见问题

Q: 两端无法互相发现？

A: 请确认：

  1. 两端登录的是 同一个 Tailscale 账号
  2. 两端都已连接到 Tailscale 网络（App 中显示 "Connected"）
  3. Tailscale 管理面板中没有启用 ACL 限制（免费账号默认无限制）

Q: Tailscale IP 显示为空？

A:

  1. 确认 Tailscale 服务正在运行：sudo tailscale status
  2. 如果未运行，启动它：sudo tailscale up
  3. 检查是否有多个 Tailscale 实例冲突

Q: HiTerm 提示"Tailscale 未检测到"？

A:

  1. 运行 tailscale status 确认 Tailscale 在线
  2. 运行 tailscale ip -4 获取 IP
  3. 运行 hicli doctor --fix 诊断问题
  4. 运行 hicli restart 重启服务

Q: 公司/学校网络无法使用 Tailscale？

A:

  1. 某些网络环境会阻止 Tailscale 的连接
  2. 尝试切换网络（如使用手机热点测试）
  3. 联系网络管理员确认是否有防火墙限制

Q: 如何查看设备是否在线？

A:

  • PC 端：运行 tailscale status
  • 手机端：打开 Tailscale App 查看设备列表

Q: Tailscale 是否收费？

A: Tailscale 免费计划支持：

  • 最多 100 台设备
  • 3 个用户
  • 所有核心功能（P2P、NAT 穿透、MagicDNS 等）

对个人使用完全免费。

Q: 可以不用 Tailscale 吗？

A: 不行。 Tailscale 是 HiTerm 的核心网络基础，目前不支持其他 VPN 方案。

Tailscale 高级配置（可选）

设备命名

建议为设备设置有意义的名称，方便识别：

# 在 PC 上
sudo tailscale set --hostname my-dev-pc

# 查看当前设备名
tailscale status --self

MagicDNS

MagicDNS 允许通过设备名（而非 IP）访问设备。默认已启用。

# 通过设备名 ping
ping my-dev-pc

退出 Tailscale

# 临时断开（保持登录）
sudo tailscale down

# 重新连接
sudo tailscale up

# 彻底登出（需要重新登录）
sudo tailscale logout

下一步

Tailscale 安装完成后：

  1. 快速开始 - 安装 HiCLI 并初始化
  2. 下载页面 - 获取 Android App
  3. Android App 安装指南 - 手机端配置

技术支持

如果 Tailscale 相关问题无法解决：

在 GitHub 上编辑此页