跳轉到

Tailscale

Terminology rule (zh-TW pages)

技術名詞首次出現以「中文 (English original)」格式呈現，例：依賴注入 (dependency injection)。不自創翻譯——若無公認譯名直接保留英文 （如 embedding、tokenizer）。代碼、API 名、CLI flag、套件名、檔名一律不翻。

獨立版 (Standalone) > App Store

本 repo 如何安裝 (macOS)

  • GUI app + daemon → cask "tailscale-app"（Brewfile.darwin）——即 macsys 獨立版 (standalone) build（io.tailscale.ipn.macsys），其 system extension 就是 daemon。先前用 mas "Tailscale"，但 Tailscale 已從 Mac App Store 下架（mas 安裝會失敗），改用 cask 是官方支援路徑。
  • CLI(PATH) → 一樣來自 cask，不需要另裝 formula:cask 的 pkg 會安裝 /usr/local/bin/tailscale,那是一個指向 app bundle 的 shell wrapper(exec /Applications/Tailscale.app/Contents/MacOS/tailscale "$@")。不要再裝獨立的 brew "tailscale" formula——它多餘,且每次升級都會跟 cask 搶同一個路徑(ollama 式的 link 衝突),還會裝一個 app 的 system extension 已經在跑的 tailscaled。
  • macOS 上絕不要 brew services start tailscale:app 的 system extension 已經是 daemon,再起一個 tailscaled 會衝突。

「Another Tailscale copy was found on this Mac」

若 debug 面板回報 /Applications/Tailscale.localized/Tailscale.app 的衝突(常伴隨 DNS Unavailable / dns-forward-failing),那是 mas → cask 遷移遺留的舊 App Store build(chezmoi apply 只裝不移除)。修法:

sudo rm -rf /Applications/Tailscale.localized   # 只刪閒置的 App Store 那份

完整偵測 + 根因: pitfalls/tailscale-another-copy-app-store-leftover.md。

本 repo 如何安裝 (Linux)

可選 role，由 installTailscale 控制（獨立的 prompt——刻意不併進 installNetworkingTools，那是唯讀的診斷工具包；也不併進 installTunnelTools， 那是把 localhost 曝露到公網）。

dot_ansible/roles/networking_tools，tag tailscale：Debian/Ubuntu/Raspbian 走官方 pkgs.tailscale.com apt repo（deb822_repository），RedHat 家族走 yum repo，前面有 tailscale version 探測所以是 install-only。衍生發行版若 codename 不是上游 suite （Mint、Pop!_OS）會直接跳過並指向官方安裝腳本，由它自己做對應。

apt 快取更新只針對 Tailscale 這個來源 （-o Dir::Etc::sourcelist=sources.list.d/tailscale.sources）。不設範圍的 apt-get update 會重抓機器上每一個第三方來源，任一個不穩就會讓剛加好的 Tailscale repo 沒被索引到。（gui_apps_linux 的 Steam 區塊註解裡已經把 tailscale 列為那些 不穩來源之一。）

ansible 刻意不做的兩步——都需要互動或 sudo，會在跑完時印出來：

sudo tailscale up                      # 瀏覽器登入，加入 tailnet
sudo tailscale set --operator=$USER    # 讓 `tsnet serve` 不必 sudo 就能跑

操作工具：tsnet CLI

tsnet 包起本 repo 需要的兩個流程——把 tailnet 裝置清單變成 ~/.ssh/config 條目，以及用 tailnet HTTPS（tailscale serve）曝露本機服務， 給任何硬性要求 https:// origin 的服務用。Picker 雙生：tv tailnet。 從 tsnet doctor 開始。