Skip to content

文章:Linux 上安裝 Tailscale(Debian、Ubuntu、Raspberry Pi OS) - #210

Merged
shyuan merged 2 commits into
mainfrom
docs/linux-install-97
Nov 9, 2026
Merged

shyuan merged 2 commits into
mainfrom
docs/linux-install-97

Conversation

@shyuan

@shyuan shyuan commented Nov 9, 2026

Copy link
Copy Markdown
Contributor

Closes #97

新增 /platforms/linux-install/(src/content/docs/platforms/linux-install.mdx),依 #97 大綱整理:

  • 安裝方式:官方自動腳本 curl -fsSL https://tailscale.com/install.sh | sh 的實際步驟與環境變數(TAILSCALE_VERSION、TRACK);手動加入 APT 套件庫(Debian、Ubuntu、Raspberry Pi OS 64 位元 debian 與 32 位元 raspbian 對照),以及 RHEL/Fedora、openSUSE、Arch、Alpine、NixOS 與 Static binaries
  • 登入與改設定:tailscale up 首次登入與常用旗標(--auth-key、--advertise-tags、--qr、--ssh、--operator),以及日常改設定使用 tailscale set 與 tailscale up 的差異
  • systemd 服務與開機自動連線:tailscaled 與 tailscale 的分工、開機無須登入即常駐連線、常用 systemctl/journalctl 指令,以及 /var/lib/tailscale/tailscaled.state 與 /etc/default/tailscaled
  • --accept-dns 與 --accept-routes:Linux 預設 --accept-routes=false 的保護原因;tailscaled 在 Linux 上的三種 DNS 管理模式(systemd-resolved、resolvconf/openresolv、以及備份至 /etc/resolv.pre-tailscale-backup.conf 直接改寫 /etc/resolv.conf 的 direct 模式),與 DHCP/NetworkManager 覆寫 resolv.conf 的排解方式
  • 更新方式:APT 套件管理員、tailscale update(--dry-run、--yes、--version、--track)與 tailscale set --auto-update
  • Raspberry Pi 注意事項:32 位元(armhf、ID=raspbian)與 64 位元(arm64、ID=debian)的加密效能差異與 dpkg --print-architecture 檢查方式;microSD 卡寫入與 OverlayFS 下 /var/lib/tailscale/ 不可放入 tmpfs 的原因;當 Subnet Router、Exit Node 與 Pi-hole 的連結與注意事項

版本註記寫明「依官方文件及 v1.104 原始碼整理,未實際驗證」。

另外:

  • src/content/docs/platforms/index.mdx 的文章清單加入本文
  • src/content/docs/getting-started/first-device.mdx 與 src/content/docs/use-cases/subnet-router-raspberry-pi.mdx 連到本文

本機已跑 lint:text、lint、format:check、typecheck、build、lint:docs 與 nimbus-docs check,全部通過。

@shyuan

shyuan commented Nov 9, 2026

Copy link
Copy Markdown
Contributor Author

PR #210 審查:文章:Linux 上安裝 Tailscale(Debian、Ubuntu、Raspberry Pi OS)

整體:結構穩固。有依照 repo 慣例(版本註記含「未實際驗證」誠實聲明、section index 已更新、sidebar.order: 0.8 未衝突、內部連結 root-relative 帶尾斜線且全部可解析——含 #5-magicdns-會被複製進-lxc 錨點與 PVE 文章內既有的連結一致、title 不在內文重複、OG 標題字元都在字型子集內)。CI 兩項檢查皆通過。

較難自查的技術主張我逐一對照了官方文件與 v1.104 原始碼,大多完全正確:

  • tailscale set 與 up 的語意差異、以及 up 專屬旗標(--auth-key、--advertise-tags、--login-server)——與官方 CLI reference 一致
  • tailscale get/--set-flags、tailscale debug daemon-logs、--auth-key 的 file: 形式——皆有查證存在
  • tailscale update 只針對 tailscale.list 跑 APT 更新(Dir::Etc::SourceList)與 --allow-downgrades——符合 clientupdate.go
  • resolv.conf「trample」行為(inotify 監看、連續覆寫 10 次後停止重試、health 警告)——符合 net/dns/direct.go
  • distro/codename 對照表(含 forky、plucky、raspbian、amazon-linux/2023)——與 pkgs.tailscale.com 相符
  • --accept-routes 各平台預設值(兩種 macOS 變體都會自動接受、Linux 不會)——與目前官方文件一致

發現的問題

1. 低 —— Amazon Linux 2023 指令漏了前置步驟(linux-install.mdx,Amazon Linux 2023 項目)

官方在 AL2023 的步驟以 sudo yum install yum-utils 開頭,因為 AL2023 出廠並沒有附 yum-config-manager。文中的 sudo yum-config-manager --add-repo … 在出廠狀態的系統上會直接 command not found。修正方式很簡單:補上 yum-utils 安裝步驟(或加註說明)。

2. 低 —— Rocky/AlmaLinux 套件庫建議與官方工具不一致(linux-install.mdx,RHEL/CentOS 項目)

文中寫「Rocky Linux 與 AlmaLinux 可用 RHEL(或 Fedora)的套件庫」,但 Tailscale 官方的 installer.sh 實際是把 rocky|almalinux 對應到 centos 套件庫(不是 rhel 或 fedora),且 pkgs.tailscale.com 頁面完全沒提 Rocky/Alma。RHEL 套件庫因 EL 二進位相容大概率能用,所以是偏離而非錯誤,但對講求準確性的文件來說,建議改成 centos/<版本號>(install.sh 實際設定的來源)比較一致。

已確認非問題

<Aside type="caution"> 是文件中首次直接使用,但它是已註冊的全域元件且 props API 完全正確,build 也已驗證。first-device.mdx 與 subnet-router-raspberry-pi.mdx 的修改為單純加連結,與周邊表格/文字風格一致。

兩個發現都屬次要——不影響主要的 Debian/Ubuntu/Raspberry Pi 流程。其餘內容經查證無誤。

@shyuan
shyuan merged commit ee638a3 into main Nov 9, 2026
2 checks passed
@shyuan
shyuan deleted the docs/linux-install-97 branch November 9, 2026 06:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Linux 上安裝 Tailscale(Debian、Ubuntu、Raspberry Pi OS)

1 participant