mcpField
T
tailscale-install

tailscale-install

github.com/rshade云与 DevOps391 次安装2 周前更新
代码仓库

关于 tailscale-install

此技能检测设备环境、安装 Tailscale 并引导设备连接 tailnet，适用于首次配置或检查安装状态的用户。它会先识别 WSL2 等环境，再按平台处理安装、验证和初始身份验证。

主要功能

  1. 01检测操作系统与运行环境
  2. 02检查现有安装及连接状态
  3. 03按平台选择安装方式
  4. 04验证程序与守护进程
  5. 05引导连接 tailnet

适用场景

  1. 01在新设备上安装 Tailscale
  2. 02检查现有 Tailscale 安装和连接
  3. 03为无头服务器配置初始连接
  4. 04避免在 WSL2 中安装 Linux 软件包

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/rshade/agent-skills --skill tailscale-install

安装后在 Claude Code 中输入/tailscale-install确认已加载。

附带文件references/platform-install-commands.mdreferences/post-install-checklist.md

详细介绍

Tailscale 安装

安装 Tailscale 并将设备连接到 tailnet。此流程会检测平台、执行安装和验证，并完成初始身份验证。

此技能的功能

  1. 检测平台（操作系统、发行版、WSL2、容器）。
  2. 检查是否已安装 Tailscale。
  3. 使用相应的软件包管理器安装 Tailscale。
  4. 验证安装情况和守护进程状态。
  5. 指引完成与 tailnet 的初始连接。

平台检测

选择安装方式之前，先检测环境。首先检查 WSL2，以免在 WSL2 实例中安装 Linux 软件包。

1. Check WSL2 (but not containers running on WSL2)
   ├─ grep -qi microsoft /proc/version 2>/dev/null
   ├─ AND [ ! -f /.dockerenv ] (not a container)
   ├─ WSL2 → go to "WSL2 special case"
   └─ Not WSL2 (or container) → continue

2. Check OS
   ├─ uname -s → Linux → detect distro
   ├─ uname -s → Darwin → macOS
   └─ OS is Windows → PowerShell commands

3. Detect Linux distro
   ├─ . /etc/os-release && echo $ID
   ├─ debian, ubuntu → apt
   ├─ fedora, rhel, centos, amzn → dnf/yum
   ├─ arch, manjaro → pacman
   ├─ alpine → apk
   ├─ opensuse*, sles → zypper
   └─ other → curl one-liner fallback

检查是否已安装

安装之前，检查是否已安装 Tailscale：

tailscale version 2>/dev/null

如果已安装：

  • 报告当前版本。
  • 检查守护进程状态：sudo systemctl status tailscaled（Linux）。
  • 检查连接状态：tailscale status。
  • 除非用户要求重新安装或升级，否则到此为止。

如果未安装，请继续安装。

WSL2 特殊情况

WSL2 与 Windows 主机共享网络栈。在 WSL2 内安装 Tailscale 会创建冲突的 WireGuard 隧道。不要在 WSL2 中安装 Linux 软件包。

检测方式（排除运行在 WSL2 主机上的容器）：

grep -qi microsoft /proc/version 2>/dev/null && [ ! -f /.dockerenv ] && echo "WSL2 detected"

检测到 WSL2 时：

  1. 检查 Windows 主机是否安装了 Tailscale：

    tailscale.exe version 2>/dev/null

  2. 如果已安装，报告版本并使用 tailscale.exe status 验证。

  3. 如果未安装，指示用户在 Windows 主机上使用 WinGet、Chocolatey 或 MSI 安装（参见 references/platform-install-commands.md）。

  4. 验证能否从 WSL2 访问 tailscale.exe。如果无法访问，检查 /etc/wsl.conf 的 [interop] 下是否设置了 appendWindowsPath = true。

安装

Linux（大多数发行版）
curl -fsSL https://tailscale.com/install.sh | sh
macOS
brew install --cask tailscale
Windows
winget install tailscale.tailscale

有关特定发行版的仓库设置（apt、dnf、pacman、apk、zypper）、Docker、Chocolatey 和 MSI，请参见 references/platform-install-commands.md。

安装后验证

安装完成后，验证以下三项：

1. 二进制文件可用
tailscale version

如果未找到，请检查 PATH 或重启终端会话。

2. 守护进程正在运行
# Linux (systemd)
sudo systemctl enable --now tailscaled
sudo systemctl status tailscaled

# macOS — open Tailscale from Applications
# Windows — check: Get-Service Tailscale
3. 连接状态
tailscale status

如果设备尚未通过身份验证，请继续进行初始连接。

初始连接

交互式（台式机/笔记本电脑）
sudo tailscale up

此命令会输出身份验证 URL。在浏览器中打开该 URL 并登录。

无头模式（服务器）

在管理控制台（Settings > Keys）中生成身份验证密钥，然后：

sudo tailscale up --authkey=tskey-auth-<key>

有关标签、子网路由、出口节点和所有 tailscale up 标志，请参见 references/post-install-checklist.md。

错误处理

不要悄悄跳过失败的安装。请报告错误，并提供具体的解决步骤。

  • 权限被拒绝——在命令前加上 sudo，或以管理员身份运行。
  • 找不到软件包——尚未配置 Tailscale 仓库。请使用 curl 单行命令，或手动添加仓库（参见参考资料）。
  • 网络错误——检查互联网连接和 DNS 解析。
  • 守护进程无法启动——使用 sudo journalctl -u tailscaled --no-pager -n 50 检查日志。确认没有其他 VPN 占用相同端口。
  • 身份验证失败——身份验证密钥已过期（在管理控制台中重新生成）、SSO 配置错误，或设备数量已达上限。

参考资料

  • references/platform-install-commands.md — 各平台的完整安装命令
  • references/post-install-checklist.md — 验证步骤、身份验证密钥选项、常用标志及首次运行故障排除

评论

支持 Markdown