tailscale-install

Tailscale のインストール

Tailscale をインストールし、デバイスをテイルネットに接続します。プラットフォームの検出、インストール、検証、初回認証に対応します。

このスキルでできること

1. プラットフォーム（OS、ディストリビューション、WSL2、コンテナー）を検出します。
2. Tailscale がすでにインストールされているか確認します。
3. 適切なパッケージマネージャーを使用して Tailscale をインストールします。
4. インストールとデーモンの状態を確認します。
5. テイルネットへの初回接続を案内します。

プラットフォームの検出

インストール方法を選ぶ前に、環境を検出してください。WSL2 インスタンス内に Linux パッケージをインストールしないよう、最初に WSL2 を確認してください。

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. 見つからない場合 — WinGet、Chocolatey、または MSI を使用して Windows ホストにインストールするようユーザーに案内します（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 を参照してください。

インストール後の確認

インストール後、次の 3 点を確認してください。

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 が表示されます。ブラウザーで開いてサインインしてください。

ヘッドレス（サーバー）

管理コンソール（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 — 確認手順、認証キーのオプション、一般的なフラグ、初回実行時のトラブルシューティング