Jinsi ya kurekebisha hitilafu za Tailscale kwenye Ubuntu
Hitilafu nyingi za usakinishaji wa Tailscale kwenye Ubuntu hutokana na matatizo ya apt. Jifunze jinsi ya kusahihisha codename au ufunguo wa keyring ili kutatua tatizo.
Kwa nini makosa ya usakinishaji wa Tailscale kwenye Ubuntu ni makosa ya apt
Makosa ya usakinishaji wa Tailscale kwenye Ubuntu karibu kila mara hutokea kabla ya msimbo wowote wa Tailscale kuendeshwa. Haya ni makosa ya apt. Inapokaguliwa dhidi ya kumbukumbu ya vifurushi vya Ubuntu mnamo Oktoba 2026, hapakuwa na kifurushi cha tailscale: vinavyolingana pekee vilikuwa maktaba za usaidizi za Go na python3-tailscale. Kwa hivyo, daemon kwa kawaida hutoka kwenye hazina (repository) ya apt ya Tailscale yenyewe katika pkgs.tailscale.com. Canonical pia hudumisha snap ya Tailscale, ambayo imeshughulikiwa pamoja na njia nyingine mbadala karibu na mwisho.
Kuongeza hazina hiyo huandika faili mbili. Faili moja huiambia apt mahali vifurushi vinapopatikana. Nyingine hushikilia ufunguo wa umma (public key) ambao apt hutumia kukagua sahihi kwenye faharasa ya hazina. Karibu kila hitilafu iliyo hapa chini ni mojawapo ya faili hizo mbili kuwa na makosa, au kifaa kilicho kati ya apt na hazina kukataa ombi hilo.
Hizi ndizo amri ambazo Tailscale huchapisha kwa ajili ya 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 ndilo jina la msimbo (codename) kwa ajili ya Ubuntu 24.04, na linaonekana katika URL zote mbili. Amri ya pili huandika mstari wa maoni na mstari mmoja wa deb ndani ya /etc/apt/sources.list.d/tailscale.list, na cat hukuonyesha sawasawa kile kilichowekwa hapo.
cat /etc/apt/sources.list.d/tailscale.listSoma mstari huo wa deb kama anwani katika sehemu nne: chaguo lililo kwenye mabano [signed-by=/usr/share/keyrings/tailscale-archive-keyring.gpg], kisha msingi wa hazina, ambao ni pkgs.tailscale.com/stable/ubuntu unaofikiwa kupitia https, kisha suite noble, kisha sehemu main. apt huunganisha msingi na suite kuwa URL moja na kuipakua: https://pkgs.tailscale.com/stable/ubuntu/dists/noble/InRelease. Kupakua URL hiyo kwa mkono hujaribu ombi hilo; haithibitishi kuwa ombi la apt litafanikiwa.
Soma hitilafu ya apt kabla ya kubadilisha chochote
Tekeleza update peke yake ili ujumbe wa hitilafu usipotee kwa kusogezwa na maandishi mengine.
sudo apt updateHifadhi (repository) ya wahusika wengine iliyoshindwa kufanya kazi huonekana hivi. Codename na anwani ya IP vitatofautiana kwenye mashine yako.
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.Mambo mawili katika matokeo hayo huamua hatua unayopaswa kuchukua: status code, na URL kamili iliyo kwenye mstari wa E: Failed to fetch. Usikisie kulingana na mstari wa muhtasari ulio chini. Nakili URL hiyo na uulize seva mwenyewe.
curl -sS -o /dev/null -w '%{http_code}\n' https://pkgs.tailscale.com/stable/ubuntu/dists/noble/InReleaseHiyo huchapisha 200 kwa ajili ya codename ambayo Tailscale huchapisha. Ikiangaliwa mnamo Oktoba 2026, noble hurejesha index iliyotiwa saini yenye Origin: Tailscale na Codename: noble. Badilisha noble na codename inayotokana na hitilafu yako mwenyewe na uikimbize tena. Ikiwa curl itapata 200 ambapo apt ilipata hitilafu ya fetch, hifadhi hiyo ilijibu ombi la curl, lakini hiyo haithibitishi kuwa apt imesanidiwa vibaya: uchujaji kwenye huduma au njiani unaweza kutofautisha maombi kwa kutumia vichwa (headers) kama vile user agent. Hata hivyo, 200 inathibitisha tu kuwa upakuaji ulifanya kazi: apt bado hukagua saini kwenye index hiyo baada ya kuipakua, na tatizo la ufunguo (key) hushindwa hapo, jambo ambalo sehemu ya keyring hapa chini inalishughulikia.
Nini msimbo wa hali unakuambia
404 Not Foundinamaanisha seva haikupata faili kwenye njia hiyo, au haiko tayari kufichua kuwa faili hiyo ipo. Kwenyepkgs.tailscale.com, ambayo hutoa faili zake bila kuhitaji vitambulisho, hiyo karibu kila mara ni jina la msimbo (codename) kwenye URL.403 Forbiddeninamaanisha kitu fulani kilijibu na kukataa. Msimbo 403 pekee hautambui kama kukataa huko kulitoka kwa proxy, kifaa cha kuchuja (filtering appliance), au firewall iliyo kati ya seva yako na Tailscale, au kutoka kwa huduma yenyewe. AWS inaeleza kuwa CloudFront distribution inaweza kurejesha 403 kutoka upande wake pia, kwa mfano kutokana na sheria ya firewall au seva asilia (origin server).407 Proxy Authentication Requiredinamaanisha proxy inahitaji uthibitisho kwa ombi hili: aidha apt haikutuma vitambulisho vya proxy, au ilituma vitambulisho ambavyo proxy ilivikataa kama batili au visivyokamilika.401 Unauthorizedni tofauti: ni changamoto ya kuomba vitambulisho kwa ajili ya rasilimali iliyoombwa yenyewe, iliyotumwa na header yaWWW-Authenticate, na kwa yenyewe haitambui proxy. Hifadhi hii hutoa faili zake bila vitambulisho, kwa hivyo 401 kwa kawaida inamaanisha kitu kingine kilijibu kwa URL hiyo, kama vile gateway inayozuia mawasiliano (intercepting gateway). Amri ya debug katika sehemu ya proxy inaonyesha ni host ipi ambayo apt ilifikia kweli.- Hitilafu ya muunganisho (connect error) au hitilafu ya utatuzi wa jina (name resolution error) inamaanisha hakuna mazungumzo ya HTTP yaliyotokea kabisa. Rukia sehemu ya IPv6.
Codename iliyo kwenye URL ni ile ambayo Tailscale haijachapisha
Tailscale hutengeneza saraka tofauti kwa kila codename ya Ubuntu. Ukiomba codename isiyokuwepo utapata 404, kwa sababu hakuna dists/<codename> kwenye seva ya kuikuhudumia. Orodha ya muuzaji mwenyewe iliyo kwenye pkgs.tailscale.com/stable inaonyesha zipi zipo. Mnamo Oktoba 2026 orodha hiyo inaanza kutoka 16.04 hadi stonking, ambayo ni Ubuntu 26.10, ikiwa na resolute, ambayo ni Ubuntu 26.04, moja kwa moja chini yake.
Njia ya kawaida ya codename isiyo sahihi kuingia ni lsb_release -cs kwenye usambazaji (distribution) unaotegemea Ubuntu lakini si Ubuntu. Kwenye Linux Mint 22 amri hiyo huchapisha wilma, ambayo ni codename ya Mint yenyewe, na Tailscale haichapishi chochote kwa ajili yake. Soma msingi wa Ubuntu badala yake.
. /etc/os-release
echo "$VERSION_CODENAME $UBUNTU_CODENAME"Kwenye Ubuntu thamani zote mbili ni sawa. Kwenye toleo linalotokana na Ubuntu (derivative), VERSION_CODENAME ni jina la toleo hilo na UBUNTU_CODENAME ni toleo la Ubuntu lililojengwa juu yake. Tumia UBUNTU_CODENAME kwenye URL zote mbili.
Njia ya pili ni uboreshaji wa toleo (release upgrade). Zana ya kuboresha ya Ubuntu huzima vyanzo vya watu wengine (third-party sources) inapoendeshwa, kwa hivyo baada ya kuboresha Ubuntu 24.04 hadi 26.04 utapata /etc/apt/sources.list.d/tailscale.list ikiwa imewekewa alama ya maoni (commented out) au bado inataja noble kwenye mashine ambayo sasa ni resolute. Rekebisha kwa kuendesha tena amri mbili za curl na codename mpya, ambazo zitafuta na kuandika upya faili zote mbili. Ikiwa uboreshaji wenyewe ulikwama katikati, hivi kwamba dpkg inalalamika kuhusu vifurushi vilivyosanidiwa nusu na si hifadhi (repository) hii pekee, rejesha uboreshaji wa toleo ulioshindwa kwanza, kwa sababu hakuna marekebisho ya tailscale.list yatakayodumu kwenye mfumo ambao apt haiwezi kumaliza kusanidi.
Njia ya tatu ni muda. Ukisakinisha kwenye toleo jipya la Ubuntu kabla ya Tailscale kuongeza codename yake, utapata 404 ileile. Dirisha hilo mara nyingi huwa fupi au halipo: suala la ufuatiliaji la Tailscale kwa ajili ya usaidizi wa usakinishaji wa Ubuntu 24.04 lilifungwa kama limetekelezwa mnamo Januari 2024, miezi kadhaa kabla ya toleo hilo kutolewa. Kwa Ubuntu 26.10, iliyokaguliwa tarehe 24 Oktoba 2026, dists/stonking/InRelease ilirejesha index iliyotiwa saini yenye Origin: Tailscale na Codename: stonking, kwa hivyo ikiwa uliona 404 kwa stonking awali, iite tena kabla ya kutafuta njia mbadala. Ikiwa utaingia kwenye dirisha hilo, kuelekeza faili kwenye codename ya awali ya LTS kwa kawaida husakinisha, kwa sababu vifurushi hivi havina utegemezi mwingi, lakini kuchagua hifadhi hiyo hakuchagui ujenzi (build) mahususi wa toleo la Ubuntu: ujenzi wa deb wa Tailscale unalenga usanifu wa Linux kama amd64 na arm64. Angalia ulichopata kweli kwa apt policy tailscale, na urudishe faili mahali pake codename halisi itakapoonekana.
Keyring haina kitu, na amri iliyoandika haikutoa ujumbe wowote
Hali hii huwa kimya, na ndipo makosa mengi yanapofikia mwisho. Angalia tena amri ya keyring:
curl -fsSL https://pkgs.tailscale.com/stable/ubuntu/noble.noarmor.gpg | sudo tee /usr/share/keyrings/tailscale-archive-keyring.gpg >/dev/nullShell hujenga pipeline nzima kabla ya programu yoyote kuanza, kwa hivyo sudo tee hufungua njia ya keyring na kuifuta hadi kufikia baiti sifuri mara moja. Ikiwa curl itafeli, na -f ikaisababisha ifeli kwenye kosa lolote la HTTP, curl haitaandika chochote na itatoka kwa status isiyo sifuri. Faili hubaki na baiti sifuri. Exit status ya pipeline ni status ya amri yake ya mwisho, ambayo ni tee, iliyofanikiwa. Hakuna kinachochapishwa, na unaendelea na amri inayofuata ukiamini kuwa ufunguo umewekwa.
Kagua faili, si amri iliyoiunda.
ls -l /usr/share/keyrings/tailscale-archive-keyring.gpg
gpg --show-keys /usr/share/keyrings/tailscale-archive-keyring.gpgKeyring iliyo sawa huchapisha mstari wa pub na mstari wa uid unaotaja Tailscale. Faili yenye baiti sifuri huchapisha gpg: no valid OpenPGP data found. na hakuna kingine. Faili iliyopokea ukurasa wa kosa la HTML huchapisha kitu kilekile, na head -c 80 juu yake huonyesha mwanzo wa ukurasa wa wavuti badala ya data ya ufunguo wa binary.
Ukiwa na keyring isiyo na ufunguo unaoweza kutumika, sudo apt update hupakua index kisha huikataa. Utapata mstari wa W: GPG error unaotaja Tailscale repository na suite yake, maandishi The following signatures couldn't be verified because the public key is not available: NO_PUBKEY yakifuatiwa na kitambulisho cha ufunguo cha herufi 16, na chini yake kosa linalosema kuwa repository haijasainiwa. Kumbuka kile apt kinachokuambia: kimepakua index vizuri, na hakikuweza kuhakiki sahihi. Hilo ni tatizo la ufunguo, si tatizo la mtandao. Ikiwa faili ya keyring haipo kabisa, ujumbe huwa tofauti tena, na hutaja njia hiyo moja kwa moja na Could not open file /usr/share/keyrings/tailscale-archive-keyring.gpg.
Andika ufunguo kwa hatua mbili ili upakuaji ulioshindwa usiharibu keyring inayofanya kazi.
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.gpgMstari wa katikati ndio kizuizi: ikiwa hauchapishi uid ya Tailscale, simama na usinakili faili hiyo. Mode 0644 ni muhimu kwa sababu apt hushuka hadi kwa mtumiaji asiye na upendeleo wa _apt ili kupakua na kuhakiki, kwa hivyo keyring ambayo root pekee anaweza kuisoma ni keyring ambayo apt haiwezi kuitumia.
Faili za .list na .sources zote mbili zinaelezea hazina (repository) moja
Ubuntu ilihamishia vyanzo vyake kwenye umbizo la deb822 katika Ubuntu 24.04 LTS, ambapo /etc/apt/sources.list ilibadilika kuwa /etc/apt/sources.list.d/ubuntu.sources. Tailscale bado inachapisha umbizo la mstari mmoja. Ilipokaguliwa mnamo Oktoba 2026, URL husika ya .sources kwenye pkgs.tailscale.com ilirejesha 404. Ikiwa mashine yako ina tailscale.sources na tailscale.list zinazoelezea hazina moja, apt sasa ina hazina hiyo ikiwa imeelezewa mara mbili.
Toleo dogo ni onyo katika kila sasisho:
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:1Toleo kali hutokea wakati faili hizo mbili zinataja njia tofauti za keyring, kwa sababu apt haiwezi kuamua ni ufunguo upi unaosimamia hazina hiyo. Inachapisha E: Conflicting values set for option Signed-By regarding source, ikifuatiwa na hazina na suite yake, kisha njia mbili za keyring zikiwa na != katikati, na kisha inakataa kuendelea:
E: The list of sources could not be read.Hiyo inazuia kila amri ya apt, si sasisho pekee, hadi moja ya faili hizo iondolewe. Hitilafu hiyo hiyo huonekana na hazina za Ubuntu zenyewe, na hitilafu ya chanzo cha apt kilichorudiwa baada ya uhamiaji wa deb822 inaelezea hatua za kushughulikia hali hiyo kwa ujumla.
Tafuta kila faili inayotaja Tailscale kabla ya kufuta kitu chochote.
grep -RIn tailscale /etc/apt/sources.list /etc/apt/sources.list.d/Hifadhi faili moja. Ili kuzima nyingine bila kuipoteza, ibadilishe jina: apt inasoma tu faili zinazoishia na .list au .sources, kwa hivyo tailscale.list.bak inarukwa na kubaki kwenye diski kwa ajili ya marejeleo.
Kuandika faili ya chanzo ya deb822 kwa usahihi
Ikiwa unapendelea umbizo jipya zaidi, badilisha faili uliyonayo badala ya kuandika upya anwani ya hazina (repository), kwa sababu kosa la uchapaji hapo ndilo hasa chanzo cha hitilafu zilizotajwa hapo juu. Matoleo mapya ya apt yana kigeuzi kinachobadilisha faili za .list kuwa stanzas za deb822 na kuhamisha chaguo la signed-by kama Signed-By.
apt modernize-sources --help
sudo apt modernize-sourcesUbuntu 24.04 inakuja na apt ya toleo la awali kabla ya subcommand hiyo, kwa hivyo mstari wa usaidizi utakuambia mara moja ikiwa toleo lako inayo. Pale ambapo haipo, jenga stanza hiyo kutoka kwenye mstari uliopo tayari kwenye diski, ili msingi utoke kwenye faili ya muuzaji badala ya kibodi yako.
. /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.listHiyo huchapisha stanza iliyoandikwa, ili uweze kusoma sehemu (fields) hizo kabla ya apt update inayofuata. Nne kati ya hizo zinafaa kufahamika kwa kina, kwa sababu kila moja hushindwa kufanya kazi kwa njia tofauti:
URIshuishia kwenye msingi wa hazina. Kubandika sehemu yadists/noblendani yake husababisha 404, kwa sababu apt huongezadists/<suite>yenyewe na kuombadists/noble/dists/noble.Suitesni codename, thamani ileile iliyokuwa katikati ya umbizo la mstari mmoja.Signed-Byhuchukua njia kamili (absolute path) kuelekea faili ya keyring. Pia inakubali ufunguo uliolindwa (armored key) uliowekwa ndani yake, ambapo kila mstari wa ufunguo huingizwa nafasi moja (indented) na kila mstari tupu ndani ya ufunguo huandikwa kama nukta moja.Enabled: nohuzima chanzo bila kukifuta, jambo ambalo ni rahisi zaidi kuliondoa kuliko kubadili jina na ni rahisi zaidi kumwelezea mtu mwingine.
Weka stanza moja kwa kila faili kwa ajili ya hazina za watu wengine, na uweke mstari tupu kati ya stanza ikiwa utahifadhi kadhaa pamoja. Kielezo cha hazina huorodhesha amd64 na arm64 miongoni mwa usanifu wake (architectures), kwa hivyo ARM VPS haihitaji sehemu ya ziada ya Architectures.
Proxy iliyo katikati inarejesha 403
Ujumbe wa 403 unamaanisha kuwa ombi limekataliwa, lakini haubainishi mahali ambapo kukataliwa huko kumetokea: kifaa kilichopo kati ya seva yako na Tailscale au uchujaji (filtering) kwenye huduma yenyewe unaweza kuurejesha. Anza na usanidi wa apt, kwa sababu proxy iliyowekwa hapo inatumika kwa apt na si kwa curl yako ya kawaida.
grep -RIn -i proxy /etc/apt/apt.conf.d/ /etc/apt/apt.conf
sudo apt-config dump | grep -i 'acquire::http'Kisha fuatilia kile ambacho apt inatuma kihalisi.
sudo apt -o Debug::Acquire::http=1 updateHii inachapisha mstari wa ombi, vichwa (headers) vilivyotumwa na apt, na proxy iliyotumika kuunganisha, kama ipo. Ilinganishe na curl ya kawaida kwenye URL hiyo hiyo. Ikiwa curl inarejesha 200 na apt inarejesha 403, linganisha vichwa vya ombi pamoja na mipangilio ya proxy; uchujaji kwenye huduma au njiani unaweza kutofautisha 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/InReleaseIkiwa hiyo inarejesha 403 wakati curl ya kawaida inarejesha 200, jibu linatofautiana kulingana na user agent, lakini jaribio hili halibainishi mahali ambapo kichujio kipo. Kagua sheria za uchujaji kwenye mtandao wako, na uripoti majibu yanayotofautiana kwa Tailscale ikiwa sheria hizo hazielezei tofauti hizo. Ikiwa kila ombi kutoka kwa seva yako linapata 403, jaribu kutumia curl hiyo hiyo kutoka kwa mashine iliyo kwenye mtandao tofauti: 200 huko inaonyesha kuwa kukataliwa huko kunategemea mteja au mtandao, lakini sheria za upande wa huduma kama vile vizuizi vya kijiografia zinaweza kusababisha tofauti hiyo pia. Kagua pia ukurasa wa hali ya Tailscale; 403 kutoka kwenye mitandao yote miwili haibainishi mahali ambapo kizuizi kipo. Proxy ya shirika inayokagua TLS inatenda kazi kwa namna nyingine: apt inaripoti hitilafu ya uthibitishaji wa cheti ikiwa mamlaka ya utoaji vyeti (certificate authority) ya proxy hiyo haiaminiki kwenye seva yako. Firewall ya cloud egress inayoruhusu vioo (mirrors) vya Ubuntu pekee ndiyo chanzo kingine cha kawaida, na hapo suluhisho ni kuruhusu pkgs.tailscale.com kwenye firewall.
Egress ya IPv6 pekee, na makosa ambayo si status codes
Ikiwa apt haijapata jibu la HTTP, jaribu kila itifaki kivyake.
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/InReleaseWakati IPv4 inajibu na IPv6 inakwama au kuripoti Network is unreachable, jaribio la IPv6 limeshindikana, lakini hilo pekee halielezi kwa nini apt imeshindwa. APT 2.8 tayari hubadilisha familia za anwani na kuanza jaribio lingine la muunganisho baada ya milisekunde 250 kama chaguo-msingi. Lazimisha utekelezaji mmoja kwenye IPv4 ili kupima kama hilo linabadilisha matokeo ya apt:
sudo apt -o Acquire::ForceIPv4=true updateIkiwa sasisho hilo litafanikiwa, lifanye liwe la kudumu.
echo 'Acquire::ForceIPv4 "true";' | sudo tee /etc/apt/apt.conf.d/99force-ipv4Kuwa mkweli kuhusu hali ya kinyume. Kwenye VPS ambayo haina anwani ya IPv4 kabisa, kulazimisha IPv4 hakurekebishi chochote, kwa sababu hakuna njia ya IPv4 ya kuelekeza trafiki. Ikiwa hazina (repository) haipatikani kupitia IPv6 asilia, unahitaji NAT64 yenye DNS64 kutoka kwa mtoa huduma wako, au proksi inayomiliki anwani ya IPv4. Kosa la muunganisho (connect error) linalotaja anwani ya IPv6 linaonyesha kuwa jaribio la muunganisho wa IPv6 limeshindikana; tumia mstari wa curl -6 kupima njia hiyo kivyake.
Njia mbadala na gharama zake
Hati ya usakinishaji ya muuzaji. curl -fsSL https://tailscale.com/install.sh | sh ndiyo amri inayotangazwa na Tailscale. Unaposoma hati hiyo, inagundua mfumo wako wa uendeshaji kupitia /etc/os-release kisha inaandika njia mbili zilezile ambazo mwongozo huu umekuwa ukizirekebisha, /usr/share/keyrings/tailscale-archive-keyring.gpg na /etc/apt/sources.list.d/tailscale.list, kutoka kwenye URL zilezile. Hili ni muhimu kwa matarajio yako: haikwepi hazina (repository) inayozuiwa na proksi. Inafeli kwa njia ileile huku ikitoa taarifa chache zaidi. Kupeleka hati iliyopakuliwa moja kwa moja kwenye shell kama root ni makubaliano, si suluhisho, kwa sababu unaiamini seva yoyote inayotoa majibu wakati huo na huhifadhi nakala ya kile kilichoendeshwa. Ikiwa utakubali makubaliano hayo, yafanye huku ukiwa na ufahamu kamili:
curl -fsSL https://tailscale.com/install.sh -o install.sh
less install.sh
sh install.shFaili za binary za static. Seva ileile huchapisha tarballs wazi chini ya sehemu ya static binaries ya pkgs.tailscale.com/stable. Kufikia tarehe 3 Novemba 2026 toleo thabiti ni 1.104.5, lililotolewa tarehe 2 Novemba, na faili ya 64 bit x86 ni tailscale_1.104.5_amd64.tgz. Ukurasa huo pia una kiungo cha matoleo ya zamani. Unajiwekea mteja wa tailscale na daemon ya tailscaled mwenyewe, na unaisimamia daemon hiyo mwenyewe, kwa hivyo hakuna njia ya apt upgrade; toleo la 1.104.5 linaunga mkono kusasisha usakinishaji wa static kwa sudo tailscale update kwa kupakua tarball mbadala. Inafaa kwa seva iliyotengwa na mtandao (air-gapped), au unapohitaji kutumia toleo moja mahususi.
Kifurushi cha Ubuntu chenyewe. Ilipokaguliwa mnamo Oktoba 2026, kumbukumbu haikuwa na tailscale deb, kwa hivyo sudo apt install tailscale bila hazina ya muuzaji iliishia kwenye E: Unable to locate package tailscale. Canonical huchapisha snap, inayowekwa kwa sudo snap install tailscale, na kwa sababu inatoka kwenye Snap Store inaepuka kila hitilafu ya apt iliyotajwa hapo juu. Ilipokaguliwa tarehe 3 Novemba 2026, chaneli yake ya 1/stable ilikuwa na 1.102.3, toleo la zamani kuliko 1.104.5 ya sasa ya Tailscale, na orodha inasema inasimamiwa na Canonical na si lazima iwe imeidhinishwa na watengenezaji wa asili. Inasasishwa kulingana na ratiba ya snapd, ambayo kudhibiti masasisho ya snap kwenye Ubuntu Server inaeleza jinsi ya kuisimamia. Ikiwa unachotaka hasa ni seva ya uratibu unayoimiliki badala ya ile inayohifadhiwa na Tailscale, hilo ni uamuzi tofauti: kuendesha Headscale kama seva yako ya udhibiti inalielezea, na ulinganisho kati ya Tailscale na WireGuard ya kawaida inashughulikia kama unahitaji mfumo huu wowote.
Kifurushi kimesakinishwa, lakini tailscaled haianziki
Baada ya apt kukamilisha kazi, hitilafu huhamia kwenye daemon.
systemctl status tailscaled
sudo journalctl -u tailscaled -n 50Kwenye VPS inayotumia container virtualization inayoshiriki kernel ya mwenyeji, kama vile LXC au OpenVZ, /dev/net/tun inayokosekana kwenye logi inamaanisha kuwa container haina kifaa cha TUN. Daemon inahitaji kifaa cha TUN ili kuunda interface ya tailscale0, na container haikupewa kifaa hicho. Mwambie mtoa huduma wako awashe TUN kwenye container hiyo, au hamia kwenye mpango wa KVM ambapo utapata kernel yako mwenyewe. Kwenye KVM, mgeni bado anahitaji moduli ya kernel ya tun; nyaraka za Linux za Tailscale zinasema uipakie kwa kutumia sudo modprobe tun ikiwa haipo.
Baada ya hapo, sudo tailscale up huchapisha URL ya kuingia, na tailscale status inapaswa kuorodhesha mashine yako ikiwa na anwani katika masafa ya 100.64.0.0/10. Mashine inayoonekana hapo ni mashine unayoweza kuijengea, iwe hiyo inamaanisha kutangaza subnet ya kibinafsi kutoka kwa VPS yako au kutumia VPS kama exit node.
FAQ
Kwa nini apt inasema hazina ya Tailscale haijasainiwa?
Kwa sababu apt ilipakua faharasa ya hazina na haikuweza kuthibitisha sahihi yake dhidi ya /usr/share/keyrings/tailscale-archive-keyring.gpg. Sababu ya kawaida ni kwamba keyring ina ukubwa wa baiti sifuri: sudo tee ilikata faili kabla ya curl kushindwa kupakua chochote, na pipeline iliripoti mafanikio kwa sababu tee ilifanikiwa. Tekeleza gpg --show-keys /usr/share/keyrings/tailscale-archive-keyring.gpg. Keyring inayofanya kazi huchapisha mstari wa pub na mstari wa uid unaotaja Tailscale, wakati ile tupu au iliyoharibika huchapisha gpg: no valid OpenPGP data found.. Pakua ufunguo kwenye faili ya muda, uikague hapo, kisha uinakili mahali pake kwa mode 0644 ili mtumiaji _apt aweze kuusoma.
Ni codename ipi ya Ubuntu ninayopaswa kuweka kwenye URL za Tailscale?
Tumia thamani ya UBUNTU_CODENAME kutoka /etc/os-release, ambayo ni noble kwenye Ubuntu 24.04, resolute kwenye Ubuntu 26.04 na stonking kwenye Ubuntu 26.10. Usitumie lsb_release -cs kwenye usambazaji unaotokana na Ubuntu: kwenye Linux Mint 22 huchapisha wilma, Tailscale haichapishi chochote kwa jina hilo, na apt huripoti 404 kwenye dists/wilma/InRelease. Thibitisha chaguo lako kabla ya kuhariri chochote kwa kuchota faharasa kwa mkono ukitumia curl -sS -o /dev/null -w '%{http_code}\n' dhidi ya https://pkgs.tailscale.com/stable/ubuntu/dists/<codename>/InRelease.
Je, ni salama kuendesha script ya usakinishaji wa Tailscale kwa kuipitisha kwenye shell?
Ni uamuzi unaopaswa kuufanya kwa makusudi. Script hiyo inatoka Tailscale na hufanya yale ambayo hatua za mwongozo hufanya: inasoma /etc/os-release, inaandika keyring ileile na /etc/apt/sources.list.d/tailscale.list ileile, kisha inasakinisha kifurushi. Gharama yake ni kwamba unaendesha chochote ambacho seva inarudisha wakati huo, ukiwa na root, na huweki kumbukumbu yake. Ipakue kwa -o install.sh, isome, kisha uiendeshe ikiwa unataka urahisi bila kufanya kazi kwa upofu. Pia haiwezi kusaidia na hazina iliyozuiwa, kwa sababu inatumia URL zilezile ambazo tayari zimeshindwa.
Ninawezaje kusakinisha Tailscale kwenye Ubuntu bila hazina ya apt?
Una njia mbili. Ya kwanza ni snap inayodumishwa na Canonical, sudo snap install tailscale, ambayo kufikia 3 Novemba 2026 ilikuwa na toleo la 1.102.3 kwenye channel yake ya 1/stable na si lazima iwe imeidhinishwa na Tailscale. Ya pili ni tarballs tuli zilizochapishwa kwenye pkgs.tailscale.com, ambazo kufikia 3 Novemba 2026 ziko kwenye toleo la 1.104.5 na faili ya amd64 inayoitwa tailscale_1.104.5_amd64.tgz. Kwa kutumia tarballs, unasakinisha programu za tailscale na tailscaled mwenyewe na kuendesha daemon chini ya systemd mwenyewe. Hakuna kifurushi cha apt cha kuvuta toleo jipya, lakini toleo la 1.104.5 linaunga mkono sudo tailscale update kwa usakinishaji tuli. Ilipokaguliwa mnamo Oktoba 2026, archive ya Ubuntu haikuwa na deb ya tailscale yenyewe, kwa hivyo sudo apt install tailscale kwenye mashine isiyo na hazina ya muuzaji ilisimama kwenye E: Unable to locate package tailscale.