Ubuntu 安裝 Tailscale 錯誤排除指南
Ubuntu 安裝 Tailscale 多半是 apt 錯誤。查看 apt 顯示的狀態碼,修正 Ubuntu 發行版代號或簽章 keyring,解決套件庫與金鑰問題。
為什麼 Ubuntu 上的 Tailscale 安裝錯誤其實是 apt 錯誤
Ubuntu 上的 Tailscale 安裝錯誤幾乎總是在任何 Tailscale 程式碼執行前發生。這些是 apt 錯誤。2026 年 10 月檢查 Ubuntu 套件封存時,沒有找到 tailscale 套件;唯一相符的項目是 Go 輔助程式庫與 python3-tailscale。因此,daemon 通常來自 Tailscale 自己在 pkgs.tailscale.com 的 apt repository。Canonical 也維護 Tailscale snap,本文將在接近結尾處與其他替代方案一併說明。
加入該 repository 會寫入 2 個檔案。其中 1 個檔案告訴 apt 套件所在的位置。另一個檔案包含 apt 用來驗證 repository index 簽章的公開金鑰。以下幾乎所有錯誤,都是這 2 個檔案其中之一內容錯誤,或 apt 與 repository 之間的某個裝置拒絕請求。
以下是 Tailscale 為 Ubuntu 24.04 發布的指令:
sudo mkdir -p --mode=0755 /usr/share/keyrings
curl -fsSL https://pkgs.tailscale.com/stable/ubuntu/noble.noarmor.gpg | sudo tee /usr/share/keyrings/tailscale-archive-keyring.gpg >/dev/null
curl -fsSL https://pkgs.tailscale.com/stable/ubuntu/noble.tailscale-keyring.list | sudo tee /etc/apt/sources.list.d/tailscale.list
sudo apt-get update && sudo apt-get install tailscalenoble 是 Ubuntu 24.04 的代號,且會同時出現在 2 個 URL 中。第 2 個指令會將註解行與 1 行 deb 寫入 /etc/apt/sources.list.d/tailscale.list,而 cat 會顯示實際寫入的完整內容。
cat /etc/apt/sources.list.d/tailscale.list請將 deb 行解讀為由 4 個欄位組成的位址:方括號中的選項 [signed-by=/usr/share/keyrings/tailscale-archive-keyring.gpg]、透過 https 存取的 repository 基底位址 pkgs.tailscale.com/stable/ubuntu、套件組 noble,以及元件 main。apt 會將基底位址與套件組組合成完整 URL,然後擷取該 URL:https://pkgs.tailscale.com/stable/ubuntu/dists/noble/InRelease。手動擷取該 URL 可以測試這個請求,但無法證明 apt 的請求也能成功。
先讀取 apt 錯誤,再進行任何變更
單獨執行更新,避免其他輸出將錯誤訊息往上捲走。
sudo apt update失敗的第三方 repository 會如下所示。您機器上的 codename 和 IP 位址會不同。
E: Failed to fetch https://pkgs.tailscale.com/stable/ubuntu/dists/wilma/InRelease 404 Not Found [IP: 203.0.113.9 443]
E: Some index files failed to download. They have been ignored, or old ones used instead.該輸出中的兩項資訊會決定下一步:status code,以及 E: Failed to fetch 行上的完整 URL。不要根據底部的摘要行猜測。複製 URL,直接向伺服器提出要求。
curl -sS -o /dev/null -w '%{http_code}\n' https://pkgs.tailscale.com/stable/ubuntu/dists/noble/InRelease這會針對 Tailscale 有發布的 codename 輸出 200。截至 October 2026 的檢查結果,noble 會回傳包含 Origin: Tailscale 和 Codename: noble 的已簽署索引。將 noble 替換成您自己錯誤訊息中的 codename,然後再次執行。如果 apt 取得抓取錯誤,而 curl 取得 200,表示 repository 已回應 curl 的要求,但這並不能證明 apt 設定錯誤:服務端或傳輸路徑上的 filtering 可能會根據 user agent 等標頭區分要求。200 只能證明下載成功;apt 下載後仍會檢查該索引的簽章。若 key 發生問題,檢查會在此處失敗,詳情請參閱下方的 keyring 區段。
狀態碼提供的資訊
404 Not Found表示伺服器找不到該路徑上的檔案,或不願透露該檔案是否存在。在pkgs.tailscale.com上,檔案不需憑證即可提供,因此該狀態碼幾乎總是表示 URL 中的代號無效。403 Forbidden表示已有某個元件回應,但拒絕了請求。單憑 403 無法判斷拒絕來源是 proxy、過濾設備、伺服器與 Tailscale 之間的 firewall,還是服務本身。例如,AWS 文件指出,CloudFront distribution 也可能從自身一側回傳 403,例如因為 firewall 規則或 origin server 的設定。407 Proxy Authentication Required表示 proxy 要求此請求提供驗證資訊:可能是 apt 未傳送 proxy credentials,也可能是傳送的 credentials 被 proxy 判定為無效或不完整。401 Unauthorized則不同:它是針對所要求資源本身提出的 credentials challenge,並會隨附WWW-Authenticateheader;單憑此狀態碼無法判斷請求經過 proxy。此 repository 提供的檔案不需 credentials,因此 401 通常表示該 URL 是由其他元件回應,例如攔截式 gateway。proxy 章節中的 debug command 會顯示 apt 實際連線到的 host。- connect error 或 name resolution error 表示完全沒有進行 HTTP 交談。請跳至 IPv6 章節。
URL 中的代號並不是 Tailscale 發布的代號
Tailscale 會為每個 Ubuntu 代號建立獨立目錄。若指定不存在的代號,伺服器上沒有可提供的 dists/<codename>,因此會收到 404。供應商在 pkgs.tailscale.com/stable 提供的清單會列出目前存在的代號。2026 年 10 月時,清單從 16.04 列到 stonking,也就是 Ubuntu 26.10;其下方緊接著是 resolute,也就是 Ubuntu 26.04。
錯誤代號通常是因為在以 Ubuntu 為基礎、但本身不是 Ubuntu 的發行版上執行了 lsb_release -cs。在 Linux Mint 22 上,該指令會輸出 wilma,這是 Mint 自己的代號,而 Tailscale 並未發布這個代號的套件。請改為讀取 Ubuntu 基礎版本。
. /etc/os-release
echo "$VERSION_CODENAME $UBUNTU_CODENAME"在 Ubuntu 上,兩個值相同。在衍生發行版上,VERSION_CODENAME 是衍生發行版的名稱,UBUNTU_CODENAME 是其建基於哪個 Ubuntu 版本。兩個 URL 都應使用 UBUNTU_CODENAME。
第二種情況是發行版升級。Ubuntu 升級工具執行時會停用第三方套件來源,因此在 將 Ubuntu 24.04 升級至 26.04 後,您會發現 /etc/apt/sources.list.d/tailscale.list 已被註解,或仍在現在已是 resolute 的系統上指定 noble。請重新執行兩個 curl 指令,並使用新的代號;這會覆寫兩個檔案。如果升級程序本身中途停止,導致 dpkg 回報套件尚未完成設定,而不只是這個套件庫發生問題,請先復原失敗的發行版升級,因為在 apt 無法完成設定的系統上,修正 tailscale.list 本身不會持續有效。
第三種情況是時機問題。如果在 Tailscale 加入新 Ubuntu 發行版的代號前安裝,會收到相同的 404。這段期間通常很短,甚至不存在:Tailscale 針對 Ubuntu 24.04 安裝支援的追蹤 issue 已於 2024 年 1 月標記為完成,遠早於該版本正式發布。針對 Ubuntu 26.10,在 2026 年 10 月 24 日檢查時,dists/stonking/InRelease 已回傳包含 Origin: Tailscale 與 Codename: stonking 的已簽署索引。因此,如果您稍早對 stonking 收到 404,請先重新下載,再考慮替代方案。如果確實處於這段期間,將檔案指向上一個 LTS 代號通常可以完成安裝,因為這些套件的相依性不多;但選取該套件庫本身不會選取特定 Ubuntu 發行版的建置版本:Tailscale 的 deb 建置目標是 amd64 與 arm64 等 Linux 架構。請使用 apt policy tailscale 檢查實際取得的內容,並在正式代號出現後將檔案改回去。
金鑰環是空的,而且寫入它的命令沒有輸出任何內容
這種情況通常沒有明顯訊息,也是這類問題最常見的結局。再次查看金鑰環命令:
curl -fsSL https://pkgs.tailscale.com/stable/ubuntu/noble.noarmor.gpg | sudo tee /usr/share/keyrings/tailscale-archive-keyring.gpg >/dev/nullShell 會先建立完整的管線,再執行其中的程式。因此,sudo tee 會先開啟金鑰環路徑,並立即將其截斷為 0 bytes。接著,如果 curl 失敗,且 -f 使其在任何 HTTP 錯誤時失敗,curl 就不會寫入任何內容,並以非零狀態結束。檔案會維持 0 bytes。管線的結束狀態取決於最後一個命令,也就是 tee;由於該命令成功,整個管線看起來也會成功。畫面沒有任何輸出,接著執行下一個命令,誤以為金鑰已安裝。
請檢查檔案,不要只檢查建立檔案的命令。
ls -l /usr/share/keyrings/tailscale-archive-keyring.gpg
gpg --show-keys /usr/share/keyrings/tailscale-archive-keyring.gpg正常的金鑰環會輸出一行 pub,以及一行列出 Tailscale 名稱的 uid。0 byte 檔案只會輸出 gpg: no valid OpenPGP data found.,沒有其他內容。若檔案寫入的是 HTML 錯誤頁面,結果也相同;對它執行 head -c 80 時,會顯示網頁開頭,而不是二進位金鑰資料。
若金鑰環不含可用的金鑰,sudo apt update 會下載索引,然後拒絕使用該索引。你會看到一行 W: GPG error,其中列出 Tailscale repository 與其套件組;接著會看到 The following signatures couldn't be verified because the public key is not available: NO_PUBKEY,後面帶有 16 字元的金鑰 ID;其下方則會顯示 repository 未簽署的錯誤。請注意 apt 提供的資訊:索引已成功下載,但無法驗證簽章。這是金鑰問題,不是網路問題。如果金鑰環檔案完全不存在,訊息又會不同,並透過 Could not open file /usr/share/keyrings/tailscale-archive-keyring.gpg 直接列出路徑。
分成兩個步驟寫入金鑰,這樣下載失敗就不會破壞原本可用的金鑰環。
curl -fsSL https://pkgs.tailscale.com/stable/ubuntu/noble.noarmor.gpg -o /tmp/tailscale.gpg
gpg --show-keys /tmp/tailscale.gpg
sudo install -m 0644 -o root -g root /tmp/tailscale.gpg /usr/share/keyrings/tailscale-archive-keyring.gpg中間那一行是判斷條件:如果沒有輸出 Tailscale uid,就停止,不要複製檔案。0644 模式很重要,因為 apt 會降權為無特權的 _apt 使用者來下載及驗證;只有 root 能讀取的金鑰環,apt 就無法使用。
.list 與 .sources 檔案描述同一個套件庫
Ubuntu 在 Ubuntu 24.04 LTS 將自身的套件來源移至 deb822 格式,其中 /etc/apt/sources.list 已變更為 /etc/apt/sources.list.d/ubuntu.sources。Tailscale 仍發布單行格式。2026 年 10 月檢查時,pkgs.tailscale.com 上對應的 .sources URL 回應 404。如果系統同時有描述同一個套件庫的 tailscale.sources 和 tailscale.list,apt 現在會將該套件庫描述兩次。
較輕微的情況是每次更新都出現警告:
W: Target Packages (main/binary-amd64/Packages) is configured multiple times in /etc/apt/sources.list.d/tailscale.list:1 and /etc/apt/sources.list.d/tailscale.sources:1較嚴重的情況發生在兩個檔案指定不同的 keyring 路徑時,因為 apt 無法判定應由哪個金鑰控制該套件庫。它會先輸出 E: Conflicting values set for option Signed-By regarding source,接著顯示套件庫及其套件組,再以 != 分隔兩個 keyring 路徑,最後拒絕繼續執行:
E: The list of sources could not be read.在其中一個檔案移除前,這會封鎖所有 apt 指令,而不只是更新。Ubuntu 自身的套件庫也會出現相同的錯誤;deb822 遷移後的重複 apt 來源錯誤則說明一般情況。
刪除任何檔案前,先找出所有提及 Tailscale 的檔案。
grep -RIn tailscale /etc/apt/sources.list /etc/apt/sources.list.d/保留其中一個檔案。若要停用另一個檔案但保留檔案內容,請重新命名:apt 只會讀取以 .list 或 .sources 結尾的檔案,因此會略過 tailscale.list.bak,檔案仍會留在磁碟上供參考。
正確撰寫 deb822 來源檔案
如果偏好較新的格式,請轉換現有檔案,不要重新輸入儲存庫位址,因為其中的拼字錯誤正是上述錯誤的常見起點。近期的 apt 版本提供轉換工具,可將 .list 檔案改寫為 deb822 段落,並將 signed-by 選項轉移為 Signed-By。
apt modernize-sources --help
sudo apt modernize-sourcesUbuntu 24.04 隨附的 apt 早於該子命令,因此查看說明列即可立即確認目前版本是否支援。若不支援,請根據磁碟上現有的來源列建立段落,讓基底位址取自供應商檔案,而不是依賴手動輸入。
. /etc/os-release
{
echo 'Types: deb'
echo "URIs: $(awk '/^deb /{print $3}' /etc/apt/sources.list.d/tailscale.list)"
echo "Suites: $UBUNTU_CODENAME"
echo 'Components: main'
echo 'Signed-By: /usr/share/keyrings/tailscale-archive-keyring.gpg'
} | sudo tee /etc/apt/sources.list.d/tailscale.sources
sudo rm /etc/apt/sources.list.d/tailscale.list該命令會輸出寫入的段落,因此你可以在執行下一個 apt update 前檢查各欄位。以下 4 個欄位值得詳細了解,因為它們各自會以不同方式失敗:
URIs僅能填寫儲存庫的基底位址。將dists/noble部分貼入其中會得到 404,因為 apt 會自行附加dists/<suite>,並要求dists/noble/dists/noble。Suites是代號,必須完全使用單行格式中間的值。Signed-By接受金鑰環檔案的絕對路徑。也可以在其下方直接內嵌 ASCII armored 金鑰;金鑰的每一行都必須縮排 1 個空格,而金鑰內的每個空白行都必須寫成單獨的句點。Enabled: no可停用來源而不刪除來源。這比重新命名更容易復原,也更方便向下一位維護人員說明。
第三方儲存庫請每個檔案保留 1 個段落。如果將多個段落放在同一檔案中,請在段落之間加入空白行。儲存庫索引已將 amd64 和 arm64 列為支援的架構,因此 ARM VPS 不需要額外的 Architectures 欄位。
中介代理回傳 403
403 表示請求遭到拒絕,但無法據此判斷拒絕的位置:伺服器與 Tailscale 之間的裝置,或服務端的篩選規則,都可能回傳這個狀態碼。先檢查 apt 自身的設定,因為其中設定的代理只會套用至 apt,不會套用至互動式 curl。
grep -RIn -i proxy /etc/apt/apt.conf.d/ /etc/apt/apt.conf
sudo apt-config dump | grep -i 'acquire::http'接著觀察 apt 實際送出的內容。
sudo apt -o Debug::Acquire::http=1 update這會顯示請求列、apt 傳送的標頭,以及 apt 連線使用的代理(如果有)。將結果與對相同 URL 執行的純 curl 比較。如果 curl 回傳 200,而 apt 回傳 403,也要比較請求標頭與代理設定;服務端或路徑中的篩選規則可能會依據 user agent 進行區分:
curl -sS -o /dev/null -w '%{http_code}\n' -A 'Debian APT-HTTP/1.3' https://pkgs.tailscale.com/stable/ubuntu/dists/noble/InRelease如果這個請求回傳 403,而預設的 curl 回傳 200,表示回應會依 user agent 而異,但此測試無法判斷篩選規則的位置。檢查網路上的篩選規則;如果這些規則無法解釋差異,請將不同的回應回報給 Tailscale。如果伺服器發出的每個請求都回傳 403,請從不同網路上的電腦執行相同的 curl:如果該處回傳 200,表示拒絕與用戶端或網路有關,但包括地理限制在內的服務端規則,也可能造成這種差異。也請檢查 Tailscale 的狀態頁面;兩個網路都回傳 403,仍不足以單獨判斷封鎖的位置。負責檢查 TLS 的企業代理又會有不同的行為:如果伺服器不信任該代理簽發憑證所使用的憑證授權單位,apt 會回報憑證驗證失敗。另一個常見來源是僅允許 Ubuntu mirrors 的雲端出口防火牆;此時應在防火牆上允許 pkgs.tailscale.com。
僅 IPv6 對外連線,以及不是狀態碼的錯誤
如果 apt 從未收到 HTTP 回應,請分別測試各通訊協定。
curl -4 -sS -o /dev/null -w 'v4 %{http_code}\n' https://pkgs.tailscale.com/stable/ubuntu/dists/noble/InRelease
curl -6 -sS -o /dev/null -w 'v6 %{http_code}\n' https://pkgs.tailscale.com/stable/ubuntu/dists/noble/InRelease當 IPv4 能收到回應,而 IPv6 一直等待或回報 Network is unreachable 時,表示 IPv6 測試失敗。但這本身無法說明 apt 為何失敗。APT 2.8 已會交替使用不同的位址家族,並在預設 250 毫秒後開始另一次連線嘗試。強制本次執行使用 IPv4,確認是否會改變 apt 的結果:
sudo apt -o Acquire::ForceIPv4=true update如果更新成功,請將設定永久化。
echo 'Acquire::ForceIPv4 "true";' | sudo tee /etc/apt/apt.conf.d/99force-ipv4也要確認相反的情況。在完全沒有 IPv4 位址的 VPS 上,強制使用 IPv4 不會解決問題,因為沒有 IPv4 路由可供網路流量使用。如果無法透過原生 IPv6 連線到套件庫,則需要供應商提供的 NAT64 搭配 DNS64,或使用具備 IPv4 位址的 proxy。若連線錯誤訊息列出 IPv6 位址,表示 IPv6 連線嘗試失敗;請使用 curl -6 那一行分別測試該路徑。
替代方案及其代價
廠商安裝腳本。 curl -fsSL https://tailscale.com/install.sh | sh 是 Tailscale 宣傳使用的命令。檢視此腳本可發現,它會從 /etc/os-release 判斷發行版,然後使用相同的 URL 寫入本指南一直在修正的兩個路徑:/usr/share/keyrings/tailscale-archive-keyring.gpg 與 /etc/apt/sources.list.d/tailscale.list。這會影響你的預期:如果 proxy 封鎖了某個 repository,腳本不會繞過該封鎖。它只會以較少的輸出,產生相同的失敗結果。以 root 將下載的腳本導入 shell 執行是一項取捨,不是解決方案,因為你必須信任伺服器當下傳回的內容,而且不會保留實際執行過的腳本副本。如果你接受這項取捨,至少應清楚了解其風險:
curl -fsSL https://tailscale.com/install.sh -o install.sh
less install.sh
sh install.sh靜態二進位檔。 同一台伺服器會在 pkgs.tailscale.com/stable 的 static binaries 區段發布一般 tarball。截至 3 November 2026,stable release 為 1.104.5,於 2 November 發布;64 bit x86 檔案為 tailscale_1.104.5_amd64.tgz。該頁面也提供舊版本連結。你必須自行放置 tailscale client 與 tailscaled daemon,也必須自行監督 daemon,因此沒有 apt upgrade 路徑;1.104.5 版本支援使用 sudo tailscale update,下載替換用的 tarball,以更新靜態安裝。這適合 air gapped host,或你必須固定使用某個確切版本的情況。
Ubuntu 自有的套件。 2026 年 10 月檢查時,archive 中沒有 tailscale deb,因此不使用 vendor repository 執行 sudo apt install tailscale,最後會得到 E: Unable to locate package tailscale。Canonical 確實提供可使用 sudo snap install tailscale 安裝的 snap;由於它來自 Snap Store,因此可避開上述所有 apt 錯誤。2026 年 11 月 3 日檢查時,其 1/stable channel 提供 1.102.3,早於 Tailscale 目前的 1.104.5;其項目頁面也說明,該 snap 由 Canonical 維護,不一定獲 upstream 開發者背書。它會依照 snapd 的排程更新;在 Ubuntu Server 控制 snap 更新 說明如何管理更新。如果你真正需要的是由自己控制的 coordination server,而不是 Tailscale 提供的 hosted server,這是另一項決定:以 Headscale 執行自己的 control server 會介紹相關作法,Tailscale 與一般 WireGuard 的比較 則會說明你是否需要這套機制。
套件已安裝,但 tailscaled 無法啟動
apt 正常運作後,問題會轉移到 daemon。
systemctl status tailscaled
sudo journalctl -u tailscaled -n 50在使用共用主機核心的容器虛擬化 VPS 上,例如 LXC 或 OpenVZ,如果日誌中缺少 /dev/net/tun,表示容器沒有可用的 TUN 裝置。daemon 需要 TUN 裝置來建立 tailscale0 介面,但該容器並未獲得這項裝置。請要求供應商在容器上啟用 TUN,或改用可取得專屬核心的 KVM 方案。在 KVM 上,guest 仍需要 tun 核心模組;如果模組尚未載入,Tailscale 的 Linux 文件說明可使用 sudo modprobe tun 載入。
完成後,sudo tailscale up 會輸出登入 URL,而 tailscale status 應列出一部位址位於 100.64.0.0/10 範圍內的機器。出現在清單中的機器即可作為後續建置的基礎,例如 從 VPS 宣告私有子網路,或 將 VPS 用作出口節點。
FAQ
為什麼 apt 顯示 Tailscale 儲存庫未簽署?
因為 apt 已下載儲存庫索引,但無法使用 /usr/share/keyrings/tailscale-archive-keyring.gpg 驗證其簽章。通常原因是 keyring 大小為 0 bytes:sudo tee 在 curl 尚未下載任何內容前就截斷了檔案,而管線因為 tee 成功而回報成功。執行 gpg --show-keys /usr/share/keyrings/tailscale-archive-keyring.gpg。正常的 keyring 會輸出一行 pub,以及一行列出 Tailscale 的 uid;空白或損毀的 keyring 則會輸出 gpg: no valid OpenPGP data found.。請先將金鑰下載到暫存檔並在該處檢查,再以模式 0644 複製到正確位置,讓 _apt 使用者可以讀取。
Tailscale URL 中應填入哪個 Ubuntu codename?
使用 /etc/os-release 中 UBUNTU_CODENAME 的值。在 Ubuntu 24.04 中,該值為 noble;Ubuntu 26.04 為 resolute;Ubuntu 26.10 為 stonking。如果是衍生自 Ubuntu 的發行版,不要使用 lsb_release -cs:在 Linux Mint 22 中,它會輸出 wilma,而 Tailscale 沒有以該名稱發布內容,因此 apt 會在 dists/wilma/InRelease 回報 404。編輯任何檔案前,先使用 curl -sS -o /dev/null -w '%{http_code}\n' 對 https://pkgs.tailscale.com/stable/ubuntu/dists/<codename>/InRelease 手動擷取索引,確認選擇正確。
將 Tailscale 安裝指令碼透過 shell 執行是否安全?
這是需要審慎決定的取捨。該指令碼來自 Tailscale,執行的工作與手動步驟相同:讀取 /etc/os-release、寫入相同的 keyring 與 /etc/apt/sources.list.d/tailscale.list,然後安裝套件。代價是你會以 root 權限執行伺服器當下回傳的所有內容,而且不會保留指令碼紀錄。請使用 -o install.sh 下載並閱讀指令碼,再視需要執行,這樣可取得便利性,同時避免無法檢視內容。若儲存庫遭到封鎖,它也無法解決問題,因為它使用的仍是先前失敗的相同 URL。
如何在不使用 apt 儲存庫的情況下於 Ubuntu 安裝 Tailscale?
有兩種方式。第一種是由 Canonical 維護的 snap,即 sudo snap install tailscale。截至 3 November 2026,該套件在 1/stable channel 的版本為 1.102.3,但不一定獲得 Tailscale 官方支援。第二種是發布於 pkgs.tailscale.com 的靜態 tarball。截至 3 November 2026,版本為 1.104.5,其中 amd64 檔案名稱為 tailscale_1.104.5_amd64.tgz。使用 tarball 時,必須自行安裝 tailscale 與 tailscaled 程式,並自行透過 systemd 執行 daemon。雖然沒有 apt 套件可用來取得新版本,但 1.104.5 支援靜態安裝的 sudo tailscale update。在 October 2026 檢查時,Ubuntu 的 archive 不包含自有的 tailscale deb,因此沒有廠商儲存庫的機器上,sudo apt install tailscale 會停留在 E: Unable to locate package tailscale。