Skip to content

在 PVE 主機上安裝 Tailscale:遠端管理與 Subnet Router

把 Tailscale 直接裝在 Proxmox VE 主機(Debian)上,從外面連回 8006 管理介面與 SSH,並把 VM/LXC 所在的網段分享給 tailnet。說明裝在主機與裝在 LXC/VM 的取捨、PVE 9 的 IP forwarding、Serve 與憑證、存取規則、叢集與 MagicDNS 對容器的影響

最後更新 View as Markdown

在 LXC 中使用 Tailscale 講的是把 Tailscale 裝在容器裡;這篇講另一種做法:直接裝在 PVE 主機本身。主機上的 Tailscale 有兩個用途——人在外面也能連回 :8006 管理介面和 SSH,以及當 Subnet Router,把 VM、LXC 所在的網段分享給整個 tailnet。

本文以 Tailscale v1.104 與 Proxmox VE 9(Debian 13 trixie)為準(2026 年 10 月),依 Tailscale 與 Proxmox 官方文件整理,未實際驗證。PVE 8(Debian 12 bookworm)的做法大致相同,差異處會另外註明。

裝在主機,還是裝在 LXC/VM

三種位置都能用,差別在「依賴什麼」和「動到什麼」:

位置 優點 缺點
PVE 主機 不依賴任何 guest;VM、LXC 全掛了也連得回管理介面;主機本來就接著每個 vmbr 動到 hypervisor 本身;主機的 MagicDNS 設定會被複製進 LXC(見後文);大版本升級要顧好套件庫
LXC 容器 跟主機隔離;可以快照、備份、隨時重建;資源很省 容器沒開就連不回來;無特權容器要先放行 /dev/net/tun
VM 隔離最完整,跟一般 Linux 主機完全一樣 最吃資源;同樣是 VM 沒開就連不回來

建議的分法:

  • 遠端管理(:8006、SSH)放在主機上。管理通道就是要在出事時還能用,不該依賴某台 guest 有沒有開機。
  • Subnet Router 主機或 LXC 都可以。已經在主機上裝了 Tailscale,順便廣告網段最省事;想讓 hypervisor 盡量乾淨,就交給一台專門的 LXC。
  • 個別服務(Jellyfin、Home Assistant…)仍然建議在各自的 guest 裡裝 Tailscale,而不是全部經由主機的 Subnet Router 轉送:直接安裝的效能、存取控制粒度都比較好。

Tailscale 官方的 Proxmox 文件把 VM 和 LXC 視為一般的 Linux 主機,主機上的用法則只談憑證與 Serve(見後文),並沒有說哪種位置是建議做法。

1. 在主機上安裝

PVE 主機預設沒有 sudo,以下指令都以 root 執行(網頁介面的 Shell,或 SSH 登入 root)。

最簡單的方式是官方安裝腳本,會自動偵測 Debian 版本並加入套件庫:

curl -fsSL https://tailscale.com/install.sh | sh

想自己加套件庫的話,PVE 9 是 Debian 13 trixie(PVE 8 換成 bookworm):

curl -fsSL https://pkgs.tailscale.com/stable/debian/trixie.noarmor.gpg \
  -o /usr/share/keyrings/tailscale-archive-keyring.gpg
curl -fsSL https://pkgs.tailscale.com/stable/debian/trixie.tailscale-keyring.list \
  -o /etc/apt/sources.list.d/tailscale.list
apt update && apt install tailscale

接著登入。主機屬於伺服器,建議用 tag 登入,tag 裝置預設不會金鑰過期(見 Tags 與 auth key);同時先關掉主機的 MagicDNS,原因在後文:

tailscale up --advertise-tags=tag:pve --accept-dns=false

tailscale up 印出的網址用瀏覽器開啟、登入授權。tag:pve 要先在 policy 的 tagOwners 定義好(見存取規則),否則會被拒絕。

2. 遠端存取管理介面

裝好後最直接的用法:用 MagicDNS 名稱或 Tailscale IP 連 8006。

https://pve.tailxxxxx.ts.net:8006

pveproxy 預設聽所有介面,tailscale0 也包含在內,不需要另外設定。但 PVE 預設用的是自簽憑證,瀏覽器會跳警告。要換成有效的憑證,有兩種做法,擇一即可:

做法一:Tailscale Serve(建議)

讓 Tailscale Serve 在 443 提供 HTTPS,再轉給本機的 8006。憑證由 tailscaled 自動取得、自動續期,網址也不用帶連接埠:

tailscale serve --bg https+insecure://localhost:8006
  • https+insecure://:PVE 後端是自簽憑證,Serve 轉給它時不驗證憑證。這段連線只在主機內部的 loopback 上,不會出主機。
  • --bg:讓設定在背景常駐,重開機後自動恢復。
  • 之後用 https://pve.tailxxxxx.ts.net/ 開啟管理介面。

前提是 tailnet 已啟用 MagicDNS 與 HTTPS 憑證,第一次執行時 CLI 會提示你到 Admin console 開啟。noVNC 與 xterm.js 主控台走 WebSocket,經過 Serve 沒問題;SPICE 主控台用的是另一個埠(3128),不在這個 Serve 設定的範圍內。Serve 的完整用法見 Tailscale Serve。

做法二:把憑證裝進 PVE

用 tailscale cert 取得憑證、pvenode cert set 裝進 PVE,連線仍然是 :8006。憑證 90 天到期,要排程定期更新,完整腳本見〈憑證自動更新〉。

兩種做法比較:

  • Serve 不用寫腳本、不用排程,但多一層代理;PVE 看到的來源 IP 會是 127.0.0.1。
  • 裝進 PVE 的話,用 LAN IP 直接連 8006 時也會出示這張憑證(只是名稱對不上 IP,瀏覽器仍會警告)。

兩種做法的憑證都會讓這台主機的 MagicDNS 名稱出現在公開的憑證透明度日誌上,見 HTTPS 憑證。

開了 PVE 防火牆時

如果在 Datacenter 層級開了 PVE 防火牆,主機的 input 預設是 DROP,8006 與 22 只放行給 management 這個 IPSet(預設是本機的叢集網段)。從 tailnet 用 100.x.y.z 直接連 8006 會被擋下,這時有兩個選擇:

  • 改用 Serve。Serve 從 loopback 轉給 8006,不受這條限制;tailnet 上只需要放行 443——這也是由 Tailscale 端的 grants 控管,而不是 PVE 防火牆。
  • 在 PVE 防火牆加一條規則,允許 100.64.0.0/10(或指定介面 tailscale0)連 8006、22。

3. 當 Subnet Router

開啟 IP forwarding

Debian 13 起,systemd-sysctl 不再讀 /etc/sysctl.conf,舊文章「把 /etc/sysctl.conf 裡的 net.ipv4.ip_forward 取消註解」的做法在 PVE 9 上重開機後就不會生效。一律寫到 /etc/sysctl.d/:

echo 'net.ipv4.ip_forward = 1' | tee -a /etc/sysctl.d/99-tailscale.conf
sysctl -p /etc/sysctl.d/99-tailscale.conf

如果主機原本就有 NAT 用的內部 bridge(/etc/network/interfaces 裡有 post-up echo 1 > /proc/sys/net/ipv4/ip_forward),forwarding 其實已經開著,寫進 sysctl.d 只是讓它不依賴那一行。用 sysctl net.ipv4.ip_forward 確認。開啟 IPv4 forwarding 不影響 VM、LXC 經 bridge 的二層流量。

IPv6 要小心:Tailscale 官方的 Subnet Router 文件會一起開 net.ipv6.conf.all.forwarding = 1。Linux 開了 IPv6 forwarding 後,預設就不再接受 Router Advertisement;如果 PVE 主機的 IPv6 位址或預設路由是靠 SLAAC 取得的,開下去主機就會失去 IPv6 連線。只廣告 IPv4 網段時不必開;確定要開,先在同一個檔案加上對 bridge 的例外:

net.ipv6.conf.all.forwarding = 1
net.ipv6.conf.vmbr0.accept_ra = 2

廣告網段

PVE 常見的網路配置有兩種,廣告的網段不一樣:

  • VM、LXC 直接接在 vmbr0(跟主機、家裡其他設備同一個 LAN,例如 192.168.1.0/24):廣告這個 LAN 網段,guest 和 LAN 上其他設備就一起涵蓋了。
  • 另外有一個只在主機內部的 bridge(例如 vmbr1,10.10.10.0/24,主機是 10.10.10.1、對外做 NAT):這個網段 LAN 上其他設備看不到,要另外廣告,tailnet 才連得進去。PVE SDN 的 Simple zone 也是同樣的情況。
tailscale set --advertise-routes=192.168.1.0/24,10.10.10.0/24

主機必須在要廣告的網段裡有一個 IP(介面)才能轉送。只把 VLAN 標籤帶給 guest、主機本身在該 VLAN 上沒有 IP 的情況(VLAN-aware bridge 常見),主機轉送不到那個網段;要嘛在主機上加一個該 VLAN 的介面(例如 vmbr0.20)並設 IP,要嘛改由那個 VLAN 裡的 guest 當 Subnet Router。

核准路由

到 Admin console 的 Machines 頁面,找到這台主機,在 Subnets 區點 Edit,勾選網段後儲存。要省掉這一步,就在 policy 用 autoApprovers 讓 tag:pve 廣告的網段自動核准(範例見下一節)。核准、SNAT、用戶端 --accept-routes 等細節見 Subnet Router。

PVE 主機本身不要開 --accept-routes(Linux 預設就是關的)。如果 tailnet 裡有另一台 Subnet Router 也廣告了 192.168.1.0/24,主機接受之後可能把往自己 LAN 的流量繞進 tailnet,連帶影響叢集與 guest 的連線。

4. 存取規則:只開 8006 與 SSH

PVE 主機是整個 homelab 的鑰匙,存取規則應該收到最小:只有管理員能連,而且只開需要的埠。

{
  "groups": {
    "group:pve-admins": ["alice@example.com"]
  },
  "tagOwners": {
    "tag:pve": ["autogroup:admin"]
  },
  "grants": [
    {
      "src": ["group:pve-admins"],
      "dst": ["tag:pve"],
      "ip": ["tcp:443", "tcp:8006", "tcp:22"]
    },
    {
      "src": ["group:pve-admins"],
      "dst": ["10.10.10.0/24"],
      "ip": ["*"]
    }
  ],
  "autoApprovers": {
    "routes": {
      "192.168.1.0/24": ["tag:pve"],
      "10.10.10.0/24": ["tag:pve"]
    }
  }
}
  • 第一條讓管理員連主機的 Serve(443)、pveproxy(8006)與 SSH(22)。只用 Serve 的話可以拿掉 tcp:8006;只用 8006 的話拿掉 tcp:443。
  • 第二條放行內部網段。grants 的 dst 比對的是最終的目的 IP,PVE 主機只要在網段裡有位址,放行整個網段就會連主機那個位址的所有埠一起放開,繞過第一條的埠限制。
    • 範例刻意沒有放行整個 192.168.1.0/24,因為主機的 LAN IP 也在裡面。要開 LAN 網段時,只放行實際需要的主機與埠。
    • 10.10.10.0/24 同樣包含主機自己的 10.10.10.1。範例為了簡潔直接用 *,被放行的 group:pve-admins 因此也能經由 10.10.10.1 連到主機的所有埠;想守住第一條的埠限制,就把 ip 收斂到 guest 實際需要的埠,或把 dst 改成個別 guest 的 IP。
  • autoApprovers 只負責「路由要不要核准」,存取權限仍然由 grants 決定。

想用 Tailscale SSH 取代 OpenSSH,可以 tailscale set --ssh 再加 ssh 規則,見 Tailscale SSH;建議保留 OpenSSH 當 Tailscale 出問題時的備援。grants 的寫法見 ACL / Grants 入門。

5. MagicDNS 會被複製進 LXC

這是在 PVE 主機上裝 Tailscale 最常踩到的坑,官方的 Proxmox 疑難排解文件專門提到。

PVE 會把主機的 DNS 設定寫進每個 LXC 容器的 /etc/resolv.conf。主機開著 MagicDNS 時,容器拿到的是:

# --- BEGIN PVE ---
nameserver 100.100.100.100
search example.ts.net
# --- END PVE ---

100.100.100.100 是 Tailscale 的內建 DNS,只有裝了 Tailscale 的機器才連得到。容器裡沒有 Tailscale 時,DNS 查詢就會逾時。兩種解法:

  • 主機不使用 MagicDNS:tailscale set --accept-dns=false(第 1 節登入時已經關掉了)。代價是主機上的指令不能用 MagicDNS 名稱(包括完整的 *.ts.net 名稱)連其他 tailnet 裝置,只能用 Tailscale IP——對管理用的主機通常無所謂。
  • 保留主機的 MagicDNS,在每個容器裡建立空檔案 /etc/.pve-ignore.resolv.conf,讓 PVE 不再覆寫該容器的 /etc/resolv.conf。

6. 叢集與日常維護

多台主機的叢集

  • 每台節點各自安裝、各自登入,用同一個 tag:pve,上面的 grants 就一次涵蓋整個叢集。
  • 任何一台節點的 8006 都能管理整個叢集,但節點離線時就連不到它的管理介面,所以每台都裝比只裝一台可靠。每台也各自設定 Serve。
  • corosync 與遷移流量不要走 Tailscale。Proxmox 要求 corosync 網路的延遲在數毫秒以內,跨地點經由 tailnet 組叢集不在支援範圍;Tailscale 只用來從外面連進來管理。
  • 想讓 Subnet Router 有備援,可以讓兩台節點廣告完全相同的網段,Tailscale 會自動容錯切換,見 Subnet Router 的高可用性段落。

更新、重開機之後

Tailscale 是 userspace 程式加上核心內建的 TUN,PVE 更新核心不需要重新編譯任何模組。重開機或升級後,確認這幾件事:

systemctl is-enabled tailscaled   # 應為 enabled
tailscale status                   # 主機在線、看得到其他裝置
sysctl net.ipv4.ip_forward         # Subnet Router 要是 1
tailscale serve status             # 有用 Serve 的話,設定還在

PVE 大版本升級(例如 8 → 9)會把 Debian 從 bookworm 換成 trixie。Tailscale 的套件庫設定(/etc/apt/sources.list.d/tailscale.list)也要一起改代號,否則會一直停在舊版的套件。升級前用 Tailscale 以外的方式(LAN、IPMI 或主機的實體主控台)確保連得回去,不要在只靠 tailnet 連線的情況下升級主機。

7. 效能調校

主機當 Subnet Router 時,效能調校的兩篇文章都適用,但要注意 PVE 的網路結構:

  • UDP GRO forwarding:官方建議的指令會對「預設路由那張網卡」設定。在 PVE 上預設路由走的通常是 bridge vmbr0,而不是實體網卡(例如 eno1)。設定前用 ethtool -k 分別看 vmbr0 和實體網卡支不支援 rx-udp-gro-forwarding,並以 tailscale set --advertise-routes=... 重跑後還會不會出現警告為準。
  • BBR:只影響主機自己發起或終止的 TCP 連線,例如經由 Serve 連管理介面、從主機上傳備份;對轉送到 guest 的流量沒有作用。改的是主機的全域 sysctl,會連帶影響主機上的其他連線,例如 PBS 備份、遷移。

參考資料

Navigation

Type to search…

↑↓ navigate↵ selectEsc close