رفع خطاهای نصب Tailscale در Ubuntu
بیشتر خطاهای نصب Tailscale در Ubuntu مربوط به apt است. با بررسی کد خطای نمایش داده شده، مشکل را از طریق اصلاح codename مخزن یا بهروزرسانی keyring حل کنید.
چرا خطاهای نصب Tailscale در Ubuntu در واقع خطاهای apt هستند
خطاهای نصب Tailscale در Ubuntu تقریباً همیشه پیش از اجرای هرگونه کد Tailscale رخ میدهند. اینها خطاهای apt هستند. در بررسی انجامشده روی آرشیو بستههای Ubuntu در اکتبر 2026، هیچ بستهای با نام tailscale وجود نداشت: تنها موارد منطبق، کتابخانههای کمکی Go و python3-tailscale بودند. بنابراین، daemon بهطور معمول از مخزن apt اختصاصی Tailscale در pkgs.tailscale.com دریافت میشود. شرکت Canonical نیز یک snap برای Tailscale نگهداری میکند که در بخش سایر روشهای جایگزین در انتهای مطلب به آن پرداخته شده است.
افزودن آن مخزن، دو فایل ایجاد میکند. یک فایل به apt میگوید که بستهها در کجا قرار دارند. فایل دیگر حاوی کلید عمومی است که apt برای بررسی امضای فهرست مخزن از آن استفاده میکند. تقریباً تمام خطاهای زیر ناشی از نادرست بودن یکی از این دو فایل، یا مسدود شدن درخواست توسط دستگاهی در مسیر بین apt و مخزن است.
اینها دستوراتی هستند که Tailscale برای Ubuntu 24.04 منتشر کرده است:
sudo mkdir -p --mode=0755 /usr/share/keyrings
curl -fsSL https://pkgs.tailscale.com/stable/ubuntu/noble.noarmor.gpg | sudo tee /usr/share/keyrings/tailscale-archive-keyring.gpg >/dev/null
curl -fsSL https://pkgs.tailscale.com/stable/ubuntu/noble.tailscale-keyring.list | sudo tee /etc/apt/sources.list.d/tailscale.list
sudo apt-get update && sudo apt-get install tailscalenoble نام رمز Ubuntu 24.04 است و در هر دو URL ظاهر میشود. دستور دوم یک خط توضیحات و یک خط deb را در /etc/apt/sources.list.d/tailscale.list مینویسد و cat دقیقاً نشان میدهد که چه چیزی در آنجا قرار گرفته است.
cat /etc/apt/sources.list.d/tailscale.listآن خط deb را به عنوان یک آدرس در چهار بخش بخوانید: گزینه داخل براکت [signed-by=/usr/share/keyrings/tailscale-archive-keyring.gpg]، سپس پایه مخزن که pkgs.tailscale.com/stable/ubuntu است و از طریق https در دسترس است، سپس suite یعنی noble، و در نهایت component یعنی main. apt پایه و suite را به یک URL واحد متصل کرده و آن را فراخوانی میکند: https://pkgs.tailscale.com/stable/ubuntu/dists/noble/InRelease. دریافت دستی آن URL، آن درخواست را تست میکند؛ اما ثابت نمیکند که درخواست apt حتماً موفق خواهد بود.
پیش از هر تغییری، خطای apt را مطالعه کنید
عملیات update را بهتنهایی اجرا کنید تا خروجی خطا با پیامهای دیگر جابهجا نشود.
sudo apt updateیک مخزن (repository) شخص ثالث که با شکست مواجه شده، به این شکل دیده میشود. نام رمز (codename) و آدرس IP در سیستم شما متفاوت خواهد بود.
E: Failed to fetch https://pkgs.tailscale.com/stable/ubuntu/dists/wilma/InRelease 404 Not Found [IP: 203.0.113.9 443]
E: Some index files failed to download. They have been ignored, or old ones used instead.دو مورد در آن خروجی تعیین میکند که گام بعدی شما چیست: کد وضعیت و URL کامل در خط E: Failed to fetch. بر اساس خط خلاصه در پایین صفحه حدس نزنید. URL را کپی کنید و خودتان از سرور پرسوجو کنید.
curl -sS -o /dev/null -w '%{http_code}\n' https://pkgs.tailscale.com/stable/ubuntu/dists/noble/InReleaseاین دستور برای نام رمزی که Tailscale منتشر میکند، 200 را چاپ میکند. در اکتبر 2026 بررسی شد، noble یک ایندکس امضاشده حاوی Origin: Tailscale و Codename: noble بازمیگرداند. noble را با نام رمز موجود در خطای خود جایگزین کنید و دوباره آن را اجرا کنید. اگر curl کد 200 را دریافت کرد در حالی که apt با خطای fetch مواجه شده بود، یعنی مخزن به درخواست curl پاسخ داده است؛ اما این به معنای پیکربندی نادرست apt نیست: فیلترینگ در سطح سرویس یا در طول مسیر شبکه میتواند درخواستها را بر اساس هدرهایی مانند user agent تفکیک کند. با این حال، یک 200 فقط ثابت میکند که دانلود انجام شده است: apt همچنان پس از دانلود، امضای آن ایندکس را بررسی میکند و مشکل کلید (key) در آن مرحله باعث شکست میشود که بخش keyring در ادامه به آن میپردازد.
کد وضعیت چه چیزی را به شما میگوید
- کد
404 Not Foundبه این معنی است که سرور فایلی را در آن مسیر پیدا نکرده است، یا تمایلی ندارد وجود آن را فاش کند. درpkgs.tailscale.comکه فایلهای خود را بدون نیاز به اعتبارنامه ارائه میدهد، این کد تقریباً همیشه به دلیل نامگذاری اشتباه در URL است. - کد
403 Forbiddenبه این معنی است که پاسخی دریافت شده اما درخواست رد شده است. کد 403 بهتنهایی مشخص نمیکند که این رد درخواست از سمت یک proxy، یک ابزار فیلترینگ یا فایروالی بین سرور شما و Tailscale بوده، یا از سمت خودِ سرویس. برای مثال، AWS مستند کرده است که یک توزیع CloudFront میتواند کد 403 را از سمت خود بازگرداند، که ممکن است ناشی از یک قانون فایروال یا سرور origin باشد. - کد
407 Proxy Authentication Requiredبه این معنی است که یک proxy برای این درخواست نیاز به احراز هویت دارد: یا apt هیچ اعتبارنامهای برای proxy ارسال نکرده، یا اعتبارنامههایی ارسال کرده که proxy آنها را نامعتبر یا ناقص تشخیص داده است. کد401 Unauthorizedمتفاوت است: این یک درخواست برای ارائه اعتبارنامه جهت دسترسی به منبع مورد نظر است که با هدرWWW-Authenticateارسال میشود و بهتنهایی نشاندهنده وجود proxy نیست. این مخزن فایلهای خود را بدون اعتبارنامه ارائه میدهد، بنابراین کد 401 معمولاً به این معنی است که سرویس دیگری به جای آن URL پاسخ داده است، مانند یک gateway واسط. دستور دیباگ در بخش proxy نشان میدهد که apt در واقع به کدام host متصل شده است. - خطای اتصال یا خطای حل نام (name resolution) به این معنی است که هیچ گفتگوی HTTP برقرار نشده است. به بخش IPv6 بروید.
نام رمز موجود در URL چیزی است که Tailscale آن را منتشر نمیکند
Tailscale برای هر نام رمز (codename) اوبونتو یک دایرکتوری جداگانه ایجاد میکند. اگر نام رمزی را درخواست کنید که در آنجا وجود ندارد، با خطای 404 مواجه میشوید، زیرا هیچ dists/<codename> روی سرور برای ارائه وجود ندارد. لیست رسمی ارائهشده توسط سازنده در pkgs.tailscale.com/stable نشان میدهد که کدام نسخهها موجود هستند. در اکتبر 2026، این لیست از 16.04 تا stonking که همان Ubuntu 26.10 است ادامه دارد و resolute که Ubuntu 26.04 است، مستقیماً زیر آن قرار گرفته است.
روش معمول برای ورود یک نام رمز اشتباه، استفاده از lsb_release -cs در توزیعی است که بر پایه اوبونتو است اما خود اوبونتو نیست. در Linux Mint 22، این دستور wilma را چاپ میکند که نام رمز اختصاصی Mint است و Tailscale هیچ بستهای برای آن منتشر نمیکند. در عوض، نسخه پایه اوبونتو را بخوانید.
. /etc/os-release
echo "$VERSION_CODENAME $UBUNTU_CODENAME"در اوبونتو هر دو مقدار یکسان هستند. در یک توزیع مشتقشده، VERSION_CODENAME نام همان توزیع و UBUNTU_CODENAME نسخه اوبونتویی است که بر پایه آن ساخته شده است. در هر دو URL از UBUNTU_CODENAME استفاده کنید.
روش دوم، ارتقای نسخه (release upgrade) است. ابزار ارتقای اوبونتو هنگام اجرا، مخازن شخص ثالث را غیرفعال میکند؛ بنابراین پس از ارتقای Ubuntu 24.04 به 26.04، متوجه میشوید که /etc/apt/sources.list.d/tailscale.list یا کامنت شده است و یا همچنان به noble اشاره دارد، در حالی که سیستم اکنون resolute است. این مشکل را با اجرای مجدد دو دستور curl با نام رمز جدید برطرف کنید تا هر دو فایل بازنویسی شوند. اگر خودِ عملیات ارتقا در میانه راه متوقف شده است و dpkg درباره بستههای نیمهپیکربندیشده (و نه فقط این مخزن خاص) هشدار میدهد، ابتدا ارتقای ناموفق نسخه را بازیابی کنید، زیرا تا زمانی که apt نتواند پیکربندی سیستم را به پایان برساند، هیچ تغییری در tailscale.list پایدار نخواهد بود.
روش سوم مربوط به زمانبندی است. اگر روی یک نسخه جدید اوبونتو پیش از آنکه Tailscale نام رمز آن را اضافه کند اقدام به نصب کنید، همان خطای 404 را دریافت خواهید کرد. این بازه زمانی اغلب کوتاه است یا اصلاً وجود ندارد: تیکت پیگیری Tailscale برای پشتیبانی نصب Ubuntu 24.04 در ژانویه 2024، ماهها پیش از انتشار آن نسخه، به عنوان تکمیلشده بسته شد. برای Ubuntu 26.10، در تاریخ 24 اکتبر 2026 بررسی شد که dists/stonking/InRelease یک ایندکس امضاشده حاوی Origin: Tailscale و Codename: stonking برمیگرداند؛ بنابراین اگر پیشتر برای stonking خطای 404 دریافت کردید، پیش از هرگونه اقدام جایگزین، دوباره آن را دریافت کنید. اگر در آن بازه زمانی خاص قرار گرفتید، اشاره دادن فایل به نام رمز LTS قبلی معمولاً نصب را انجام میدهد، زیرا این بستهها وابستگیهای کمی دارند؛ اما انتخاب آن مخزن به معنای انتخاب یک بیلد خاص برای نسخه اوبونتو نیست: بیلدهای deb شرکت Tailscale معماریهای لینوکسی مانند amd64 و arm64 را هدف قرار میدهند. با استفاده از apt policy tailscale بررسی کنید که واقعاً چه چیزی دریافت کردهاید و پس از ظاهر شدن نام رمز واقعی، فایل را به حالت قبل بازگردانید.
کیرینگ خالی است و دستوری که آن را نوشته، هیچ خروجیای نداشته است
این مورد بیسروصدا است و اکثر این مشکلات به همینجا ختم میشوند. دوباره به دستور کیرینگ نگاه کنید:
curl -fsSL https://pkgs.tailscale.com/stable/ubuntu/noble.noarmor.gpg | sudo tee /usr/share/keyrings/tailscale-archive-keyring.gpg >/dev/nullشل (shell) کل پایپلاین را پیش از اجرای هر برنامه میسازد، بنابراین sudo tee مسیر کیرینگ را باز کرده و بلافاصله آن را به صفر بایت کاهش میدهد (truncate میکند). اگر curl شکست بخورد و -f باعث شود که در هر خطای HTTP متوقف شود، curl هیچ چیزی نمینویسد و با وضعیت غیرصفر خارج میشود. فایل در اندازه صفر بایت باقی میماند. وضعیت خروج یک پایپلاین، وضعیت آخرین دستور آن است که همان tee است که با موفقیت اجرا شده است. هیچ چیزی چاپ نمیشود و شما با تصور اینکه کلید نصب شده است، به سراغ دستور بعدی میروید.
فایل را بررسی کنید، نه دستوری که آن را ساخته است.
ls -l /usr/share/keyrings/tailscale-archive-keyring.gpg
gpg --show-keys /usr/share/keyrings/tailscale-archive-keyring.gpgیک کیرینگ سالم، یک خط pub و یک خط uid که نام Tailscale را دارد، چاپ میکند. یک فایل صفر بایتی، gpg: no valid OpenPGP data found. و هیچ چیز دیگری چاپ نمیکند. فایلی که یک صفحه خطای HTML را دریافت کرده باشد، همان خروجی را میدهد و اجرای head -c 80 روی آن، به جای دادههای باینری کلید، ابتدای یک صفحه وب را نشان میدهد.
با کیرینگی که کلید قابل استفادهای ندارد، sudo apt update ایندکس را دانلود کرده و سپس آن را رد میکند. شما یک خط W: GPG error با نام مخزن Tailscale و suite آن، متن The following signatures couldn't be verified because the public key is not available: NO_PUBKEY به همراه یک شناسه کلید 16 کاراکتری، و در زیر آن خطایی مبنی بر امضا نشدن مخزن دریافت میکنید. به آنچه apt به شما میگوید دقت کنید: ایندکس را بهدرستی دانلود کرده است و نتوانسته امضا را بررسی کند. این یک مشکل کلید است، نه یک مشکل شبکه. اگر فایل کیرینگ کلاً وجود نداشته باشد، پیام متفاوت است و مسیر را مستقیماً با Could not open file /usr/share/keyrings/tailscale-archive-keyring.gpg نام میبرد.
کلید را در دو مرحله بنویسید تا دانلود ناموفق نتواند یک کیرینگ سالم را از بین ببرد.
curl -fsSL https://pkgs.tailscale.com/stable/ubuntu/noble.noarmor.gpg -o /tmp/tailscale.gpg
gpg --show-keys /tmp/tailscale.gpg
sudo install -m 0644 -o root -g root /tmp/tailscale.gpg /usr/share/keyrings/tailscale-archive-keyring.gpgخط میانی دروازه است: اگر یک uid مربوط به Tailscale چاپ نکرد، متوقف شوید و فایل را کپی نکنید. حالت 0644 اهمیت دارد زیرا apt برای دریافت و تایید، دسترسی خود را به کاربر بدون امتیاز _apt کاهش میدهد، بنابراین کیرینگی که فقط root بتواند آن را بخواند، کیرینگی است که apt نمیتواند از آن استفاده کند.
وجود همزمان فایل .list و .sources برای یک مخزن یکسان
اوبونتو در نسخه 24.04 LTS فرمت منابع خود را به deb822 تغییر داد، که در آن /etc/apt/sources.list به /etc/apt/sources.list.d/ubuntu.sources تبدیل شد. Tailscale همچنان از فرمت یکخطی استفاده میکند. در بررسی اکتبر 2026، آدرس .sources مربوطه در pkgs.tailscale.com خطای 404 برگرداند. اگر سیستم شما دارای هر دو فایل tailscale.sources و tailscale.list باشد که یک مخزن یکسان را توصیف میکنند، apt اکنون آن مخزن را دو بار شناسایی میکند.
حالت خفیف این مشکل، نمایش یک هشدار در هر بار بهروزرسانی است:
W: Target Packages (main/binary-amd64/Packages) is configured multiple times in /etc/apt/sources.list.d/tailscale.list:1 and /etc/apt/sources.list.d/tailscale.sources:1حالت شدید زمانی رخ میدهد که این دو فایل مسیرهای متفاوتی برای keyring تعیین کرده باشند، زیرا apt نمیتواند تشخیص دهد کدام کلید مخزن را مدیریت میکند. در این حالت، apt عبارت E: Conflicting values set for option Signed-By regarding source را به همراه نام مخزن و suite آن، سپس دو مسیر keyring با عبارت != در میان آنها چاپ کرده و از ادامه کار خودداری میکند:
E: The list of sources could not be read.این خطا تمام دستورات apt را مسدود میکند، نه فقط بهروزرسانی را، تا زمانی که یکی از فایلها حذف شود. همین خطا ممکن است برای مخازن خود اوبونتو نیز رخ دهد و خطای منبع تکراری apt پس از مهاجرت به deb822 راهنمای کلی برای رفع این مشکل است.
پیش از حذف هر فایلی، تمام فایلهایی که به Tailscale اشاره دارند را پیدا کنید.
grep -RIn tailscale /etc/apt/sources.list /etc/apt/sources.list.d/یکی از فایلها را نگه دارید. برای غیرفعال کردن فایل دیگر بدون از دست دادن آن، نامش را تغییر دهید: apt فقط فایلهایی را میخواند که به .list یا .sources ختم میشوند، بنابراین فایل tailscale.list.bak نادیده گرفته شده و برای ارجاع در دیسک باقی میماند.
نوشتن صحیح فایل منبع deb822
اگر فرمت جدیدتر را ترجیح میدهید، فایل موجود خود را تبدیل کنید و آدرس مخزن را دوباره تایپ نکنید، زیرا اشتباه تایپی در آن دقیقاً همان چیزی است که باعث بروز خطاهای بالا میشود. نسخههای اخیر apt دارای مبدلی هستند که فایلهای .list را به استنزاهای deb822 بازنویسی کرده و گزینه signed-by را به عنوان Signed-By منتقل میکند.
apt modernize-sources --help
sudo apt modernize-sourcesنسخه apt در Ubuntu 24.04 قدیمیتر از آن است که این زیردستور را داشته باشد، بنابراین خط راهنما در همان لحظه به شما میگوید که آیا نسخه شما آن را دارد یا خیر. در مواردی که این ابزار وجود ندارد، استنزا را از خطی که قبلاً روی دیسک دارید بسازید تا پایه کار از فایل فروشنده گرفته شود، نه از کیبورد شما.
. /etc/os-release
{
echo 'Types: deb'
echo "URIs: $(awk '/^deb /{print $3}' /etc/apt/sources.list.d/tailscale.list)"
echo "Suites: $UBUNTU_CODENAME"
echo 'Components: main'
echo 'Signed-By: /usr/share/keyrings/tailscale-archive-keyring.gpg'
} | sudo tee /etc/apt/sources.list.d/tailscale.sources
sudo rm /etc/apt/sources.list.d/tailscale.listاین دستور استنزای نوشتهشده را چاپ میکند تا بتوانید فیلدها را پیش از apt update بعدی بازخوانی کنید. دانستن جزئیات چهار مورد از آنها ضروری است، زیرا هر کدام به روش متفاوتی دچار خطا میشوند:
URIsدر پایه مخزن متوقف میشود. چسباندن بخشdists/nobleدر آن منجر به خطای 404 میشود، زیرا apt خودشdists/<suite>را اضافه کرده و درخواستdists/noble/dists/nobleمیکند.Suitesهمان نام رمز (codename) است، دقیقاً همان مقداری که در وسط فرمت تکخطی قرار داشت.Signed-Byیک مسیر مطلق به فایل دستهکلید (keyring) میگیرد. این فیلد همچنین یک کلید armored را که در زیر آن قرار گرفته میپذیرد، به طوری که هر خط از کلید با یک فاصله تورفتگی داشته باشد و هر خط خالی داخل کلید به صورت یک نقطه نوشته شود.Enabled: noیک منبع را بدون حذف کردن غیرفعال میکند، که بازگرداندن آن آسانتر از تغییر نام است و توضیح دادن آن به نفر بعدی نیز سادهتر میباشد.
برای مخازن شخص ثالث، در هر فایل یک استنزا نگه دارید و اگر چندین استنزا را کنار هم قرار دادید، بین آنها یک خط خالی بگذارید. فهرست مخزن، amd64 و arm64 را در میان معماریهای خود لیست میکند، بنابراین یک VPS با معماری ARM نیازی به فیلد اضافی Architectures ندارد.
یک پروکسی در مسیر، خطای 403 بازمیگرداند
خطای 403 به این معناست که درخواست رد شده است، اما محل دقیق این امتناع را مشخص نمیکند: این خطا میتواند توسط دستگاهی بین سرور شما و Tailscale یا به دلیل فیلترینگ در خودِ سرویس ایجاد شود. ابتدا پیکربندی خودِ apt را بررسی کنید، زیرا پروکسی تنظیمشده در آنجا فقط برای apt اعمال میشود و نه برای دستور curl تعاملی شما.
grep -RIn -i proxy /etc/apt/apt.conf.d/ /etc/apt/apt.conf
sudo apt-config dump | grep -i 'acquire::http'سپس بررسی کنید که apt دقیقاً چه چیزی ارسال میکند.
sudo apt -o Debug::Acquire::http=1 updateاین دستور خط درخواست، هدرهایی که apt ارسال کرده و پروکسیای که از طریق آن متصل شده است (در صورت وجود) را چاپ میکند. آن را با یک دستور curl ساده به همان URL مقایسه کنید. اگر curl کد 200 و apt کد 403 را برمیگرداند، هدرهای درخواست و همچنین تنظیمات پروکسی را مقایسه کنید؛ فیلترینگ در سطح سرویس یا در طول مسیر میتواند بر اساس User Agent تفاوت قائل شود:
curl -sS -o /dev/null -w '%{http_code}\n' -A 'Debian APT-HTTP/1.3' https://pkgs.tailscale.com/stable/ubuntu/dists/noble/InReleaseاگر این دستور خطای 403 را برگرداند در حالی که curl پیشفرض کد 200 را میدهد، پاسخ بر اساس User Agent متفاوت است، اما این تست محل فیلتر را مشخص نمیکند. قوانین فیلترینگ در شبکه خود را بررسی کنید و اگر این قوانین پاسخگو نبودند، تفاوت پاسخها را به Tailscale گزارش دهید. اگر تمام درخواستهای ارسالی از سرور شما با خطای 403 مواجه میشوند، همان دستور curl را از ماشینی در یک شبکه دیگر اجرا کنید: دریافت 200 در آنجا نشان میدهد که امتناع به کلاینت یا شبکه بستگی دارد، هرچند قوانین سمت سرویس مانند محدودیتهای جغرافیایی نیز میتوانند باعث این تفاوت شوند. صفحه وضعیت Tailscale را نیز بررسی کنید؛ دریافت خطای 403 از هر دو شبکه به تنهایی محل مسدودسازی را مشخص نمیکند. یک پروکسی شرکتی که ترافیک TLS را بازرسی میکند، رفتار متفاوتی دارد: اگر مرجع صدور گواهی (CA) پروکسی در سرور شما مورد اعتماد نباشد، apt خطای عدم تأیید گواهی را گزارش میدهد. یک فایروال خروجی ابری (Cloud egress firewall) که فقط اجازه دسترسی به مخازن Ubuntu را میدهد، منبع رایج دیگر است و راه حل آن، مجاز کردن pkgs.tailscale.com در فایروال است.
خروجی فقط IPv6 و خطاهایی که کد وضعیت نیستند
اگر apt هیچ پاسخ HTTP دریافت نکرد، هر پروتکل را بهصورت جداگانه تست کنید.
curl -4 -sS -o /dev/null -w 'v4 %{http_code}\n' https://pkgs.tailscale.com/stable/ubuntu/dists/noble/InRelease
curl -6 -sS -o /dev/null -w 'v6 %{http_code}\n' https://pkgs.tailscale.com/stable/ubuntu/dists/noble/InReleaseزمانی که IPv4 پاسخ میدهد اما IPv6 معلق میماند یا Network is unreachable گزارش میکند، تست IPv6 با شکست مواجه شده است، اما این موضوع بهتنهایی دلیل شکست apt نیست. نسخه APT 2.8 بهطور خودکار بین خانوادههای آدرس جابهجا میشود و پس از یک وقفه پیشفرض 250 میلیثانیهای، تلاش برای اتصال دیگری را آغاز میکند. یک بار اجرای آن را روی IPv4 اجباری کنید تا ببینید آیا نتیجه apt تغییر میکند یا خیر:
sudo apt -o Acquire::ForceIPv4=true updateاگر آن بهروزرسانی موفقیتآمیز بود، آن را دائمی کنید.
echo 'Acquire::ForceIPv4 "true";' | sudo tee /etc/apt/apt.conf.d/99force-ipv4در مورد حالت مخالف صادق باشید. در یک VPS که اصلاً آدرس IPv4 ندارد، اجباری کردن IPv4 هیچ چیزی را اصلاح نمیکند، زیرا مسیر IPv4 برای هدایت ترافیک وجود ندارد. اگر مخزن (repository) از طریق IPv6 بومی در دسترس نیست، به NAT64 همراه با DNS64 از سمت ارائهدهنده خود نیاز دارید، یا یک پروکسی که دارای آدرس IPv4 باشد. خطای اتصال که یک آدرس IPv6 را نام میبرد، نشاندهنده شکست تلاش برای اتصال IPv6 است؛ از خط curl -6 برای تست جداگانه آن مسیر استفاده کنید.
روشهای جایگزین و هزینه هر کدام
اسکریپت نصب ارائهشده توسط فروشنده. دستور curl -fsSL https://tailscale.com/install.sh | sh همان دستوری است که Tailscale تبلیغ میکند. با بررسی اسکریپت، متوجه میشوید که توزیع سیستمعامل شما را از طریق /etc/os-release شناسایی کرده و سپس همان دو مسیری که این راهنما در حال اصلاح آنها بوده، یعنی /usr/share/keyrings/tailscale-archive-keyring.gpg و /etc/apt/sources.list.d/tailscale.list، را از همان URLها مینویسد. این موضوع برای انتظارات شما اهمیت دارد: این روش نمیتواند از مخزنی که توسط پروکسی مسدود شده عبور کند. این روش به همان شکلی که روشهای قبلی شکست میخورند، با خروجی کمتر، شکست میخورد. پایپ کردن (pipe) یک اسکریپت دانلود شده به یک shell با دسترسی root یک معامله است، نه یک راهحل؛ زیرا شما به هر آنچه سرور در آن لحظه بازمیگرداند اعتماد میکنید و هیچ نسخهای از آنچه اجرا شده نگه نمیدارید. اگر این معامله را میپذیرید، با آگاهی کامل آن را انجام دهید:
curl -fsSL https://tailscale.com/install.sh -o install.sh
less install.sh
sh install.shفایلهای باینری استاتیک. همان سرور، فایلهای tarball ساده را در بخش static binaries در pkgs.tailscale.com/stable منتشر میکند. تا تاریخ 3 نوامبر 2026، نسخه پایدار 1.104.5 است که در 2 نوامبر منتشر شده و فایل 64 بیتی x86 آن tailscale_1.104.5_amd64.tgz است. این صفحه همچنین لینکی برای نسخههای قدیمیتر دارد. شما خودتان کلاینت tailscale و دیمون tailscaled را در جای مناسب قرار میدهید و خودتان بر دیمون نظارت میکنید، بنابراین هیچ مسیر apt upgrade وجود ندارد؛ نسخه 1.104.5 از بهروزرسانی یک نصب استاتیک با sudo tailscale update از طریق دانلود یک tarball جایگزین پشتیبانی میکند. این روش برای یک میزبان air-gapped یا زمانی که باید یک نسخه دقیق را ثابت نگه دارید، مناسب است.
بسته اختصاصی اوبونتو. هنگام بررسی در اکتبر 2026، آرشیو هیچ فایل deb برای tailscale نداشت، بنابراین sudo apt install tailscale بدون مخزن فروشنده به E: Unable to locate package tailscale ختم میشد. Canonical یک snap منتشر میکند که با sudo snap install tailscale نصب میشود و چون از Snap Store میآید، از تمام خطاهای apt ذکر شده در بالا اجتناب میکند. در بررسی مورخ 3 نوامبر 2026، کانال 1/stable آن نسخه 1.102.3 را ارائه میداد که قدیمیتر از نسخه 1.104.5 فعلی Tailscale است و در توضیحات آن ذکر شده که توسط Canonical نگهداری میشود و لزوماً مورد تأیید توسعهدهندگان اصلی نیست. این بسته طبق زمانبندی snapd بهروزرسانی میشود که مدیریت بهروزرسانیهای snap در Ubuntu Server نحوه کنترل آن را توضیح میدهد. اگر آنچه واقعاً میخواهید یک سرور هماهنگکننده تحت کنترل خودتان است و نه سرور میزبانیشده توسط Tailscale، این یک تصمیم جداگانه است: اجرای Headscale به عنوان سرور کنترل شخصی آن را پوشش میدهد و مقایسه بین Tailscale و WireGuard ساده بررسی میکند که آیا اصلاً به این تجهیزات نیاز دارید یا خیر.
بسته نصب شد، اما tailscaled اجرا نمیشود
پس از اینکه apt با موفقیت عملیات را به پایان رساند، خطاها به daemon منتقل میشوند.
systemctl status tailscaled
sudo journalctl -u tailscaled -n 50در یک VPS که از مجازیسازی کانتینری با هسته مشترک (مانند LXC یا OpenVZ) استفاده میکند، نبود /dev/net/tun در لاگ به این معنی است که کانتینر به دستگاه TUN دسترسی ندارد. این daemon برای ایجاد رابط tailscale0 به دستگاه TUN نیاز دارد، اما این دستگاه در اختیار کانتینر قرار نگرفته است. از ارائهدهنده خدمات خود بخواهید TUN را برای کانتینر فعال کند، یا به یک پلن KVM مهاجرت کنید که در آن هسته اختصاصی خود را دارید. در KVM، سیستمعامل مهمان همچنان به ماژول هسته tun نیاز دارد؛ مستندات لینوکس Tailscale توصیه میکند در صورت نبود این ماژول، آن را با دستور sudo modprobe tun بارگذاری کنید.
پس از آن، sudo tailscale up یک URL برای ورود چاپ میکند و tailscale status باید دستگاه شما را با آدرسی در محدوده 100.64.0.0/10 فهرست کند. دستگاهی که در آنجا ظاهر میشود، دستگاهی است که میتوانید بر پایه آن اقدام کنید؛ خواه این اقدام تبلیغ یک زیرشبکه خصوصی از VPS باشد یا استفاده از VPS به عنوان exit node.
FAQ
چرا apt میگوید مخزن Tailscale امضا نشده است؟
زیرا apt فهرست مخزن را دانلود کرده اما نتوانسته امضای آن را با /usr/share/keyrings/tailscale-archive-keyring.gpg تأیید کند. دلیل معمول این است که keyring صفر بایت است: sudo tee فایل را پیش از آنکه curl موفق به دانلود چیزی شود قطع کرده و pipeline به دلیل موفقیت tee، وضعیت موفقیت گزارش داده است. دستور gpg --show-keys /usr/share/keyrings/tailscale-archive-keyring.gpg را اجرا کنید. یک keyring سالم، یک خط pub و یک خط uid که نام Tailscale را دارد چاپ میکند، در حالی که یک فایل خالی یا خراب، gpg: no valid OpenPGP data found. را چاپ میکند. کلید را در یک فایل موقت دانلود کنید، آن را بررسی کرده و سپس با مجوز 0644 در جای خود کپی کنید تا کاربر _apt بتواند آن را بخواند.
کدام نام رمز (codename) اوبونتو را باید در URLهای Tailscale قرار دهم؟
از مقدار UBUNTU_CODENAME در /etc/os-release استفاده کنید که در Ubuntu 24.04 برابر با noble، در Ubuntu 26.04 برابر با resolute و در Ubuntu 26.10 برابر با stonking است. در توزیعهای مشتقشده از اوبونتو از lsb_release -cs استفاده نکنید: در Linux Mint 22 این دستور wilma را چاپ میکند، Tailscale هیچ چیزی تحت این نام منتشر نمیکند و apt خطای 404 را در dists/wilma/InRelease گزارش میدهد. پیش از ویرایش هر فایلی، انتخاب خود را با دریافت دستی فهرست توسط curl -sS -o /dev/null -w '%{http_code}\n' از https://pkgs.tailscale.com/stable/ubuntu/dists/<codename>/InRelease تأیید کنید.
آیا اجرای اسکریپت نصب Tailscale از طریق pipe به shell امن است؟
این معاملهای است که باید آگاهانه انجام دهید. اسکریپت از طرف Tailscale ارائه شده و همان کارهای مراحل دستی را انجام میدهد: /etc/os-release را میخواند، همان keyring و همان /etc/apt/sources.list.d/tailscale.list را مینویسد و سپس بسته را نصب میکند. هزینه این کار این است که شما هر چه سرور در آن لحظه بازمیگرداند را با دسترسی root اجرا میکنید و هیچ رکوردی از آن نگه نمیدارید. آن را با -o install.sh دانلود کنید، بخوانید و اگر راحتی کار را بدون ریسک ناشناخته میخواهید، سپس آن را اجرا کنید. این روش همچنین برای مخازن مسدود شده کمکی نمیکند، زیرا از همان URLهایی استفاده میکند که قبلاً با شکست مواجه شدهاند.
چگونه Tailscale را روی اوبونتو بدون مخزن apt نصب کنم؟
دو راه پیش رو دارید. اولی snap است که توسط Canonical نگهداری میشود، sudo snap install tailscale، که تا تاریخ 3 نوامبر 2026 نسخه 1.102.3 را در کانال 1/stable خود داشت و لزوماً توسط Tailscale تأیید نشده است. دومی فایلهای tarball استاتیک منتشر شده در pkgs.tailscale.com است که تا تاریخ 3 نوامبر 2026 در نسخه 1.104.5 با فایل amd64 به نام tailscale_1.104.5_amd64.tgz قرار دارند. با استفاده از tarballها، برنامههای tailscale و tailscaled را خودتان نصب کرده و daemon را تحت systemd اجرا میکنید. هیچ بسته apt برای دریافت نسخه جدید وجود ندارد، اما نسخه 1.104.5 از sudo tailscale update برای نصبهای استاتیک پشتیبانی میکند. در بررسی اکتبر 2026، آرشیو اوبونتو هیچ بسته deb برای tailscale نداشت، بنابراین sudo apt install tailscale روی دستگاهی بدون مخزن اصلی، در نسخه E: Unable to locate package tailscale متوقف شد.