Skip to content

文章:在 PVE 主機上安裝 Tailscale:遠端管理與 Subnet Router - #207

Merged
shyuan merged 2 commits into
mainfrom
claude/relaxed-dirac-xp1ubi
Oct 30, 2026
Merged

shyuan merged 2 commits into
mainfrom
claude/relaxed-dirac-xp1ubi

Conversation

@shyuan

@shyuan shyuan commented Oct 30, 2026

Copy link
Copy Markdown
Contributor

Closes #90

新增 /pve/tailscale-on-pve-host/(src/content/docs/pve/tailscale-on-pve-host.mdx),內容依 #90 的大綱:

  • 裝在主機、LXC 或 VM 各自的取捨(遠端管理建議放主機)
  • 安裝方式:PVE 預設沒有 sudo、Debian 13 trixie 套件庫、用 tag:pve 加 --accept-dns=false 登入
  • 遠端管理介面:直接連 :8006、Tailscale Serve(https+insecure://localhost:8006)或把憑證裝進 PVE(連到〈憑證自動更新〉),以及 PVE 防火牆的 management IPSet 會擋 tailnet 直連 8006
  • Subnet Router:Debian 13 不再讀 /etc/sysctl.conf;開 IPv6 forwarding 後不再接受 RA(accept_ra = 2);vmbr0 與內部 NAT bridge、VLAN 的差別;主機不要開 --accept-routes
  • 最小權限的 grants 與 autoApprovers 範例(說明為什麼不放行整個 LAN 網段)
  • 官方疑難排解文件提到的 MagicDNS 被寫進 LXC resolv.conf 的問題
  • 叢集(corosync 不走 Tailscale、Subnet Router HA)、更新與大版本升級後的檢查
  • 跟 UDP GRO forwarding、BBR 的關係(PVE 的預設路由網卡是 vmbr0)

版本註記寫明「依官方文件整理,未實際驗證」。

另外:

  • pve/index.mdx 的文章清單加入本文
  • 〈在 LXC 中使用 Tailscale〉與〈Subnet Router〉的「延伸」段落連到本文

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


Generated by Claude Code

新增 /pve/tailscale-on-pve-host/,並從 PVE 分類首頁、〈在 LXC 中使用 Tailscale〉與〈Subnet Router〉連到本文。

Closes #90

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01YTJryyynRapUSda7ec9k5a

@shyuan shyuan left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

人工核驗過一輪:技術內容對照官方文件逐條檢查,本地也重新跑了 lint:docs(96 檔全部通過)。

已核驗,與官方文件一致

  • Serve 指令:tailscale serve --bg https+insecure://localhost:8006 與 Tailscale 官方 Proxmox 整合頁相同;VNC/xterm.js console 走 WebSocket、SPICE 在 3128 的說明也正確
  • MagicDNS 寫進 LXC resolv.conf:問題描述、# --- BEGIN PVE --- 範例塊、兩種解法(--accept-dns=false、/etc/.pve-ignore.resolv.conf)都與 官方 Troubleshooting Proxmox 一致
  • grants 範例語法:tagOwners 用 autogroup:admin、CIDR 當 dst、ip: ["tcp:443", "tcp:8006", "tcp:22"] 與 * 都符合官方 grants syntax 文件
  • PVE 防火牆:Datacenter 層級啟用後 input 預設 DROP、8006/22 只放行 management IPSet(預設含叢集網段)、從 tailnet 直連 100.x.y.z 會被擋、Serve 走 loopback 不受限——與 Proxmox wiki 的 default rules 一致
  • Debian 13 不再讀 /etc/sysctl.conf:與 trixie release notes 逐字相符;IPv6 forwarding 後不再收 RA、accept_ra = 2 例外寫法正確
  • 兩個文內錨點(#4-存取規則只開-8006-與-ssh、#5-magicdns-會被複製進-lxc)與 Nimbus 產生的 heading slug 相符

一個小的非阻擋建議:grants 範例前後不一致

第 4 節第二條 grant 是 dst: ["10.10.10.0/24"]、ip: ["*"]。按第 3 節自己的描述,主機在 vmbr1 上是 10.10.10.1,而 dst 匹配的是最終目的 IP,所以這條 grant 同樣涵蓋主機本身在該位址上的所有埠——跟下一顆 bullet 解釋「為什麼不放行整個 192.168.1.0/24」的理由一模一樣。

消化上它的影響有限:dst 仍限制在 group:pve-admins,這群人本來就已有大部分存取權,所以是文件內部一致性問題、不是漏洞。兩個小改法:

  1. 在 grant 旁加一句註記(例如「注意 10.10.10.0/24 也包含主機自己的 10.10.10.1,一樣會放開該位址上的所有埠」);或
  2. 照原意收斂成具體埠過的 grant。

順帶一提,同顆 bullet 的「任何人都能從 LAN IP 連到主機的所有埠」稍微過頭——照這份 policy 只有被 grant 該 CIDR 的人(pve-admins)走得進去,想表達的重點是埠限制被繞過,措辭可以更精確。

其他

版本註記、sidebar.order/label、pve/index.mdx 清單、trailing slash 的 root-relative links、版本號章節標題都符合慣例;order: 1 沒問題(section index 在這個主題下不會被排進自己 group 的頁面清單,不會跟新文章撞順序)。

沒有阻擋問題,合併前請作者考慮要不要補上面那一句註記。

依 review 建議,說明 10.10.10.0/24 包含主機的 10.10.10.1,並把「任何人」改為被放行的對象。

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01YTJryyynRapUSda7ec9k5a

shyuan commented Oct 30, 2026

Copy link
Copy Markdown
Contributor Author

謝謝核驗。grants 的建議已在 d7191f0 處理:

  • 說明 dst 比對的是最終目的 IP,所以只要主機在網段裡有位址,放行整個網段就會一起放開主機那個位址的所有埠。
  • 補上 10.10.10.0/24 也包含主機的 10.10.10.1,並寫出兩種收斂方式:把 ip 限縮到 guest 需要的埠,或把 dst 改成個別 guest 的 IP。
  • 「任何人」改為被放行的 group:pve-admins,重點放在「繞過埠限制」。

Generated by Claude Code

@shyuan
shyuan merged commit fafcd4f into main Oct 30, 2026
2 checks passed
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.

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

2 participants