Tailscale serve 與 funnel 怎麼選?
Tailscale serve 僅讓 tailnet 存取 HTTPS URL,funnel 則公開至網際網路。了解兩者差異,以及 policy file 中缺少 node attribute 時阻擋 funnel 的設定限制。
tailscale serve 與 funnel:誰可以存取該 URL
tailscale serve 與 tailscale funnel 的差異在於存取對象,其他方面完全相同。serve 會在本機連接埠前端提供 HTTPS(hypertext transfer protocol secure),但只會將服務發布給你的 tailnet。funnel 則會透過 Tailscale 維運的 relay servers,將同一個本機連接埠發布到整個公開網際網路。這兩個命令使用相同的 flags 與 targets。一個詞的差異,就能決定儀表板只供私人存取,或讓全世界都能連線。
兩者都會在以 ts.net 結尾的名稱上提供瀏覽器已信任的憑證,且都不需要在 VPS 防火牆開放入站連接埠。你的 tailscaled daemon 已建立通往 tailnet 的連線,因此流量會透過該連線抵達。將伺服器加入 tailnet 是另一項工作;將 VPS 設為 Tailscale exit node 或 為私人網路發布 subnet router 都涵蓋這部分。發布已位於 tailnet 上的服務,則是本節的工作。
使用任一指令前的必要條件
- VPS 上必須安裝 Tailscale 1.52 或更新版本,並登入您的 tailnet。Funnel 本身從 1.38.3 起便已提供,但 serve 與 funnel 指令在 1.52 變更過,本頁所有指令都使用較新的語法。使用
tailscale version和tailscale status檢查。 - 必須啟用 MagicDNS。MagicDNS 是 Tailscale 內建的 DNS(網域名稱系統),可讓機器取得類似
blog-vps.your-tailnet.ts.net的名稱,而不只使用100.x位址。 - 必須在管理主控台的 DNS 頁面中,為 tailnet 啟用 HTTPS 憑證。未啟用時,便沒有憑證可用來放在您的連接埠前方。
- 僅使用
funnel時,tailnet 政策檔案中必須具備funnel節點屬性。多數人第一次嘗試都會在這裡停住,詳情如下。
本頁的每個指令都以 sudo 開頭,因為 tailscaled 通常以 root 身分執行,預設只有 root 可以管理它。將一名使用者設為 operator,即可授予該使用者略過此限制的權限:
sudo tailscale set --operator=$USER使用 tailscale serve 發布到 tailnet
將 serve 指向本機連接埠,其餘工作會自動完成。
sudo tailscale serve 3000Available within your tailnet:
https://amelie-workstation.pango-lin.ts.net
|-- / proxy http://127.0.0.1:3000
Press Ctrl+C to exit.單獨使用 3000 是 http://127.0.0.1:3000 的簡寫。Tailscale 會在該機器的 tailnet 位址上監聽 443 連接埠,使用 ts.net 憑證終止 TLS(傳輸層安全性),再將純 HTTP 轉送到本機連接埠。您的應用程式完全不需要知道憑證存在。這也是在管理介面前使用此功能的主要原因,否則該介面只能以純 HTTP 提供服務。僅繫結至 127.0.0.1 的 Web UI 是明顯的適用對象。3080 連接埠上的 dsh Web UI 就是很好的例子:不必每次需要使用時都開啟 SSH tunnel,只要將 serve 一次指向 3080,就能從 tailnet 上的任何裝置存取。
現在查看最後一行:Press Ctrl+C to exit. 此命令會在前景執行,對應設定也只存在於該程序中。關閉終端機後,URL 就會停止運作,因為沒有任何設定寫入磁碟。加入 --bg 後,對應設定會寫入該節點的 serve 設定中,因此即使關閉終端機或重新開機,設定仍會保留。
sudo tailscale serve --bg 3000Serve 不只接受連接埠號碼。--set-path 會將服務掛載到子路徑,因此多個應用程式可以共用同一個主機名稱:
sudo tailscale serve --bg --set-path=/grafana 3000
sudo tailscale serve --bg --set-path=/metrics 9090目標也可以是靜態檔案目錄,或是已使用 TLS 的後端服務,而該服務使用的憑證不需要驗證:
sudo tailscale serve --bg /srv/reports
sudo tailscale serve --bg https+insecure://localhost:8443它也不限於 HTTP。--tcp=<port> 會轉送原始 TCP(傳輸控制協定)串流;--tls-terminated-tcp=<port> 則會在節點上終止 TLS,再轉送純文字內容,讓不支援 HTTP 的服務也能使用受信任的憑證:
sudo tailscale serve --bg --tls-terminated-tcp=443 tcp://127.0.0.1:9899為什麼 Funnel 顯示未設定節點屬性?
Funnel 預設會對整個 tailnet 停用。第一次執行時會顯示以下訊息,然後停止:
Funnel not available; "funnel" node attribute not set. See https://tailscale.com/s/no-funnel.命令本身沒有問題。tailnet policy 尚未授予此節點發布服務的權限,因此用戶端在聯絡 relay 前就會拒絕執行。請在管理主控台的 Access Controls 中編輯 tailnet policy 檔案,並加入以下屬性:
"nodeAttrs": [
{
"target": ["autogroup:member"],
"attr": ["funnel"],
},
],autogroup:member 會將權限授予 tailnet 中的所有成員。如果只有一台機器應發布服務,請為該機器加上 tag,改為指定該 tag,例如 tag:public。儲存 policy,然後再次執行 Funnel 命令。
如果您的帳戶可以編輯 tailnet policy(具備 Owner、Admin 或 Network admin 角色),近期版本的用戶端提供捷徑:CLI 會列印核准頁面的 URL。核准後,系統會為您建立 HTTPS 憑證,並加入該屬性。如果您不具備上述任一角色,該 URL 將無法協助您。必須由具備 policy 存取權限的人員進行編輯。
透過 tailscale funnel 發布到網際網路
設定好該屬性後,指令仍是你已經熟悉的形式,只是動詞不同。
sudo tailscale funnel --bg 3000Available on the internet:
https://amelie-workstation.pango-lin.ts.net
|-- / proxy http://127.0.0.1:3000
Press Ctrl+C to exit.每次都要先閱讀第一行。Available within your tailnet 和 Available on the internet 是私人服務與公開服務之間唯一可見的差異,而產生這兩者的指令只差一個單字。
截至 2026 年 10 月,funnel 只會監聽 443、8443 或 10000 埠,不會監聽其他埠。預設值是 443,--https=8443 或 --https=10000 是替代選項。其他埠都會被拒絕,因為 funnel relay 只接受這些埠上的連線。因此,funnel URL 一律只有主機名稱,或在結尾加上 :8443 或 :10000。
如何查看目前已發布的內容?
靠猜測會讓儀表板公開一個月。請直接詢問節點。
tailscale serve status
tailscale funnel status
tailscale serve status --json這兩個狀態指令讀取相同的設定,因此使用任一個都能查看完整狀態。請在指令碼或排程檢查中使用 --json 格式,因為一般輸出是提供人員閱讀的。未設定任何內容時,會顯示一行:
No serve config如果在確認設定成功後看到這個結果,表示對映是在前景建立的,而程序已經結束。請使用 --bg 重新建立。
若要移除單一對映,請重新執行建立該對映的指令,並在結尾加上 off。若要清除節點上的所有 serve 和 funnel 對映,請使用 reset。
sudo tailscale funnel --https=443 3000 off
sudo tailscale serve reset完成任一操作後,再次執行 tailscale serve status,確認實際剩餘內容,不要假設指令已完成預期工作。
你會獲得什麼,以及必須放棄什麼
這些優點確實存在,也是人們選擇它而非反向代理的原因。
- 瀏覽器信任的憑證,並由系統代為續期。不必安裝 ACME(automatic certificate management environment)用戶端,也不必擔心忘記設定續期工作。
- VPS 防火牆不必開放入站埠。
tailscaled會主動撥出連線,因此 VPS 上預設拒絕連線的 ufw 防火牆可以維持原本嚴格的設定。 - 不必購買、指向或等待 DNS 記錄生效。
- 不必設定連接埠轉送。對於位於 NAT(network address translation)後方的機器,而非具備公開 IP 的 VPS,這就是完整的解決方案。
代價同樣確實,而 funnel 會承擔以下所有限制。
- 名稱不屬於你。公開訪客會看到
host.your-tailnet.ts.net。Funnel 不支援自訂網域,因此你無法在前方使用app.example.com。 - 路徑不屬於你。流量會先到達 Tailscale relay,再由 relay 透過 tailnet 將串流代理到你的節點。Tailscale 表示 funnel 流量受無法設定的頻寬限制影響;其文件未提供限制數值,因此在依賴任何特定數值前,請先測量自己的吞吐量。
- 缺少控制功能。自行執行的反向代理可提供存取日誌、速率限制、請求大小上限,以及放置驗證機制的位置。Funnel 只提供 URL。其他功能都必須由應用程式內部處理。
- 可用的連接埠固定,如上所述。
這兩項功能也依賴 Tailscale 所營運的基礎設施,包括為 ts.net 名稱核發憑證,以及 funnel relay 本身。這項依賴是否需要讓你在意,取決於那些伺服器能對你的流量執行哪些操作、不能執行哪些操作;這正是 Tailscale 的信任模型所說明的內容。兩者都不收取使用費:Tailscale 列出每個方案都提供 Funnel,Serve 文件也未列出方案限制;此外,免費方案涵蓋最多 6 位使用者,且每位使用者的裝置數量不限。第 7 位使用者通常是 tailnet 轉用付費方案的原因,但某些功能,例如 SCIM(system for cross-domain identity management)使用者佈建和網路流量日誌,無論規模大小都需要付費方案。超過這個範圍後,費用是依使用者而非機器計算,因此在 serve 或 funnel 成為關鍵元件前,值得先確認付費方案下 tailnet 的實際費用。如果你正在評估自架 Headscale control server,不要假設這兩項功能也能隨你一起移轉。請查看你計畫執行的 Headscale 版本之版本資訊。
該使用哪一個?
規則很簡單。
內部用途一律使用 serve:管理介面、儀表板、不希望被索引的 metrics UI,以及網站的 staging 副本。存取控制就是 tailnet 的成員資格,而且這項控制相當可靠。不在 tailnet 上的裝置甚至無法解析該名稱。
示範連結、第三方必須 POST 到的 webhook receiver,或開發期間的 OAuth callback,使用 funnel。這是取得公開 HTTPS URL 的最快方式,而執行一個 off 命令即可停止。公開就代表公開:hostname 不是 secret;如果應用程式沒有登入機制,放在其前方的 funnel 就是開放服務。後方的服務必須自行驗證請求,並採取與 暴露的 Ollama API endpoint 相同的謹慎程度。
凡是可稱為 production 的服務,都應使用正式的 reverse proxy。網域、憑證、日誌與速率限制都由你管理,請求路徑中也不會有其他人。比較 nginx、Caddy 與 Traefik 作為 reverse proxy 可協助你選擇。
錯誤情況,以及你會看到的字串
Funnel 拒絕啟動。 Funnel not available; "funnel" node attribute not set. 是政策問題,不是命令問題。將 funnel 屬性加入 tailnet policy 檔案,儲存後重試。
原本可正常運作,現在 tailscale serve status 顯示 No serve config。 此 mapping 是在前景中建立的,而該程序已經結束。使用 --bg 重新執行相同命令。
名稱可解析,但沒有任何回應。 Serve 會將代理轉送到你指定的目標,因此如果該處沒有服務監聽,就沒有可供代理轉送的目標。在執行 tailscaled 的同一台機器上使用 ss -ltnp | grep 3000 確認。常見原因是容器將連接埠發佈在 Docker bridge 位址,而不是 127.0.0.1,因此主機在預期的位置看不到監聽中的服務。Docker Compose 網路的運作方式說明已發佈的連接埠實際會落在哪裡。如果應用程式已在 Compose 中執行,將 Tailscale 以 sidecar 加入堆疊即可消除這項猜測,因為容器會取得自己的 tailnet 名稱,完全不需要發佈主機連接埠。
ts.net 名稱發生憑證錯誤。 tailnet 很可能尚未啟用 HTTPS 憑證。在管理主控台中啟用憑證,然後單獨執行憑證步驟,避免其錯誤與 serve 輸出混在一起:
sudo tailscale cert your-host.your-tailnet.ts.netFunnel 可透過行動數據載入,但行為與筆記型電腦不同。 你的筆記型電腦位於 tailnet 上,因此 MagicDNS 會將名稱解析為 100.x 位址,並透過 tailnet 連線到服務,不會經過 Funnel relay。這是正確行為,也表示你的筆記型電腦完全無法測試公開連線能力。請在不屬於 tailnet 的機器上使用 curl。
FAQ
tailscale serve 與 tailscale funnel 有何不同?
誰可以存取該服務。tailscale serve 會將本機埠發布至 HTTPS URL,只有 tailnet 上的裝置可以存取。tailscale funnel 會將同一個埠發布至任何網際網路使用者都能存取的 URL,並透過 Tailscale 執行的 relay server 進行路由。兩者共用相同的 flags 與 targets。輸出的第一行會告訴你使用的是哪一種:Available within your tailnet 或 Available on the internet。
為什麼 tailscale funnel 顯示 node attribute 尚未設定?
因為除非有人啟用 funnel,否則 tailnet 預設會停用此功能。訊息內容是 Funnel not available; "funnel" node attribute not set.,且由你自己的 client 在連線至任何 relay 之前顯示。請在 Access Controls 下的 tailnet policy file 中加入 nodeAttrs 設定,將 funnel attribute 授予 autogroup:member;如果只有一台機器應發布服務,也可以授予 tag。tailnet admin 也可以依照 CLI 顯示的 consent URL 操作。
Tailscale Funnel 可以使用哪些埠?
只有 443、8443 和 10000。預設值是 443,你可以使用 --https=8443 或 --https=10000 選擇其他埠。這是 funnel relay 的限制,不是伺服器的限制,因此無法透過修改 VPS 的防火牆或設定來解除。tailscale serve 沒有這項限制,因為流量不會離開你的 tailnet。
serve 或 funnel URL 在重新開機後仍會存在嗎?
只有使用 --bg 時才會。未使用此選項時,命令會在前景執行、顯示 Press Ctrl+C to exit.,而 mapping 會隨著該程序結束而消失。使用 --bg 時,mapping 會寫入 node 的 serve config,並在重新開機後透過 tailscaled 恢復。請使用 tailscale serve status 檢查;未設定任何項目時,該命令會顯示 No serve config。
讓 funnel 持續執行是否安全?
就傳輸層面而言是安全的:連線使用 HTTPS,且防火牆不會開放任何埠。但就通常所說的安全性而言並不安全,因為 URL 是公開的,其後端應用程式也會公開。只有在 funnel 前方的應用程式會自行驗證請求時,才應讓 funnel 持續執行。示範或 webhook 測試結束後,請在建立 funnel 的命令末尾加上 off 來停止它。
上述命令行為的來源為 Tailscale Serve 與 Funnel 文件及 CLI reference:tailscale.com/docs。