SSD Nodes Learn Hosting plans →
指南 Matt Connor作者: Matt Connor · 已更新 2026-11-18

Tailscale tailnet lock 到底能防護什麼?

Tailscale tailnet lock 可阻止遭入侵的 coordination server 將未授權節點加入 tailnet,但無法保護已遭竊裝置;請妥善保管 1 個停用密鑰以便復原。

Tailnet lock 的防護範圍

Tailnet lock 是 Tailscale 的功能,可阻止 Tailscale 自有的協調伺服器將裝置加入您的 tailnet。啟用後,您的節點會拒絕任何未經您已信任之電腦所持有的金鑰簽署的 node key。因此,控制平面仍可分發金鑰,但無法再建立成員。這項保證的範圍刻意設得很小。Tailnet lock 只保護裝置加入的時刻,對於金鑰已遭竊取的裝置則不起作用。

在一般 tailnet 中,每個節點都會自行產生 WireGuard 金鑰,且不會將私密金鑰部分傳送到任何地方。協調伺服器是所有用戶端都會連線的控制平面,負責分發公開金鑰,並告知每個節點哪些裝置屬於 tailnet。這就是 Tailscale 的協調伺服器與金鑰分發 所依據的設計,也正是 Tailscale 絕不持有用來加密流量的金鑰 的原因。這也表示控制平面會自行決定成員資格。控制該平面的攻擊者可以將一個額外的 node key 發布到您的 tailnet,而您的節點會對其進行加密,因為通訊協定沒有提供任何機制,讓節點分辨遭注入的金鑰與真正的金鑰。

精確陳述威脅模型

tailnet lock 所回答的攻擊者模型,是能控制 coordination server 的一方。這包括 Tailscale 基礎架構遭到入侵、其中的惡意內部人員,以及迫使 Tailscale 採取行動的命令。針對這類攻擊者,也只有這類攻擊者,tailnet lock 會把答案從「攻擊者可以新增節點」改為「攻擊者不能新增節點,而且這次嘗試會被發現」。

其運作機制是由您掌握的簽章鏈。每個簽章節點都會在本機產生 tailnet lock key (TLK),並將其保留在該裝置上。您的 tailnet 會取得一份只能追加的權限更新日誌,也就是 tailnet key authority (TKA);每個節點都會保留這份日誌的副本。若節點金鑰未附有目前受信任 TLK 的有效簽章,系統就會拒絕該金鑰,因此對等節點不會取得連線,並會顯示為 locked out。Tailscale 的白皮書明確說明結果:啟用 tailnet lock 後,Tailscale 基礎架構無法將未經授權的節點新增至 tailnet,而且任何此類嘗試都能被偵測及阻擋。

以下 4 件事不在其防護範圍內。對大多數 tailnet 而言,這 4 件事的重要性都高於它能防護的情況。

  • 遭竊的裝置。 簽章只能記錄受信任的管理員曾在某個時間點核准該節點金鑰。它無法說明目前持有該筆電的人是誰。
  • 遭入侵的簽章節點。 Tailscale 自己的限制清單直接指出:tailnet lock keys 儲存在裝置上,因此取得該裝置的攻擊者也能取得金鑰。簽章節點應採用與保存 root SSH key 的機器相同的保護標準,也就是 產生、儲存及輪替 SSH 金鑰 中說明的做法。
  • 阻斷服務。 白皮書明確指出,tailnet lock 防護的是未經授權的節點,而不是阻斷服務。惡意的 control plane 仍可停止分發更新並中斷您的連線,但無法成為 tailnet 成員。
  • 最初的 5 分鐘。 請參閱下一節,因為這正是人們常略過的部分。

為什麼 tailnet lock 採用首次使用信任

啟用 tailnet lock 時,初始的信任金鑰集合會經由 control plane 傳送到各個節點,而 control plane 正是你要移除信任的對象。每個節點第一次會接受收到的內容,之後便依此強制執行。Tailscale 的白皮書指出了這項缺口:tailnet lock 首次啟用時,每個節點都會依賴 control plane 傳送給它的 tailnet lock 初始狀態。若 control plane 當時已遭入侵,攻擊者就可能植入包含其金鑰的金鑰集合,之後的每個簽章都會通過驗證。

這就是首次使用信任(TOFU),採用的模型與 SSH 在首次連線時接受主機金鑰指紋相同。沒有外部權威可供比對,因此必須由你手動執行檢查。

tailscale lock status

啟用後,請在數個節點上執行該指令。將各節點回報的受信任 tlpub: 值,與實際由簽署節點列印的金鑰進行比對。請透過不依賴 tailnet 的通道進行比對,因為植入惡意金鑰集合的 control plane 也可能看見你用來檢查的聊天內容。新增節點時,請再次執行這項檢查,因為新節點同樣會從 control plane 取得初始狀態。

啟用前請先確認這些事項

  • 所有需要持續運作的節點都必須使用 Tailscale v1.46.1 或更新版本。這是 Tailscale 文件列出的 tailnet lock 最低版本。請在每個節點上執行 tailscale version,包括曾經註冊後就被遺忘的路由器或設備。對於執行 tailscaled 的節點,請升級至 v1.90.8 或更新版本,並使用 --statedir 或 --state 設定狀態目錄;在 Docker 或 Kubernetes 中則使用 TS_STATE_DIR。較早版本在未設定狀態目錄時,無法強制執行簽署檢查。
  • 您至少必須選取 2 個簽署節點。這不是形式上的要求:簽署金鑰儲存在這些設備上,因此只有 1 個簽署節點時,只要磁碟故障,就可能導致 tailnet 永遠無法再加入新機器。
  • Android 設備無法作為簽署節點,因為它無法執行簽署作業。
  • Tailnet lock 與裝置核准是互斥功能。如果您的 tailnet 已要求手動核准裝置,您必須在兩者之間擇一,不能同時啟用。
  • 截至 September 2026,Tailscale 文件列出 Personal 和 Enterprise 方案支援 tailnet lock。因此,在安全性審查中承諾提供這項控制之前,請先確認您的方案。

如何啟用 tailnet lock

管理主控台會產生命令,接著由您在機器上執行。您也可以直接使用 CLI 建立命令。

  1. 在管理主控台中開啟 Device management 頁面,選擇啟用 tailnet lock。
  2. 選取您要信任其 tailnet lock 金鑰的節點。至少選取 2 個節點,並確保可以實際接觸這些硬體。
  3. 決定是否要為 Tailscale 支援人員產生額外的停用密鑰。回答前請先閱讀下一節。
  4. 複製主控台產生的 tailscale lock init 命令。此命令會針對您選取的每個簽署節點,帶有 1 個 tlpub: 引數。
  5. 在其中一個簽署節點上執行該命令。
tailscale lock init --gen-disablements=10 "tlpub:SIGNING_NODE_1_KEY" "tlpub:SIGNING_NODE_2_KEY"

tailnet 中已有的每個節點,都會在初始化期間由受信任金鑰簽署,因此原本正常運作的項目不會停止運作。變更的是新節點。加入已鎖定 tailnet 的機器會帶有尚未簽署的節點金鑰,該機器上的 tailscale lock status 會顯示此狀態:

This node is LOCKED OUT by tailnet-lock, and action is required to establish connectivity.

管理主控台會以 Locked out 徽章顯示相同狀態,而 machines-list 篩選器 property:locked-out 可以一次找出所有這些節點。被鎖定節點的狀態輸出也會列印可修正問題的確切命令。複製該行,並在簽署節點上執行:

tailscale lock sign "nodekey:NODE_KEY" "tlpub:ROTATION_KEY"

簽署者會隨時間變更,因此有 2 個命令可處理這項工作。tailscale lock add tlpub:<key> 會信任新的簽署節點。tailscale lock remove tlpub:<key> 會讓某個簽署者退役;預設情況下,它會重新簽署原本由該金鑰簽署的節點,讓這些節點繼續運作。若要停用此行為,請使用 --re-sign=false。如果簽署節點遭竊,而不是正常退役,則應使用 tailscale lock revoke-keys tlpub:<key>。此命令會透過 --cosign,分階段在其餘簽署者上執行,接著使用 --finish。tailscale lock log --limit 20 會列印最近的授權歷程;當節點遭鎖定且沒有人記得曾變更設定時,請在此查看。

10 個停用密碼,以及它們為何是風險所在

admin-console tailscale lock init` 命令會列印 10 個停用密碼;如果未設定 --gen-disablements`,CLI 預設只會列印 1 個。這些密碼只會在初始化時顯示 1 次,之後不會再次顯示。使用其中任一個密碼,都會關閉整個 tailnet 的 tailnet lock:

tailscale lock disable "DISABLEMENT_SECRET"

Tailscale 的文件明確說明其後果:如果遺失所有停用密碼,且未將其中 1 個提供給 Tailscale support,就無法復原 tailnet。請考慮實際情況:你的 2 個簽署節點分別是一台已清除資料的筆電,以及一台已刪除的 VPS。沒有人能簽署新的節點金鑰、加入簽署節點,或關閉鎖定。現有成員仍可使用 tailnet,但永久無法加入新成員。唯一的解決方式,是建立新的 tailnet,並重新註冊所有裝置。

至少將 1 個密碼當作 recovery code 保存;沒有必要保留全部 10 個。至少保留 2 份複本,且不要讓 2 份複本都依賴 tailnet 可連線。其中 1 份應離線保存。若某份複本只存在於必須透過 tailnet 存取的伺服器上,它就不算是任何資料的備份。

是否使用 support 選項,應經過明確評估,而不是直接採用預設做法。將 1 個密碼提供給 Tailscale support,代表 Tailscale 可以停用你的 tailnet lock,也就是將部分保證交還給這項功能原本要限制的對象。另一方面,即使遺失保存密碼的資料夾,你的 tailnet 也不會因此失效。如果啟用 tailnet lock 是因為第三方風險審查要求你說明 VPN 供應商遭到入侵時的處理方式,請不要提供密碼。如果啟用 tailnet lock 是因為管理員會異動,而你希望節點加入權限繫結至裝置,則可以提供密碼,降低管理上的顧慮。

為何無人值守佈建會失敗,以及修正方式

這是團隊在一週內就會遇到的結果。在受限制的 tailnet 中,機器啟動並使用一般 auth key 執行 tailscale up 時,會以無法存取的狀態加入。自動化工具回報成功,節點也會出現在主控台中,但沒有任何流量能到達該節點。若要提供無人值守的連線能力,請在節點建立前先簽署 auth key。

AUTH_KEY="tskey-auth-xxxxxxxxxxxxxxxx"
tailscale lock sign $AUTH_KEY

請在簽署節點上執行此命令。命令會輸出已簽署的 auth key;您的映像檔、cloud-init 檔案或 Terraform 變數會將該簽署值傳給 tailscale up --auth-key。使用此值建立的節點加入後即已完成簽署,可以連線。

在遇到問題前,請先了解兩種失敗模式。第一,簽署作業不適合並行執行。tailscale/tailscale 儲存庫中的 Issue 15266 於 2025 年 3 月提出,目前仍未關閉。該問題指出,並行執行 tailscale lock sign 時,Terraform 可能會取得空白的已簽署 auth key,導致部分節點以無法存取的狀態啟動,而其他節點則正常運作。提出問題的人員採用的因應方式,是一次只簽署一個 auth key,並在呼叫之間短暫暫停。請讓自動化流程檢查命令是否傳回非空白的 auth key,再儲存該值。

第二,已簽署的 auth key 會留下狀態。簽署作業會將 auth key 加入 authority;即使由該 auth key 建立的節點已不存在,該 auth key 仍會保留。2025 年 7 月的 Issue 16607 描述了一項自動化流程:部署裝置時定期簽署 auth key,直到 authority 超過上限:

network-lock modify failed: modify network-lock keys: generating checkpoint: generated update was invalid: checkpoint state: too many keys (552, max 512)

此時,tailnet 既無法新增 auth key,也無法移除超出的 auth key,因為移除作業本身就是 authority 更新,必須產生有效的 checkpoint。該問題於 2025 年 8 月標記為已完成,修正內容包括在達到上限時拒絕新增 auth key;目前的原始碼仍將 authority 限制為 512 個 auth key。請少量簽署 auth key 並重複使用,不要為每台機器各簽署一個;也請偶爾檢查 tailscale lock status,讓您掌握目前數量,而不是等到發現問題時才知道。

Ephemeral 與 CI 節點需要規劃

Ephemeral 節點會在登出時自行從 tailnet 移除,但它們仍然是節點,因此仍需要簽章才能與其他項目通訊。加入 tailnet 以執行部署的 CI 工作,同樣需要預先簽署的 auth key,就像長期運作的伺服器一樣。金鑰累積問題對 CI 的影響也最嚴重,因為 CI 會建立及銷毀最多節點。

可行的做法是在 CI secret store 中保存一個已簽署、可重複使用的 ephemeral auth key,依選定的排程輪替,而不是每個工作都輪替。每次輪替都會在 authority 中消耗一個金鑰,這個數量可以納入規劃。報告指出,該自動化流程會在裝置部署期間定期簽署 auth keys;內容並未表示它會為每個 CI 工作各簽署一個金鑰。

相同的原則也適用於承載其他機器流量的伺服器。從 VPS 廣告私有範圍的 subnet router 會代表其後方的每個位址通訊,因此位於該位置的遭注入節點可觸及遠多於單一主機的資源。這些伺服器應使用已簽署的金鑰進行佈建,並排除在完全自動化的流程之外。

兩個脫離機制及其作用

tailscale lock disable <disablement-secret> 會關閉整個 tailnet 的 tailnet lock。它需要 10 組 secret 其中之一。當問題出在授權機制本身時,應使用這個指令。

tailscale lock local-disable

tailscale lock local-disable 是單一節點的脫離機制,但其適用範圍經常被誤解。它會讓執行該指令的節點停止強制執行 tailnet lock,因此該節點會接受金鑰未經簽署的對等節點。它不會讓其他節點接受該節點未經簽署的金鑰。對遭拒於系統之外的伺服器執行 local-disable,不會因此讓其他節點能連線到該伺服器。這也是 Tailscale 文件說明要在每個節點上執行該指令,才能讓整個 tailnet 實際上忽略 tailnet lock 的原因。請將此視為暫時解除單一節點強制執行的緊急措施,待該節點目前無法簽署的問題排除後,正確簽署該節點,並停止關閉強制執行。

誰應啟用 tailnet lock,誰不應啟用

如果節點加入權限需要在人員離職後仍然有效,請啟用 tailnet lock。未啟用時,任何具備 console 管理權限的人員都能加入機器。啟用後,加入機器還需要持有受信任 signing key 的裝置,因此即使忘記撤銷離職管理員的 console 存取權限,該管理員仍無法加入節點。如果客戶的第三方風險問卷要求說明如何防止 VPN 供應商加入您的網路,也請啟用此功能。這項控制能以實際機制回答問題,而不是只提出承諾。

如果是只有一名使用者,且 tailnet 僅包含一台 laptop、一支 phone 和一台 VPS,請不要啟用。這類 tailnet 實際面臨的威脅是您失去存取權,而不是 Tailscale 遭到入侵。tailnet lock 要求您正確保存至少一個 disablement secret,以便復原。如果遺失所有 secret,且未向支援團隊提供其中一個,將無法復原。因此,啟用它會提高您實際面臨的風險,卻只降低一項您不太可能面臨的風險。對於沒有清楚記錄各個 signing device 持有人員的小型團隊,同樣適用這項判斷。請先做好這項記錄管理,因為 tailnet lock 本質上就是記錄管理,只是附帶永久失效模式。

Headscale 以不同方式回答相同問題

如果疑慮在於由第三方決定誰能加入您的網路,則有兩種解法。Tailnet lock 保留 Tailscale 的協調伺服器,但移除其新增成員的權限。執行您自行託管的開放原始碼協調伺服器 Headscale 則是移除該伺服器,並由您同時承擔控制權與維運工作,包括修補、備份,以及凌晨 2 點必須由您處理的服務中斷。兩者在抽象層面上都沒有比較安全。請根據您較願意承擔哪一種故障來選擇:受您限制的託管控制平面,或由您自行運作的控制平面。

FAQ

tailnet lock 實際上會阻止什麼?

它會阻止 Tailscale 的 coordination server 將節點加入您的 tailnet。啟用 tailnet lock 後,只有在您控制的 signing node 使用其 tailnet lock key 簽署 node key 後,該 node key 才會被接受。因此,即使 control plane 遭到入侵並散布金鑰,也無法加入新的成員。它不會額外加密任何內容,因為節點之間的流量本來就已使用 WireGuard key 進行端對端加密,而 coordination server 從未持有這些 key。它也無法防範遭竊的裝置、遭入侵的 signing node,或只是停止提供您的 tailnet 服務的 control plane。

如果我遺失全部 ten 個 disablement secret,會發生什麼事?

tailscale lock init 執行時會顯示這些 secret,之後不會再次顯示。如果您遺失全部 secret,且未將其中一個傳送給 Tailscale support,文件指出該 tailnet 將無法復原。實務上,如果您也失去所有 signing node,就無法再簽署任何 node key,也無法關閉 lock,因此唯一可行的方式是建立新的 tailnet,並重新註冊所有裝置。請將兩份副本保存於不會同時依賴 tailnet 運作的位置,並讓其中一份保持離線。

我必須手動簽署每個新裝置嗎?

不必。請改為簽署 auth key,而不是節點。在 signing node 上匯出該 key,然後執行 tailscale lock sign $AUTH_KEY,再將該命令顯示的 signed value 傳給映像檔或佈建工具中的 tailscale up --auth-key。以這種方式建立的節點會以已簽署狀態加入。請簽署少量可重複使用的 key,而不是每台機器各簽署一個,因為每個 signed key 都會在節點移除後,繼續為 authority 增加一個 key;而 authority 最多只能有 512 個 key,實務上的自動化流程已曾達到這項上限。

tailnet lock 和 device approval 相同嗎?

不相同,而且兩者無法同時執行,因為它們是互斥的功能。device approval 是 admin console 中的政策檢查:管理員必須先勾選選項,新裝置才能取得存取權,而 coordination server 會強制執行該決定。tailnet lock 則是由您自己的節點執行的密碼編譯檢查,使用保存在您自有硬體上的 key,因此即使 coordination server 具有惡意,也仍然有效。device approval 是管理使用者時較輕量的控制機制。tailnet lock 則是用來回答與供應商相關問題的機制。

這篇文章對您有幫助嗎?

#tailscale#tailnet-lock#vpn#key-management#security