تفاوت Tailscale serve و Funnel چیست؟
تفاوت اصلی در دسترسی است. دستور serve سرویس را فقط در tailnet منتشر میکند، اما Funnel آن را عمومی میسازد. برای استفاده از Funnel باید ACL را در Tailscale تنظیم کنید.
تفاوت tailscale serve و funnel: چه کسی به URL دسترسی دارد
تفاوت بین tailscale serve و tailscale funnel تنها در مخاطبان آن است و هیچ تفاوت دیگری وجود ندارد. دستور serve یک رابط HTTPS (پروتکل انتقال ابرمتن امن) روی یک پورت محلی قرار میدهد و آن را فقط برای tailnet شما منتشر میکند. دستور funnel همان پورت محلی را از طریق سرورهای رلهای که Tailscale اجرا میکند، برای کل اینترنت عمومی منتشر مینماید. هر دو دستور از پرچمها (flags) و مقصدهای یکسانی استفاده میکنند. تنها یک کلمه تفاوت بین یک داشبورد خصوصی و داشبوردی که برای همه جهان قابل دسترسی است، وجود دارد.
هر دو دستور گواهینامهای به شما میدهند که مرورگرها از قبل به آن اعتماد دارند؛ این گواهینامه روی دامنهای با پسوند ts.net قرار میگیرد و هیچکدام نیازی به باز کردن پورت ورودی در فایروال VPS شما ندارند. دیمون tailscaled شما از قبل اتصالی به tailnet برقرار کرده است و ترافیک از همان مسیر منتقل میشود. آوردن یک سرور به داخل tailnet یک وظیفه است، و اجرای یک VPS به عنوان exit node در Tailscale یا معرفی یک subnet router برای یک شبکه خصوصی این موضوع را پوشش میدهد. انتشار سرویسی که هماکنون در tailnet قرار دارد، موضوع این بخش است.
پیشنیازهای لازم برای اجرای دستورات
- نسخه 1.52 یا جدیدتر Tailscale روی VPS که به tailnet شما متصل باشد. قابلیت Funnel از نسخه 1.38.3 معرفی شد، اما دستورات serve و funnel در نسخه 1.52 تغییر کردند و تمام دستورات این صفحه از سینتکس جدید استفاده میکنند. با استفاده از
tailscale versionوtailscale statusنسخه خود را بررسی کنید. - فعال بودن MagicDNS. این قابلیت، سیستم DNS داخلی Tailscale است که به دستگاه شما نامی مانند
blog-vps.your-tailnet.ts.netاختصاص میدهد تا مجبور نباشید فقط از آدرس100.xاستفاده کنید. - فعال بودن گواهیهای HTTPS برای tailnet در صفحه DNS کنسول مدیریت. بدون این مورد، گواهی معتبری برای قرار گرفتن روی پورت شما وجود نخواهد داشت.
- برای
funnel، نیاز به ویژگی node در بخشfunnelدر فایل سیاستهای tailnet دارید. این همان بخشی است که اکثر تلاشهای اولیه در آن متوقف میشود و در ادامه توضیح داده شده است.
تمام دستورات این بخش با sudo شروع میشوند، زیرا tailscaled معمولاً با دسترسی root اجرا میشود و بهصورت پیشفرض فقط root اجازه مدیریت آن را دارد. برای اینکه به یک کاربر اجازه دهید بدون نیاز به root این دستورات را اجرا کند، او را به عنوان operator تعیین کنید:
sudo tailscale set --operator=$USERانتشار در tailnet با استفاده از tailscale serve
کافی است 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 روی پورت 443 از آدرس tailnet دستگاه گوش میدهد، TLS (امنیت لایه انتقال) را با گواهی ts.net خاتمه میدهد و ترافیک HTTP ساده را به پورت محلی شما هدایت میکند. برنامه شما هرگز نیازی ندارد از وجود گواهی مطلع باشد؛ این اصلیترین دلیل استفاده از این روش برای پنلهای مدیریتی است که در غیر این صورت باید روی HTTP ساده باقی میماندند. یک رابط کاربری وب که فقط به 127.0.0.1 متصل است، بهترین گزینه برای این کار است و رابط کاربری وب dsh روی پورت 3080 مثال خوبی است: بهجای اینکه هر بار برای دسترسی به آن یک تونل SSH باز کنید، یک بار serve را به پورت 3080 اشاره دهید تا از هر دستگاهی در tailnet به آن دسترسی داشته باشید.
حالا به خط آخر توجه کنید: Press Ctrl+C to exit. این دستور در پیشزمینه (foreground) اجرا میشود و نگاشت (mapping) در همان پردازش باقی میماند. اگر ترمینال را ببندید، URL از کار میافتد زیرا چیزی روی دیسک نوشته نشده است. با افزودن --bg، نگاشت در پیکربندی serve گره (node) ذخیره میشود که پس از بستن ترمینال و حتی راهاندازی مجدد (reboot) سیستم نیز باقی میماند.
sudo tailscale serve --bg 3000دستور serve فقط به شماره پورت محدود نمیشود. --set-path یک سرویس را در یک زیرمسیر (subpath) سوار (mount) میکند تا چندین برنامه بتوانند از یک نام میزبان (hostname) مشترک استفاده کنند:
sudo tailscale serve --bg --set-path=/grafana 3000
sudo tailscale serve --bg --set-path=/metrics 9090مقصد (target) همچنین میتواند یک دایرکتوری از فایلهای ایستا (static files) یا یک backend باشد که از قبل با گواهی TLS صحبت میکند و شما نمیخواهید آن گواهی بررسی شود:
sudo tailscale serve --bg /srv/reports
sudo tailscale serve --bg https+insecure://localhost:8443این قابلیت فقط به HTTP محدود نیست. --tcp=<port> یک جریان TCP (پروتکل کنترل انتقال) خام را هدایت میکند و --tls-terminated-tcp=<port> عملیات TLS را در گره شما خاتمه داده و دادههای متنی ساده (plaintext) را عبور میدهد؛ این کار باعث میشود یک گواهی معتبر در مقابل سرویسی قرار گیرد که اصلاً از پروتکل HTTP پشتیبانی نمیکند:
sudo tailscale serve --bg --tls-terminated-tcp=443 tcp://127.0.0.1:9899چرا funnel میگوید ویژگی node تنظیم نشده است؟
قابلیت Funnel بهصورت پیشفرض برای کل tailnet غیرفعال است. اولین اجرا این پیام را نمایش داده و متوقف میشود:
Funnel not available; "funnel" node attribute not set. See https://tailscale.com/s/no-funnel.دستور وارد شده صحیح بود. سیاست (policy) تعریفشده در tailnet به این node اجازه انتشار نداده است، بنابراین کلاینت پیش از برقراری ارتباط با relay، درخواست را رد میکند. فایل سیاست tailnet را در کنسول مدیریت، بخش Access Controls ویرایش کرده و این ویژگی را اضافه کنید:
"nodeAttrs": [
{
"target": ["autogroup:member"],
"attr": ["funnel"],
},
],autogroup:member این دسترسی را به تمام اعضای tailnet میدهد. اگر فقط یک ماشین باید اجازه انتشار داشته باشد، آن ماشین را tag کنید و tag را هدف قرار دهید، برای مثال tag:public. سیاست را ذخیره کرده و سپس دستور funnel را دوباره اجرا کنید.
اگر حساب کاربری شما دسترسی ویرایش سیاست tailnet را دارد (نقش Owner، Admin یا Network admin)، کلاینتهای جدید یک میانبر ارائه میدهند: CLI یک URL به صفحه تأیید چاپ میکند که با تأیید آن، گواهیهای HTTPS ایجاد شده و ویژگی مربوطه بهطور خودکار برای شما اضافه میشود. اگر شما فاقد یکی از این نقشها هستید، آن URL برای شما کارایی نخواهد داشت. شخصی که دسترسی ویرایش سیاست را دارد باید این تغییر را اعمال کند.
انتشار در اینترنت با استفاده از 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، قابلیت funnel فقط روی پورتهای 443، 8443 یا 10000 گوش میدهد و نه هیچ پورت دیگری. پورت پیشفرض 443 است و --https=8443 یا --https=10000 گزینههای جایگزین هستند. هر پورت دیگری رد میشود، زیرا relayهای funnel فقط اتصالات را روی این پورتها میپذیرند. به همین دلیل است که URL یک funnel همیشه شامل نام میزبان (hostname) بهصورت ساده، یا نام میزبان به همراه :8443 یا :10000 در انتهای آن است.
چگونه میتوانم ببینم در حال حاضر چه چیزی منتشر شده است؟
حدس زدن باعث میشود یک داشبورد برای یک ماه عمومی باقی بماند. از خود node بپرسید.
tailscale serve status
tailscale funnel status
tailscale serve status --jsonهر دو دستور وضعیت، پیکربندی یکسانی را میخوانند، بنابراین هر کدام از آنها تصویر کاملی به شما نشان میدهد. از فرم --json داخل اسکریپت یا بررسیهای زمانبندیشده استفاده کنید، زیرا خروجی ساده برای خواندن توسط انسان نوشته شده است. وقتی هیچ چیزی پیکربندی نشده باشد، یک خط دریافت میکنید:
No serve configمشاهده این مورد پس از راهاندازی که میدانستید کار میکند، به این معنی است که نگاشت (mapping) در پیشزمینه ایجاد شده و فرآیند پایان یافته است. آن را با --bg دوباره ایجاد کنید.
برای حذف یک نگاشت، دستوری که آن را ایجاد کرده است تکرار کنید و off را در انتها قرار دهید. برای پاک کردن تمام نگاشتهای serve و funnel روی node، از reset استفاده کنید.
sudo tailscale funnel --https=443 3000 off
sudo tailscale serve resetپس از هر کدام از این دستورات، tailscale serve status را دوباره اجرا کنید و آنچه باقی مانده است را بخوانید، به جای اینکه فرض کنید دستور دقیقاً همان کاری را انجام داده که مد نظر شما بوده است.
آنچه به دست میآورید و آنچه از دست میدهید
مزایا واقعی هستند و به همین دلیل است که افراد این روش را به reverse proxy ترجیح میدهند.
- گواهی مورد اعتماد مرورگرها که برای شما تمدید میشود. نیازی به نصب کلاینت ACME (محیط مدیریت خودکار گواهی) نیست و هیچ کار تمدیدی وجود ندارد که فراموش شود.
- عدم نیاز به باز کردن پورت ورودی در فایروال VPS. ابزار
tailscaledاتصال خروجی برقرار میکند، بنابراین فایروال پیشفرض ufw روی VPS شما میتواند دقیقاً به همان اندازه محدود باقی بماند. - نیازی به خرید، تنظیم یا انتظار برای رکورد DNS نیست.
- عدم نیاز به port forwarding، که کل ماجرا برای دستگاهی است که پشت NAT (ترجمه آدرس شبکه) قرار دارد، برخلاف VPS که دارای IP عمومی است.
هزینهها نیز به همان اندازه واقعی هستند و Funnel تمام آنها را به همراه دارد.
- نام دامنه متعلق به شما نیست. بازدیدکنندگان عمومی
host.your-tailnet.ts.netرا میبینند. Funnel از دامنه سفارشی پشتیبانی نمیکند، بنابراین نمیتوانیدapp.example.comرا جلوی آن قرار دهید. - مسیر متعلق به شما نیست. ترافیک ابتدا به یک relay در Tailscale میرسد و آن relay جریان را از طریق tailnet به گره شما پروکسی میکند. Tailscale اعلام کرده است که ترافیک Funnel مشمول محدودیتهای پهنای باندی است که قابل پیکربندی نیستند و مستندات آن هیچ عددی برای این محدودیتها ارائه نمیدهد، بنابراین پیش از تکیه بر یک عدد خاص، توان عملیاتی خود را اندازه بگیرید.
- کنترلها وجود ندارند. reverse proxy که خودتان اجرا میکنید، لاگهای دسترسی، محدودیت نرخ (rate limit)، سقف اندازه درخواست و مکانی برای قرار دادن احراز هویت در اختیار شما میگذارد. Funnel فقط یک URL به شما میدهد. هر چیز دیگری باید داخل برنامه شما پیادهسازی شود.
- لیست پورتها همانطور که در بالا ذکر شد، ثابت است.
هر دو قابلیت به زیرساختی که Tailscale مدیریت میکند وابسته هستند: صدور گواهی برای نام ts.net و خودِ relayهای Funnel. اینکه آیا این وابستگی باید شما را نگران کند یا خیر، به این بستگی دارد که آن سرورها با ترافیک شما چه کاری میتوانند یا نمیتوانند انجام دهند، که دقیقاً همان چیزی است که مدل اعتماد Tailscale مشخص میکند. استفاده از هیچکدام هزینهای ندارد: Tailscale قابلیت Funnel را در تمامی پلنها در دسترس قرار داده است، مستندات Serve آن هیچ محدودیتی برای پلنها ذکر نمیکند و پلن رایگان تا شش کاربر را با تعداد نامحدود دستگاه برای هر کدام پوشش میدهد. کاربر هفتم معمولاً دلیل اصلی انتقال یک tailnet به پلن پولی است، اگرچه برخی قابلیتها مانند SCIM (مدیریت هویت بین دامنهای) برای provisioning کاربران و لاگهای جریان شبکه، در هر اندازهای نیاز به پلن پولی دارند. پس از آن نقطه، صورتحساب بر اساس تعداد کاربران محاسبه میشود نه ماشینها، بنابراین پیش از آنکه Serve یا Funnel به بخشهای حیاتی زیرساخت شما تبدیل شوند، بررسی هزینه واقعی یک tailnet در پلن پولی ارزشمند است. اگر در حال بررسی سرور کنترل Headscale خود-میزبانیشده هستید، فرض نکنید که این قابلیتها همراه شما منتقل میشوند. یادداشتهای انتشار (release notes) نسخه Headscale مورد نظر خود را بررسی کنید.
کدامیک را باید استفاده کنم؟
قانون ساده است.
برای هر چیزی که داخلی است از serve استفاده کنید: رابطهای کاربری مدیریت، داشبوردها، رابط کاربری متریکها که نمیخواهید ایندکس شوند، یا نسخه staging یک وبسایت. عضویت در tailnet کنترل دسترسی شماست و بسیار مطمئن است. دستگاهی که در tailnet نباشد، حتی نمیتواند نام دامنه را resolve کند.
برای لینکهای دمو، گیرنده webhook که یک سرویس ثالث باید به آن POST کند، یا callback مربوط به OAuth در حین توسعه، از funnel استفاده کنید. این سریعترین مسیر برای رسیدن به یک URL عمومی با HTTPS است و با یک دستور off خاتمه مییابد. اما توجه داشته باشید که عمومی به معنای واقعی کلمه عمومی است: نام میزبان (hostname) مخفی نیست و اگر یک funnel را جلوی برنامهای بدون سیستم ورود قرار دهید، آن سرویس برای همه باز خواهد بود. هر چیزی که پشت آن قرار میگیرد باید درخواستهای خود را احراز هویت کند؛ با همان دقتی که یک endpoint عمومی Ollama API به آن نیاز دارد.
برای هر چیزی که آن را محیط عملیاتی (production) مینامید، از یک reverse proxy واقعی استفاده کنید. دامنه متعلق به خودتان، گواهی متعلق به خودتان، لاگهای خودتان، محدودیتهای نرخ (rate limits) خودتان، و بدون حضور هیچ واسطه دیگری در مسیر درخواست. مطلب مقایسه Nginx، Caddy و Traefik به عنوان reverse proxy به شما در انتخاب گزینه مناسب کمک میکند.
حالتهای شکست، همراه با پیامهایی که مشاهده خواهید کرد
برنامه Funnel از اجرا امتناع میکند. Funnel not available; "funnel" node attribute not set. یک مشکل در سیاستهای دسترسی است، نه یک مشکل در دستور. ویژگی funnel را به فایل سیاستهای tailnet اضافه کنید، آن را ذخیره کرده و دوباره تلاش کنید.
همه چیز کار میکرد، اما اکنون tailscale serve status پیام No serve config را نمایش میدهد. نگاشت (mapping) در پیشزمینه ایجاد شده بود و آن پردازش پایان یافته است. همان دستور را با استفاده از --bg دوباره اجرا کنید.
نام دامنه Resolve میشود اما پاسخی دریافت نمیشود. دستور Serve درخواستها را به مقصدی که تعیین کردهاید پروکسی میکند؛ بنابراین اگر در آن مقصد سرویسی در حال گوش دادن (listening) نباشد، پروکسی نیز پاسخی نخواهد داشت. با استفاده از ss -ltnp | grep 3000 روی همان ماشینی که tailscaled را اجرا میکند، این موضوع را تأیید کنید. دلیل رایج این است که یک کانتینر پورت خود را روی آدرس Docker bridge منتشر میکند، نه روی 127.0.0.1؛ این یعنی میزبان (host) هیچ سرویس در حال گوشدادنی در جایی که انتظار داشتید نمیبیند. نحوه عملکرد شبکه در Docker Compose نشان میدهد که پورت منتشرشده در واقع کجا قرار میگیرد. اگر برنامه از قبل در Compose اجرا میشود، قرار دادن Tailscale در stack به عنوان یک sidecar این حدس و گمانها را حذف میکند، زیرا کانتینر نام tailnet اختصاصی خود را دریافت کرده و هرگز پورت میزبان را منتشر نمیکند.
خطاهای گواهی روی نام ts.net. به احتمال زیاد گواهیهای HTTPS برای tailnet فعال نشدهاند. آنها را در کنسول مدیریت (admin console) فعال کنید، سپس مرحله دریافت گواهی را بهصورت جداگانه اجرا کنید تا خطاهای آن با خروجی دستور serve تداخل پیدا نکند:
sudo tailscale cert your-host.your-tailnet.ts.netسرویس Funnel روی اینترنت موبایل بارگذاری میشود اما رفتاری متفاوت از لپتاپ شما دارد. لپتاپ شما در tailnet قرار دارد، بنابراین MagicDNS نام را به آدرس 100.x تبدیل میکند و شما بدون عبور از relayهای funnel، از طریق tailnet به سرویس دسترسی پیدا میکنید. این رفتار صحیح است و به این معنی است که لپتاپ شما نمیتواند دسترسی عمومی (public reachability) را تست کند. از curl روی ماشینی استفاده کنید که در tailnet عضو نیست.
FAQ
تفاوت بین tailscale serve و tailscale funnel چیست؟
تفاوت در این است که چه کسی میتواند به نتیجه دسترسی داشته باشد. tailscale serve یک پورت محلی را در یک URL با پروتکل HTTPS منتشر میکند که فقط دستگاههای موجود در tailnet شما قادر به دسترسی به آن هستند. tailscale funnel همان پورت را در URLای منتشر میکند که هر کسی در اینترنت میتواند به آن دسترسی داشته باشد؛ این ترافیک از طریق سرورهای relay که توسط Tailscale مدیریت میشوند، هدایت میگردد. پرچمها (flags) و مقاصد در هر دو دستور مشترک هستند. اولین خط خروجی به شما میگوید که کدامیک را دریافت کردهاید: Available within your tailnet یا Available on the internet.
چرا tailscale funnel میگوید ویژگی node تنظیم نشده است؟
زیرا قابلیت funnel تا زمانی که توسط شخصی فعال نشود، برای یک tailnet غیرفعال است. پیام خطا Funnel not available; "funnel" node attribute not set. است و از سمت کلاینت خود شما ارسال میشود، پیش از آنکه تماسی با هرگونه relay برقرار گردد. یک ورودی nodeAttrs اضافه کنید که ویژگی funnel را به autogroup:member اعطا کند، یا اگر فقط یک ماشین باید عمل انتشار را انجام دهد، آن را به یک tag اختصاص دهید؛ این کار باید در فایل سیاست tailnet در بخش Access Controls انجام شود. مدیر tailnet همچنین میتواند URL رضایتی که CLI چاپ میکند را دنبال کند.
Tailscale Funnel از چه پورتهایی میتواند استفاده کند؟
فقط 443، 8443 و 10000. پورت پیشفرض 443 است و شما میتوانید با استفاده از --https=8443 یا --https=10000 پورت دیگری را انتخاب کنید. این یک محدودیت در relayهای funnel است، نه در سرور شما؛ بنابراین هیچ تغییر فایروال یا پیکربندی در VPS این محدودیت را برطرف نمیکند. tailscale serve چنین محدودیتی ندارد، زیرا ترافیک هرگز از tailnet شما خارج نمیشود.
آیا URL ایجاد شده توسط serve یا funnel پس از reboot باقی میماند؟
فقط اگر از --bg استفاده کرده باشید. بدون آن، دستور در پیشزمینه (foreground) اجرا میشود، Press Ctrl+C to exit. را چاپ میکند و با بسته شدن پردازش، نگاشت (mapping) نیز از بین میرود. با استفاده از --bg، نگاشت در پیکربندی serve گره نوشته میشود و پس از reboot با tailscaled دوباره فعال میگردد. وضعیت را با tailscale serve status بررسی کنید که در صورت عدم تنظیم هرگونه پیکربندی، No serve config را چاپ میکند.
آیا باز گذاشتن یک funnel امن است؟
از نظر انتقال داده امن است: اتصال HTTPS است و هیچ پورتی روی فایروال شما باز نمیشود. اما از نظر مفهومی که معمولاً مد نظر است امن نیست، زیرا URL عمومی است و در نتیجه برنامهای که پشت آن قرار دارد نیز عمومی خواهد بود. funnel را فقط در مقابل سرویسی قرار دهید که درخواستهای خود را احراز هویت میکند، و پس از پایان دمو یا تست webhook، آن را با استفاده از همان دستوری که آن را ایجاد کرده و افزودن off در انتها، متوقف کنید.
منابع مربوط به رفتار دستورات فوق: مستندات Tailscale Serve و Funnel و مرجع CLI در tailscale.com/docs.