رفع خطاهای نصب Tailscale در Ubuntu

چرا خطاهای نصب Tailscale در Ubuntu در واقع خطاهای apt هستند

خطاهای نصب Tailscale در Ubuntu تقریباً همیشه پیش از اجرای هرگونه کد Tailscale رخ می‌دهند. این‌ها خطاهای apt هستند. Ubuntu هیچ بسته tailscale اختصاصی ارائه نمی‌دهد: با بررسی آرشیو بسته‌های Ubuntu در اکتبر 2026، تنها موارد منطبق، کتابخانه‌های کمکی Go و python3-tailscale هستند، بنابراین daemon باید از مخزن apt اختصاصی Tailscale در pkgs.tailscale.com دریافت شود.

افزودن این مخزن، دو فایل ایجاد می‌کند. یک فایل به 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 tailscale

noble نام رمز 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.

دو مورد در این خروجی تعیین‌کننده گام بعدی شما هستند: کد وضعیت (status code) و 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 با خطا مواجه شده است، مخزن سالم است و مشکل در پیکربندی خودِ apt قرار دارد.

کد وضعیت چه چیزی را به شما می‌گوید

• 404 Not Found بدین معناست که مخزن در آن مسیر فایلی ندارد. در pkgs.tailscale.com این مورد تقریباً همیشه به نام رمز (codename) در URL مربوط می‌شود.
• 403 Forbidden بدین معناست که سرویس پاسخ داده اما دسترسی را رد کرده است. از اکتبر 2026، این مخزن برای مسیرهایی که در اختیار ندارد کد 404 برمی‌گرداند؛ بنابراین کد 403 نشان‌دهنده وجود یک پروکسی، ابزار فیلترینگ یا فایروال بین سرور شما و Tailscale است.
• 401 Unauthorized یا 407 Proxy Authentication Required بدین معناست که یک پروکسی درخواست اعتبارنامه‌هایی را دارد که apt آن‌ها را ارسال نمی‌کند.
• خطای اتصال (connect error) یا خطای حل نام (name resolution error) بدین معناست که هیچ گفتگوی HTTP انجام نشده است. به بخش IPv6 بروید.

نام رمز در URL چیزی است که Tailscale آن را منتشر نمی‌کند

Tailscale برای هر نام رمز Ubuntu یک دایرکتوری جداگانه ایجاد می‌کند. اگر نام رمزی را درخواست کنید که وجود ندارد، با خطای 404 مواجه می‌شوید، زیرا هیچ dists/<codename> روی سرور برای پاسخ‌دهی وجود ندارد. لیست رسمی ارائه‌شده توسط سازنده در pkgs.tailscale.com/stable نشان می‌دهد که کدام نسخه‌ها موجود هستند. در اکتبر 2026، این لیست از 16.04 تا resolute، که همان Ubuntu 26.04 است، گسترده شده است.

روش معمول برای ورود یک نام رمز اشتباه، استفاده از lsb_release -cs در توزیعی است که بر پایه Ubuntu است اما خود Ubuntu نیست. در Linux Mint 22، این دستور wilma را چاپ می‌کند که نام رمز اختصاصی Mint است و Tailscale هیچ بسته‌ای برای آن منتشر نمی‌کند. در عوض، نسخه پایه Ubuntu را بخوانید.

. /etc/os-release
echo "$VERSION_CODENAME $UBUNTU_CODENAME"

در Ubuntu هر دو مقدار یکسان هستند. در یک توزیع مشتق‌شده، VERSION_CODENAME نام توزیع مشتق‌شده و UBUNTU_CODENAME نسخه Ubuntu است که بر پایه آن ساخته شده است. در هر دو URL از UBUNTU_CODENAME استفاده کنید.

روش دوم، ارتقای نسخه (release upgrade) است. ابزار ارتقای Ubuntu هنگام اجرا، منابع شخص ثالث را غیرفعال می‌کند، بنابراین پس از ارتقای Ubuntu 24.04 به 26.04 متوجه می‌شوید که /etc/apt/sources.list.d/tailscale.list یا کامنت شده است و یا همچنان به noble اشاره دارد، در حالی که سیستم اکنون resolute است. این مشکل را با اجرای مجدد دو دستور curl با نام رمز جدید برطرف کنید تا هر دو فایل بازنویسی شوند. اگر خودِ فرآیند ارتقا در میانه راه متوقف شده است و dpkg به جای این مخزن، از بسته‌های ناقص پیکربندی‌شده شکایت دارد، ابتدا ارتقای ناموفق نسخه را بازیابی کنید، زیرا هیچ اصلاحی برای tailscale.list روی سیستمی که apt نمی‌تواند پیکربندی آن را به پایان برساند، پایدار نخواهد بود.

روش سوم، زمان‌بندی است. در هفته‌های پس از انتشار یک نسخه جدید Ubuntu، نام رمز در Canonical وجود دارد اما هنوز در Tailscale ایجاد نشده است. اشاره دادن فایل به نام رمز LTS قبلی معمولاً منجر به نصب می‌شود، زیرا این بسته‌ها وابستگی‌های کمی دارند، اما در این حالت شما در حال اجرای بیلد ساخته‌شده برای یک نسخه قدیمی‌تر هستید. با استفاده از 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 وجود ندارد: این URL خطای 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 برمی‌گرداند

از آنجا که مسیرهای موجود در این مخزن خطای 404 برنمی‌گردانند، دریافت خطای 403 به این معناست که پاسخ از سوی منبع دیگری ارسال شده است. ابتدا پیکربندی خود 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 را برمی‌گرداند، این دو درخواست در پارامتری که برای دستگاه میانی (middlebox) اهمیت دارد تفاوت دارند؛ معمول‌ترین عامل در این موارد، 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 را می‌دهد، یک ابزار فیلترینگ در حال مسدود کردن apt بر اساس نام آن است. راه‌حل این مشکل باید در همان دستگاه اعمال شود، نه روی سرور شما. یک پروکسی سازمانی که ترافیک TLS را بازرسی می‌کند، رفتار متفاوتی دارد: در این حالت، apt به‌جای کد وضعیت، خطای تأیید گواهی (certificate verification failure) گزارش می‌دهد، زیرا گواهی دریافتی توسط پروکسی صادر شده است و نه توسط مرجع صدور گواهی Tailscale. فایروال خروجی ابری (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 را گزارش می‌کند، apt به این دلیل شکست می‌خورد که کتابخانه resolver اولویت را به IPv6 می‌دهد و سرور مسیر IPv6 فعالی ندارد. برای تأیید این فرضیه، یک بار اجرا را روی IPv4 اجبار کنید:

sudo apt -o Acquire::ForceIPv4=true update

اگر آن به‌روزرسانی موفقیت‌آمیز بود، آن را دائمی کنید.

echo 'Acquire::ForceIPv4 "true";' | sudo tee /etc/apt/apt.conf.d/99force-ipv4

در مورد حالت عکس، صادق باشید. روی یک VPS که اصلاً آدرس IPv4 ندارد، اجبار به استفاده از IPv4 هیچ مشکلی را حل نمی‌کند، زیرا مسیر IPv4ای برای هدایت ترافیک وجود ندارد. در آنجا به NAT64 همراه با DNS64 از سمت ارائه‌دهنده خود نیاز دارید، یا یک پروکسی که دارای آدرس IPv4 باشد. نشانه این مشکل، خطای اتصال (connect error) است که یک آدرس 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ها می‌نویسد. این موضوع برای انتظارات شما اهمیت دارد: این روش نمی‌تواند از مخزنی که توسط پروکسی مسدود شده عبور کند. این روش دقیقاً به همان شکل شکست می‌خورد، با این تفاوت که خروجی کمتری ارائه می‌دهد. پایپ کردن یک اسکریپت دانلود شده به یک 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 منتشر می‌کند. تا اکتبر 2026، نسخه پایدار 1.102.4 است و فایل 64 بیتی x86 با نام tailscale_1.102.4_amd64.tgz شناخته می‌شود. شما خودتان کلاینت tailscale و دیمون tailscaled را در جای مناسب قرار می‌دهید و خودتان بر دیمون نظارت می‌کنید، بنابراین هیچ مسیر apt upgrade وجود ندارد و هر به‌روزرسانی در آینده، دانلودی است که باید خودتان آن را به یاد داشته باشید. این روش برای میزبان‌های air-gapped یا زمانی که باید یک نسخه دقیق را ثابت نگه دارید، مناسب است.

بسته اختصاصی اوبونتو. چنین بسته‌ای وجود ندارد. اجرای sudo apt install tailscale بدون پیکربندی مخزن ارائه‌دهنده، به E: Unable to locate package tailscale ختم می‌شود و هیچ مقدار apt update این وضعیت را تغییر نمی‌دهد. اگر آنچه واقعاً می‌خواهید یک سرور هماهنگ‌کننده تحت کنترل خودتان است و نه سرور میزبانی‌شده توسط Tailscale، این یک تصمیم جداگانه است: اجرای Headscale به عنوان سرور کنترل شخصی این موضوع را پوشش می‌دهد و مقایسه بین Tailscale و WireGuard ساده بررسی می‌کند که آیا اصلاً به این تشکیلات نیاز دارید یا خیر.

بسته نصب شد، اما tailscaled اجرا نمی‌شود

هنگامی که apt با موفقیت به پایان می‌رسد، خطاها به daemon منتقل می‌شوند.

systemctl status tailscaled
sudo journalctl -u tailscaled -n 50

در یک VPS که از مجازی‌سازی کانتینری با هسته (kernel) مشترک با میزبان استفاده می‌کند، مانند LXC یا OpenVZ، لاگ‌ها شامل خطایی مبنی بر عدم وجود /dev/net/tun هستند. این daemon برای ایجاد رابط tailscale0 به یک دستگاه TUN نیاز دارد، اما این دستگاه به کانتینر اختصاص داده نشده است. از ارائه‌دهنده خود بخواهید TUN را روی کانتینر فعال کند، یا به یک پلن KVM مهاجرت کنید که در آن هسته اختصاصی خود را دارید. در KVM، این مورد بدون نیاز به تنظیمات اضافی کار می‌کند.

پس از آن، 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 موفق به دانلود چیزی شود قطع کرده و خط لوله به دلیل موفقیت tee، وضعیت موفقیت گزارش داده است. دستور gpg --show-keys /usr/share/keyrings/tailscale-archive-keyring.gpg را اجرا کنید. یک keyring سالم، یک خط pub و یک خط uid که نام Tailscale را دارد چاپ می‌کند، در حالی که یک فایل خالی یا خراب، gpg: no valid OpenPGP data found. را چاپ می‌کند. کلید را در یک فایل موقت دانلود کنید، آن را بررسی کنید و سپس با مجوز 0644 در جای خود کپی کنید تا کاربر _apt بتواند آن را بخواند.

در URLهای Tailscale باید از کدام نام رمز (codename) اوبونتو استفاده کنم؟

از مقدار UBUNTU_CODENAME در فایل /etc/os-release استفاده کنید که در Ubuntu 24.04 برابر با noble و در Ubuntu 26.04 برابر با resolute است. در توزیع‌های مشتق‌شده از اوبونتو از 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 نصب کنم؟

از tarballهای استاتیک منتشر شده در pkgs.tailscale.com استفاده کنید که تا اکتبر 2026 در نسخه 1.102.4 با فایل amd64 به نام tailscale_1.102.4_amd64.tgz موجود هستند. شما باید برنامه‌های tailscale و tailscaled را خودتان نصب کنید و daemon را تحت systemd اجرا نمایید. هزینه این کار، به‌روزرسانی‌ها است: هیچ بسته apt برای دریافت نسخه جدید وجود ندارد، بنابراین هر به‌روزرسانی دستی است. آرشیو اوبونتو هیچ بسته tailscale داخلی ندارد، بنابراین sudo apt install tailscale روی سیستمی که مخزن رسمی فروشنده را ندارد، در E: Unable to locate package tailscale متوقف می‌شود.