Skip to content

文章:Synology 當 Subnet Router 與 Exit Node - #209

Merged
shyuan merged 2 commits into
mainfrom
synology-subnet-router-exit-node
Nov 9, 2026
Merged

shyuan merged 2 commits into
mainfrom
synology-subnet-router-exit-node

Conversation

@shyuan

@shyuan shyuan commented Nov 9, 2026

Copy link
Copy Markdown
Contributor

Closes #92

新增 /synology/subnet-router-exit-node-on-synology/(src/content/docs/synology/subnet-router-exit-node-on-synology.mdx),內容依 #92 的大綱與原始碼核對整理:

  • 前提:說明 Synology 套件中心(Package Center)內建套件已不再維護,應從 pkgs.tailscale.com 手動安裝 .spk 並排程 tailscale update --yes,以及開啟 SSH
  • 設定方式:透過 SSH 執行 tailscale set --advertise-routes/--advertise-exit-node(與 :5252 網頁管理介面),以及在 Admin console 核准路由、關閉金鑰到期(避免 Exit Node 金鑰到期觸發 fail close 斷網)與自訂 grants 注意事項
  • 釐清 DSM 7 的 userspace(netstack)模式、TUN 與 IP forwarding:
    • cmd/tailscaled/tailscaled.go 的 handleSubnetsInNetstack() 在 Synology 上固定回傳 true、且 NetfilterMode 固定為 off,因此子網與 Exit Node 一律由 gVisor netstack 在第四層轉送,不需要設定 net.ipv4.ip_forward = 1
    • 對照跑與不跑 configure-host 的差異:不跑 configure-host 也能轉送 Subnet Router 與 Exit Node 的 TCP/UDP 流量;跑 configure-host 則是為了讓 NAS 本機服務能主動連出(建立 tailscale0 TUN)以及賦予 tailscaled 執行檔 cap_net_raw 讓代跑 /bin/ping(wgengine/netstack/netstack_userping.go)能運作,同時提醒啟用 TUN 後若有開 DSM 防火牆需放行 100.64.0.0/10
  • 重開機與升級後的設定保存:--advertise-routes/--advertise-exit-node 存在 tailscaled.state 會自動保留;configure-host 則需設為開機觸發的排程任務並在升級套件後重跑
  • Synology 特有限制與效能影響:不支援 --accept-routes 與 --exit-node、固定由 netstack 做 SNAT(因此同一台兼任 Subnet Router 與 Exit Node 不會踩到關閉 SNAT 的掉包問題)、僅支援 TCP/UDP,以及 NAS CPU 等級與 UDP GRO forwarding/BBR 在 netstack 模式下的適用性

另外:

  • synology/index.mdx 的文章清單加入本文
  • 〈DSM 7 讓 NAS 上的其他服務也能連出去:TUN 與 configure-host〉、〈Subnet Router〉與〈Exit Node〉連到本文

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

新增 /synology/subnet-router-exit-node-on-synology/,並從 Synology 分類首頁、〈DSM 7 讓 NAS 上的其他服務也能連出去〉、〈Subnet Router〉與〈Exit Node〉連到本文。

Closes #92
@shyuan

shyuan commented Nov 9, 2026

Copy link
Copy Markdown
Contributor Author

審查結果:Synology 當 Subnet Router 與 Exit Node

逐一核對了新文章對 Tailscale 原始碼與官方文件的技術宣稱(對照文章自稱的基準版本 v1.104.0),大部分都經得起驗證,但有一個實質的技術錯誤和一個引用位置錯誤,建議合併前修正。

問題 1(應修正):tailscale set --accept-routes 在 Synology 上並不會被 CLI 拒絕

src/content/docs/synology/subnet-router-exit-node-on-synology.mdx(Section 5)宣稱:

在 Synology 上執行 tailscale set --accept-routes 或 tailscale set --exit-node=<IP>,CLI 會直接拒絕

--accept-routes is not supported on Synology; see https://github.com/tailscale/tailscale/issues/1995

對照 v1.104.0 原始碼,這段對 tailscale set 的描述不準確:

  • 引用的錯誤訊息只存在於 cmd/tailscale/cli/up.go 的 runUp()——印出這則訊息的是 tailscale up,不是 tailscale set。
  • tailscale set --exit-node=<IP> 在 Synology 上確實會被拒絕,但路徑是後端:set.go 呼叫 localClient.CheckPrefs → ipnlocal.checkExitNodePrefsLocked → featureknob.CanUseExitNode(),訊息是 Tailscale exit nodes cannot be used on synology,與引文不同。
  • tailscale set --accept-routes 則找不到任何拒絕路徑:set.go 沒有任何 Synology 檢查,checkPrefsLocked 也不驗證 RouteAll。它很可能被靜默接受、只是不生效(官方文件的講法是能力限制:"can do --advertise-routes but not --accept-routes",不是 CLI 報錯)。

實際影響:讀者在 NAS 上照文章跑 tailscale set --accept-routes,不會看到文章預告的錯誤訊息,可能誤以為設定成功、或反過來懷疑文件。文章明說「未在實機驗證」,這正好是無法靠原始碼推得的行為差異點。

建議改寫:tailscale up 帶這些旗標會被拒絕並出現該訊息;tailscale set --exit-node 會被後端以不同訊息拒絕;--accept-routes 則是「不支援、不生效」而非「CLI 直接拒絕」。結論方向(只能廣告、不能接收)本身是對的,問題只在機制與引文的描述。

問題 2(輕微):NetfilterMode = off 的強制位置引用錯了檔案

Section 3 把兩件事都歸給 cmd/tailscaled/tailscaled.go:

  • handleSubnetsInNetstack() 在 distro.Synology 回傳 true —— ✓ 正確,已驗證。
  • 但「NetfilterMode 強制設為 off」實際發生在 ipn/ipnlocal/local.go 的 router 設定("Issue 1995: we don't use iptables on Synology"),CLI 端的預設值則在 cmd/tailscale/cli/up.go 的 defaultNetfilterMode()。

這篇文章的賣點是原始碼可核對,參考資料還直接連到 tailscaled.go,建議把這半句的出處修正或拆開標註。

已驗證正確的部分(抽樣核對過原始碼/官方文件)

  • handleSubnetsInNetstack() 在 Synology 固定回傳 true(tailscaled.go)✓
  • /bin/ping -c 1 -W 3 代跑、cap_net_raw ambient caps、同時最多 20 個 ping(netstack_userping.go、netstack.go 的 userPingSem = NewSemaphore(20))✓
  • netstack 固定 CUBIC(netstack.go cubicOpt)✓
  • CheckIPForwarding()/CheckUDPGROForwarding() 在 IsNetstackRouter() 時直接略過(local.go)✓
  • netstack 必做 SNAT、--snat-subnet-routes=false 無效(tailscaled.go 註解明言 netstack "must rewrite the source address")✓
  • Web client 埠 :5252(tsconst/webclient.go WebListenPort = 5252)✓
  • DSM 6 → 7 的 state 路徑遷移(trySynologyMigration 的 oldPath /var/packages/Tailscale/etc/tailscaled.state)✓
  • tailscale set --advertise-exit-node 後要跑 tailscale up:與官方 exit nodes 文件一字不差,也和站上 features/exit-node.mdx 既有說法一致 ✓
  • 金鑰 180 天到期、Exit Node fail close、tag 停用金鑰到期:與官方文件及站內既有文章一致 ✓
  • 前提一節(套件中心版不再維護、手動裝 SPK、排程 tailscale update --yes、configure-host 開機任務與 synosystemctl restart、防火牆放行 100.64.0.0/255.192.0.0):全部與官方 Synology 文件相符 ✓

結構與慣例

全部符合:frontmatter 形狀與 sidebar.order: 5.8(介於 5.5 與 6 之間)、版本註記 blockquote、synology/index.mdx 清單更新且順序與 sidebar 一致、內部連結根相對路徑加尾斜線、三個錨點(#存取規則acl--grants、#自訂-acl-時要注意、#用-task-scheduler-讓它在開機時執行)都對應到實際標題、〈〉書名號連結是站內既有慣例。

結論:問題 1 建議在合併前修正(讀者會拿實機輸出對照這段宣稱);問題 2 順手改掉即可。其餘內容品質很高,可核對的宣稱幾乎全部通過驗證。

@shyuan
shyuan merged commit 3f5a23a into main Nov 9, 2026
2 checks passed
@shyuan
shyuan deleted the synology-subnet-router-exit-node branch November 9, 2026 05:53
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.

Synology 當 Subnet Router 與 Exit Node

1 participant