headscale తో మీ స్వంత Tailscale control server ఏర్పాటు
VPS పై మీ స్వంత Tailscale control server నడపండి. అధికారిక .deb నుంచి headscale ఇన్స్టాల్ చేసి server_url సెట్ చేసి restart చేయడం, మొదటి node ను join చేయడం ఇందులో ఉన్నాయి.
headscale అంటే ఏమిటి
headscale అనేది Tailscale control server యొక్క self-hosted implementation. అందువల్ల మీ private network ను సమన్వయం చేసే machine మీకు చెందిన VPS అవుతుంది. ఇది community project; దీన్ని Tailscale Inc. నిర్వహించదు. ప్రతి machine లో అధికారిక tailscale clientనే నడుస్తుంది. --login-server అనే ఒక flag తో ఆ client ను మీ server వైపు చూపించాలి.
ఎవరు network లో భాగమో control server కు తెలుసు. ఇది ప్రతి node కు 100.64.0.0/10 పరిధి నుంచి ఒక address కేటాయిస్తుంది, public keys ను పంపిణీ చేస్తుంది, అలాగే nodes ఒకదానినొకటి ఎక్కడ కనుగొనాలో తెలియజేస్తుంది. Tunnels మాత్రం WireGuard గానే ఉంటాయి. అవి node-to-node గా నిర్మించబడతాయి. మీ రెండు machines మధ్య traffic headscale box ద్వారా వెళ్లదు. Direct path నిర్మించలేని సందర్భంలో nodes relay కు fallback అయితే మాత్రమే అది జరుగుతుంది. ఈ coordination role ను మీరే నిర్వహించడం వల్ల ఆ పాత్రను ఎవరు నిర్వహిస్తున్నారో మారుతుంది; అది చేయగలిగే పనులు మారవు. అందువల్ల ఈ మార్పును స్వతహాగా security improvement గా పరిగణించే ముందు, ఈ model లో control server ఏది చేరుకోగలదు, ఏది చేరుకోలదు అనేది అర్థం చేసుకోవాలి.
Headscale ప్రతి instance కు ఒక tailnet (ఒక Tailscale network) ను అందిస్తుంది. దీన్ని personal use లేదా చిన్న organisation కు అనుకూలమని project వివరిస్తుంది. మూడు లేదా నాలుగు machines మాత్రమే ఉంటే, మీ సొంత VPS పై plain WireGuard VPN నిర్వహించడం ద్వారా నడపాల్సిన software మరియు విఫలమయ్యే అవకాశాలు రెండూ తగ్గుతాయి. ప్రతి కొత్త laptop కోసం చేతితో [Peer] block రాయాల్సిన అవసరం లేకుండా ఉండాలనుకున్నప్పుడు Headscale ఉపయోగకరంగా మారుతుంది. ప్రారంభంగా చాలామంది పరిశీలన మొదలుపెట్టడానికి cost ఒక ప్రధాన కారణం. అందువల్ల server నిర్వహణను స్వీకరించే ముందు hosted free plan వాస్తవంగా ఏమి అందిస్తుందో చదవడం మంచిది, ఎందుకంటే కొద్దిమంది personal machines సాధారణంగా దానిలోనే సరిపోతాయి. మీరు ఇప్పటికే ఆ పరిమితిని దాటితే, ప్రతి user మరియు ప్రతి tagged resource కు paid plans ఖర్చు ఎంతవుతుందో లెక్కించి పోల్చండి. user devices కు పరిమితి ఉండదు, అయితే tagged resources కు ప్రత్యేక allowances మరియు charges ఉంటాయి. మీరు self-hosted control plane కోరుకుంటూ, Tailscale కు drop-in replacement కంటే peers ను నిర్వహించడానికి మీ స్వంత client మరియు web interface ను ఉపయోగించాలనుకుంటే, ఒకే VPS పై NetBird పరిశీలించదగిన ప్రత్యామ్నాయం. రెండూ మీ traffic ను WireGuard ద్వారా పంపుతాయి. కాబట్టి ఎంపిక access rules ను మీరు ఎలా రాస్తారు, relays ఎలా పనిచేస్తాయి అనే అంశాలపై ఆధారపడి ఉంటుంది. ఏదో ఒకదాన్ని install చేయడానికి ముందు ఆ అంశాలపై NetBird మరియు Tailscale ను పోల్చడం మంచిది. ఈ రెండు models పై విస్తృత పోలిక కోసం WireGuard మరియు Tailscale ఎలా భిన్నంగా ఉంటాయో చూడండి.
ఇన్స్టాలేషన్కు ముందు అవసరమైనవి
- Public IPv4 address మరియు sudo access కలిగిన Ubuntu 24.04 VPS. Server కొత్తదైతే ముందుగా కొత్త VPSలో మొదటి పది నిమిషాలు మార్గదర్శకాన్ని పూర్తి చేయండి.
- ఆ address కు point అయ్యే DNS A record. ఈ మార్గదర్శకంలో
headscale.example.comఉపయోగించబడుతుంది. - MagicDNS కోసం రెండవ domain లేదా subdomain. ఈ మార్గదర్శకంలో
tailnet.example.netఉపయోగించబడుతుంది. ఇదిserver_urlలోని domain తో ఒకటే కాకూడదు. - Join చేయడానికి Linux, macOS, Windows, Android లేదా iOS నడుస్తున్న ఒక client machine. Headscale 0.29.6 కు Tailscale client version 1.80.0 లేదా తరువాతి version అవసరం.
అధికారిక .deb ప్యాకేజీ నుంచి headscale ఇన్స్టాల్ చేయండి
ప్రాజెక్ట్ తన GitHub releases పేజీలో .deb ప్యాకేజీలను విడుదల చేస్తుంది. October 27, 2026 నాటికి తాజా స్థిరమైన విడుదల 0.29.6. ఇది October 24, 2026న విడుదలైంది. ముందుగా మీ architecture ను తనిఖీ చేయండి, ఎందుకంటే ఫైల్ పేరులో architecture ఉంటుంది.
sudo apt update
sudo apt install -y wget
dpkg --print-architectureసాధారణ x86 VPSలో ఇది amd64 ను, Ampere లేదా Graviton తరహా planలో arm64 ను ప్రింట్ చేస్తుంది. దిగువ variableలో ఆ సమాధానాన్ని ఉంచండి.
HEADSCALE_VERSION="0.29.6"
HEADSCALE_ARCH="amd64"
wget --output-document=headscale.deb \\
"https://github.com/juanfont/headscale/releases/download/v${HEADSCALE_VERSION}/headscale_${HEADSCALE_VERSION}_linux_${HEADSCALE_ARCH}.deb"
sudo apt install -y ./headscale.deb
headscale versionఫైల్ పేరు ముందు ఉన్న ./ తప్పనిసరి. అది లేకపోతే apt మీ repositoriesలో headscale.deb అనే ప్యాకేజీ కోసం వెతికి విఫలమవుతుంది.
ఈ ప్యాకేజీ headscale system user ను సృష్టిస్తుంది, డిఫాల్ట్ /etc/headscale/config.yaml ను రాస్తుంది, systemd unit ను ఇన్స్టాల్ చేస్తుంది, ఆపై సేవను ప్రారంభిస్తుంది. అందువల్ల apt తిరిగి వచ్చినప్పుడు headscale ఇప్పటికే నడుస్తూ ఉంటుంది, మరియు sudo systemctl is-active headscale active ను ప్రింట్ చేస్తుంది. అయితే కొత్త ఇన్స్టాలేషన్లో ప్యాకేజీ unitను enable చేయదు. కాబట్టి మీరు దాన్ని enable చేసే వరకు reboot తర్వాత సేవ స్వయంచాలకంగా ప్రారంభం కాదు. దిగువ restart దశ ఈ పనిని చేస్తుంది. ఇది ప్యాకేజీతో వచ్చిన configurationపైనే నడుస్తుంది. ఆ configuration server_url ను http://127.0.0.1:8080 కు సూచిస్తుంది. మీ client ఏదీ చేరుకోలేని address అది. ప్యాకేజీతో వచ్చిన listen_addr కూడా loopbackపై మాత్రమే listening చేస్తున్నందున ప్రస్తుతం బయటకు ఏదీ expose కాలేదు. అయినప్పటికీ server_url సెట్ చేసి సేవను restart చేసే వరకు ఏ clientనూ join చేయవద్దు. తరువాతి రెండు దశలు ఈ పనులను చేస్తాయి.
క్లయింట్లు చేరకముందే server_url ను కాన్ఫిగర్ చేయండి
sudo nano /etc/headscale/config.yaml తో /etc/headscale/config.yaml ను సవరించండి. లేదా sed తో అదే మూడు మార్పులను వర్తింపజేయండి. అసలు ఫైల్కు ఒక కాపీ ఉంచండి. ఈ ఫైల్ చాలా పొడవుగా, విస్తృత వ్యాఖ్యలతో ఉంటుంది. మిగిలిన సెట్టింగ్లకు ఇది మీ వద్ద ఉన్న ఉత్తమ సూచన.
sudo cp /etc/headscale/config.yaml /etc/headscale/config.yaml.orig
sudo sed -i 's|^server_url:.*|server_url: https://headscale.example.com|' /etc/headscale/config.yaml
sudo sed -i 's|^listen_addr:.*|listen_addr: 127.0.0.1:8080|' /etc/headscale/config.yaml
sudo sed -i 's|^ base_domain:.*| base_domain: tailnet.example.net|' /etc/headscale/config.yaml
sudo grep -E '^(server_url|listen_addr):|^ base_domain:' /etc/headscale/config.yamlనమోదు URLలను రూపొందించేటప్పుడు headscale ఉపయోగించే public address server_url. క్లయింట్లు --login-server తో కాన్ఫిగర్ చేసిన control address ను ఉపయోగిస్తాయి. అందువల్ల రెండు చోట్లా https:// తో కూడిన అదే public name ను ఉపయోగించండి. 127.0.0.1 ను ఎప్పుడూ ఉపయోగించవద్దు. సాధారణ HTTP లేదా 443 కాకుండా వేరే port పై HTTPS ఉపయోగించడం సాధ్యమేనని headscale documentation చెబుతుంది. అయితే production కోసం port 443 పై HTTPS ను గట్టిగా సిఫారసు చేస్తుంది. ఈ guide లోని మిగిలిన భాగం కూడా దానినే ఆధారంగా తీసుకుంటుంది.
ప్రాసెస్ bind అయ్యే address listen_addr. దీన్ని loopback పై ఉంచండి. అదే server పై ఉన్న reverse proxy TLS (transport layer security) ను terminate చేసి, అభ్యర్థనలను దీనికి forward చేస్తుంది. కాబట్టి server వెలుపల నుంచి port 8080 ను చేరాల్సిన అవసరం లేదు.
MagicDNS suffix base_domain. ఇది మీ nodes కు పేర్లు కేటాయించే domain. ఇది trailing dot లేని fully qualified domain name అయి ఉండాలి. server_url లో ఉన్న domain కు ఇది భిన్నంగా ఉండాలి. లేకపోతే రెండు name spaces పరస్పరం collide అవుతాయి.
database section ను అలాగే ఉంచండి. Default గా SQLite /var/lib/headscale/db.sqlite వద్ద ఉంటుంది. ఈ directory ను package సృష్టించి, దాని ownership ను నిర్వహిస్తుంది. ఈ పరిమాణంలోని tailnet కు SQLite సరిపోతుంది.
headscale ను పునఃప్రారంభించి, అది నడుస్తోందని నిర్ధారించండి
sudo systemctl restart headscale
sudo systemctl enable headscale
sudo systemctl is-active headscale
sudo systemctl is-enabled headscale
curl -sS -o /dev/null -w '%{http_code}\\n' http://127.0.0.1:8080/healthis-active అనేది active ను ముద్రిస్తుంది, is-enabled అనేది enabled ను ముద్రిస్తుంది, అలాగే curl అనేది 200 ను ముద్రిస్తుంది. మీరు చేసిన మార్పులను లోడ్ చేసే దశ పునఃప్రారంభం. headscale ప్రారంభమైనప్పుడు ఒక్కసారి మాత్రమే configuration ను చదువుతుంది. అందువల్ల package ప్రారంభించిన process, మీరు పంపిణీతో వచ్చిన server_url ను ఉపయోగిస్తూనే ఉంటుంది; దాన్ని పునఃప్రారంభించాలి. sudo systemctl enable --now headscale ఈ పని చేయదు. Service ఇప్పటికే నడుస్తోంది కాబట్టి, --now start ఎలాంటి మార్పు చేయదు. పాత విలువే అమలులో ఉంటుంది. Boot సమయంలో ప్రారంభించడం enable పని. ఇది స్వయంచాలకంగా జరగదు. కొత్తగా install చేసినప్పుడు package service ను ప్రారంభిస్తుంది, కానీ దాన్ని enable చేయదు. కాబట్టి పైన చూపిన విధంగా sudo systemctl enable headscale ను ఒక్కసారి అమలు చేయండి.
is-active, active కాకుండా మరేదైనా ముద్రిస్తే, లేదా curl, 200 ను ముద్రించకపోతే, sudo journalctl -u headscale -n 50 --no-pager తో journal చదవండి. ఈ దశలో failure సాధారణంగా configuration file వల్లే జరుగుతుంది. headscale socket తెరవకముందు మొత్తం file ను parse చేస్తుంది. అందువల్ల indentation తప్పుగా ఉన్నా లేదా అవసరమైన setting చెల్లనిదైనా, ఏదీ listen చేయకముందే process ఆగిపోతుంది. File ను సరిచేసి, తరువాత sudo systemctl restart headscale అమలు చేయండి. తరువాత చేసే ప్రతి configuration మార్పుకూ ఇదే పునఃప్రారంభం అవసరం. ఆ తర్వాత clients స్వయంగా reconnect అవుతాయి. systemd units మీకు కొత్తగా ఉంటే, systemd తో మీ స్వంత services మరియు timers ను అమలు చేయడం ఇక్కడ ఉపయోగించిన commands ను వివరిస్తుంది.
మీరు shell లో ఉన్నప్పుడే state files ను పరిశీలించండి:
stat -c '%U %n' /var/lib/headscale/db.sqlite /var/lib/headscale/noise_private.keyరెండు lines కూడా package సృష్టించిన unprivileged user అయిన headscale తో ప్రారంభమవుతాయి. noise_private.key అనేది server తన clients కు ఉపయోగించే identity. దాన్ని అలాగే ఉంచండి. దాన్ని delete చేస్తే headscale కొత్త identity ను generate చేస్తుంది. Reconnect కావడానికి ముందు clients కొత్త server key ను fetch చేయాలి. అయితే ఇప్పటికే ఉన్న registrations database లో అలాగే ఉంటాయి.
headscale ముందు TLS అమర్చండి
క్లయింట్లు server_url ను HTTPS ద్వారా చేరుకోవాలి. Caddy సులభమైన మార్గం, ఎందుకంటే అది స్వయంగా certificate ను అభ్యర్థించి, renewal చేస్తుంది.
sudo apt install -y caddy/etc/caddy/Caddyfile స్థానంలో headscale documentation లోని block ను ఉంచండి:
headscale.example.com {
reverse_proxy 127.0.0.1:8080 {
header_up True-Client-IP {remote_host}
header_up X-Real-IP {remote_host}
}
}sudo caddy validate --adapter caddyfile --config /etc/caddy/Caddyfile
sudo systemctl restart caddy
sudo systemctl is-active caddyఫైల్ parse అయినప్పుడు validate, adapted config to JSON ను ప్రింట్ చేస్తుంది. ఫైల్ format చేయలేదనే warning కు కార్యాచరణ ప్రభావం ఉండదు. మీ laptop నుంచి కూడా curl -sS -o /dev/null -w '%{http_code}\\n' https://headscale.example.com/health, 200 ను ప్రింట్ చేయాలి. ఈ ఒక్క తనిఖీ DNS, firewall, certificate, proxy అన్నీ కలిసి సరిగ్గా పనిచేస్తున్నాయని నిర్ధారిస్తుంది.
ఇక్కడ proxyలోని ఒక ముఖ్యమైన వివరాన్ని గమనించాలి. Tailscale control connection అనేది HTTP upgrade. ఇది GET బదులుగా POST తో ప్రారంభమవుతుంది. Upgrade header విలువ tailscale-control-protocol. Caddy దీనిని అదనపు configuration లేకుండా pass through చేస్తుంది. nginx అలా చేయదు. అందువల్ల nginx front end Upgrade మరియు Connection headers ను స్పష్టంగా forward చేయాలి. headscale documentation దీన్ని upgrade map ద్వారా చేస్తుంది:
map $http_upgrade $connection_upgrade {
default keep-alive;
'' close;
}
server {
listen 443 ssl;
server_name headscale.example.com;
location / {
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_buffering off;
proxy_pass http://127.0.0.1:8080;
}
}ఆ lines ను వదిలేస్తే సాధారణ requests ఇంకా విజయవంతమవుతాయి. అందుకే /health 200 ను return చేసి, అన్నీ సరిగ్గా ఉన్నట్లు కనిపిస్తాయి. కానీ control connection ఎప్పటికీ ఏర్పడదు. కొత్త nodes register కాలేవు. ఇప్పటికే ఉన్న nodes మళ్లీ connect అయి online అని report చేయలేవు. nginx మార్గాన్ని ఎంచుకుంటే, certificate భాగం కోసం Ubuntu 24.04లో nginxతో Certbot చూడండి.
UFWలో ఏ ports తెరవాలి
sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
sudo ufw status verbose443 port ద్వారా ప్రతి client యొక్క control connection headscale కు చేరుతుంది. తరువాత embedded DERP relay ను enable చేస్తే, దానికి 3478/udp కూడా అవసరం. దీనిని దిగువన వివరించాం. ACME (automatic certificate management environment) HTTP challenge కోసం, అలాగే HTTPS కు redirect చేయడం కోసం 80 port ఉపయోగపడుతుంది. 80 port మూసి ఉన్నా Caddy certificate పొందగలదు, ఎందుకంటే 443 port పై TLS-ALPN challenge ను ఉపయోగించవచ్చు. అయితే 80 port తెరిచి ఉంటే రెండు challenges అందుబాటులో ఉంటాయి, plain http:// requests కూడా redirect అవుతాయి.
8080 port మూసి ఉంచాలి. listen_addr అనేది 127.0.0.1:8080 కాబట్టి proxy loopback interface ద్వారా headscale ను చేరుతుంది. అందువల్ల firewall rule అవసరం లేదు. బయట నుంచి 8080 పై ఏదీ listen కాకపోవడంతో, UFWలో 8080 తెరిచినా ఏదీ బయటకు expose కాదు. దాంతో ఎలాంటి ప్రయోజనం కూడా ఉండదు. చాలా providers తమ control panelలో UFWకు వేరుగా రెండవ firewallను అమలు చేస్తారని గుర్తుంచుకోండి. అందువల్ల serverలో port open ఉన్నా edge వద్ద అది మూసి ఉండవచ్చు. VPSలో UFW firewall ప్రాథమికాలులో rule syntaxను మరింత వివరంగా చూడవచ్చు.
వినియోగదారుని మరియు preauth keyని సృష్టించడం
sudo headscale users create alice
sudo headscale users listheadscale command ఒక client. ఇది నడుస్తున్న daemonతో /var/run/headscale/headscale.sock వద్ద ఉన్న unix socket ద్వారా సంభాషిస్తుంది. ఈ socket mode 0770లో ఉంటుంది మరియు headscale group యాజమాన్యంలో ఉంటుంది. దీనివల్ల రెండు విషయాలు స్పష్టమవుతాయి. service ఆపివేసి ఉంటే command విఫలమవుతుంది. ఈ guideలో క్రమాన్ని పాటించడం ముఖ్యమైన మరో కారణం ఇదే. అలాగే, మీ స్వంత accountను headscale groupకు చేర్చకపోతే sudo అవసరం.
users list ప్రతి name పక్కన ఒక IDని చూపిస్తుంది. ఆ number మీకు అవసరం. ఎందుకంటే key command name కాకుండా numeric user IDని స్వీకరిస్తుంది.
sudo headscale preauthkeys create --user 1 --expiration 24hkey ఒక్కసారి మాత్రమే చూపబడుతుంది. దాన్ని ఇప్పుడే copy చేయండి. preauth key ఒకసారి మాత్రమే ఉపయోగించవచ్చు. మీరు వేరే విధంగా పేర్కొనకపోతే అది one hour వరకు చెల్లుతుంది. అందువల్ల మీరు ఇంకా testing చేస్తున్నప్పుడు --expiration 24hని సెట్ చేయడం ఉపయోగకరం. అనేక machinesను enroll చేసే key కోసం --reusableను జోడించండి. ఆ keyని passwordలాగే రక్షించండి. దాన్ని కలిగి ఉన్న ఎవరైనా మీ networkలో చేరవచ్చు.
మీ మొదటి client ను --login-server తో కనెక్ట్ చేయండి
మీరు join చేయాలనుకుంటున్న machine పై:
curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up --login-server https://headscale.example.com --auth-key 'hskey-auth-PASTE-YOUR-KEY-HERE'
tailscale status
tailscale ip -4tailscale ip -4 headscale కేటాయించిన address ను చూపిస్తుంది. అది సాధారణంగా 100.64.0.1 లా ఉంటుంది. Server పైకి తిరిగి వెళ్లి, sudo headscale nodes list ద్వారా node యొక్క ID, user మరియు online state చూడవచ్చు.
server_url నుంచి వచ్చిన public HTTPS address ను --login-server కోసం ఉపయోగించండి. Client తన control URL చివర ఉన్న slashes ను తొలగిస్తుంది. అందువల్ల trailing slash ను తప్పనిసరిగా తొలగించాల్సిన exact string comparison ఉండదు.
గతంలో Tailscale hosted service కు sign in చేసిన machine ఆ login ను అలాగే ఉంచుతుంది. ముందుగా దానిపై sudo tailscale logout ను అమలు చేయండి. తరువాత --login-server తో tailscale up ను అమలు చేయండి.
--auth-key ను వదిలేస్తే, client బదులుగా ఒక URL ను చూపిస్తుంది. దాన్ని open చేయండి. ఆ page ఆ registration attempt కు సంబంధించిన identifier ను చూపిస్తుంది. Server పై దాన్ని approve చేయాలి:
sudo headscale auth register --user alice --auth-id PASTE-THE-ID-FROM-THE-PAGEమీ స్వంత laptop కోసం ఆ form మరింత సౌకర్యవంతంగా ఉంటుంది. Script చేసే పనులకు preauth keys మెరుగైనవి, ఎందుకంటే ఎవరైనా ప్రత్యక్షంగా గమనిస్తూ ఉండాల్సిన అవసరం ఉండదు. VPS స్వయంగా ఒక node అయిన తర్వాత, అది మీ ఇతర machines యొక్క internet traffic ను కూడా మోయగలదు. దీనినే exit node setup అంటారు. అయితే hosted admin console లో కాకుండా, server పై headscale command తో advertised route ను approve చేయాలి. ఆ VPS ద్వారా internet కు బయటకు వెళ్లే మార్గం కాకుండా, దాని వెనుక ఉన్న private network ను చేరుకోవాలనుకుంటే, అదే approval step ద్వారా ఆ subnet ను మీ tailnet లోని మిగిలిన భాగానికి advertise చేయవచ్చు. ఒక node నుంచి మొత్తం networks ను route చేయకుండా ఒక application ను మాత్రమే publish చేయడం వేరే పని. దానికి serve మరియు funnel రెండు మార్గాలు, అయితే రెండూ Tailscale యొక్క స్వంత certificate మరియు ingress machinery పై ఆధారపడతాయి. అందువల్ల వాటిని headscale మీకు అందించే సదుపాయాలుగా కాకుండా hosted-tailnet features గా పరిగణించండి.
DERP మరియు direct path విఫలమైనప్పుడు traffic ను relay చేసే విధానం
DERP (packets కోసం నిర్దేశిత encrypted relay) fallback path గా పనిచేస్తుంది. రెండు nodes direct WireGuard connection ను ఏర్పాటు చేయలేనప్పుడు, సాధారణంగా రెండూ strict NAT (network address translation) వెనుక ఉన్నప్పుడు, అవి packets ను relay ద్వారా పంపుతాయి. Relay వద్ద keys ఉండవు కాబట్టి అది మీ traffic ను చదవలదు. అయితే ఏ nodes పరస్పరం మాట్లాడుతున్నాయి, ఎంత data బదిలీ అవుతోంది అనే విషయాలు relay కు కనిపిస్తాయి.
Default configuration ఏమి చేస్తుందో స్పష్టంగా తెలుసుకోవాలి. Headscale, https://controlplane.tailscale.com/derpmap/default ను auto_update_enabled: true మరియు update_frequency: 3h తో ఉపయోగించేలా ముందుగానే అమర్చబడి వస్తుంది. అందువల్ల మీ control plane మీ ఆధీనంలో ఉంటుంది, కానీ relays Tailscale ఆధీనంలో ఉంటాయి. చాలా మందికి ఇది ఆమోదయోగ్యమైన మార్పిడి. అది మీకు సరిపోకపోతే మీ స్వంత relay ను నడపండి.
మీ స్వంత relay ను నడపడానికి, config.yaml లోని derp.server కింద enabled: true ను సెట్ చేయండి. ముందుగా అందించిన ipv4: 198.51.100.1 మరియు ipv6: 2001:db8::1 స్థానంలో మీ relay యొక్క public addresses ను పెట్టండి. లేదా DNS ఉపయోగించాలంటే రెండు settings ను తొలగించండి. తరువాత headscale ను restart చేసి, STUN (NAT కోసం session traversal utilities) port ను sudo ufw allow 3478/udp తో open చేయండి. ఈ address settings, DNS పై override చేస్తాయి. అందువల్ల ఏదైనా placeholder ను అలాగే ఉంచితే clients చేరుకోలేని address కు పంపబడతాయి. Configuration file ఈ అవసరాన్ని స్పష్టంగా చెబుతుంది: server_url తప్పనిసరిగా https ను ఉపయోగించాలి, ఎందుకంటే DERP కు TLS అవసరం. derp.urls list ను ఖాళీ చేయడం ద్వారా Tailscale relays map నుంచి తొలగించబడతాయి. అలా చేయడానికి ముందు పనిచేసే embedded లేదా custom relay ను ఉంచండి. ఖాళీ relay map తో Headscale ప్రారంభం కావడానికి నిరాకరిస్తుంది. చేరుకోలేని ఒకే relay ఉన్న map వల్ల direct గా connect కాలేని nodes పరస్పరం communicate చేయలేవు.
Client నుంచి tailscale netcheck తెలిసిన ప్రతి relay region కు latency ను చూపిస్తుంది. tailscale status active peer connections కోసం direct ను address తో లేదా relay ను region code తో చూపిస్తుంది. relay పై నిలిచిపోయిన peer కోసం NAT మరియు firewall rules సహా దాని direct path ను పరిశీలించాలి. Peer direct గా ఉండి ఇంకా slow గా ఉంటే, అది వేరే సమస్య. అక్కడ సాధారణంగా tunnel సమస్యకన్నా MTU సమస్యే కారణమవుతుంది.
నోడ్ offline గా ఎందుకు కనిపిస్తుంది?
Proxy upgrade ను drop చేస్తోంది. /health 200 ను తిరిగి ఇస్తుండగా, కొత్త registrations విఫలమవడం లేదా ఇప్పటికే ఉన్న nodes మళ్లీ connect కాలేకపోవడం దీని లక్షణం. Control connection అనేది Upgrade: tailscale-control-protocol ను మోసే POST. దాన్ని forward చేయని proxy registration ను, node state ను report చేసే channel ను రెండింటినీ అడ్డుకుంటుంది. మీ nginx configuration ను పైన ఉన్న upgrade lines తో పోల్చండి. లేదా proxy కారణమో కాదో నిర్ధారించడానికి Caddy కి మారండి.
Public control address మారింది. Nodes --login-server తో configure చేసిన address కు నిరంతరం dial చేస్తాయి. server_url మార్చినంత మాత్రాన ఆ client setting update కాదు. పాత address ఇక మీ server కు చేరకపోతే, ప్రతి node పై sudo tailscale up --login-server https://headscale.example.com --force-reauth నడపండి.
Client నడవడం లేదు. Node పై sudo systemctl is-active tailscaled మరియు sudo journalctl -u tailscaled -n 50 --no-pager నడపండి. మీ domain ను resolve చేయలేని లేదా దానికి చేరుకోలేని client తన retries ను అక్కడ log చేస్తుంది.
Key గడువు ముగిసింది. దీని వివరాలు తదుపరి section లో ఉన్నాయి.
మీరు పరీక్షిస్తున్నప్పుడు server వైపు monitor చేయడానికి VPS పై sudo journalctl -u headscale -f నడపండి. Client పై tailscaled ను restart చేయండి. Client journal ను కూడా పరిశీలించండి. headscale కు చేరిన request default log level వద్ద తప్పనిసరిగా ఒక line ను ఉత్పత్తి చేయదు. అందువల్ల server log లో ఏమీ కనిపించకపోవడం మాత్రమే DNS, firewall లేదా proxy failure కు ఆధారం కాదు.
కీ గడువు మరియు కొన్ని వారాల తర్వాత పనిచేయడం ఆపే node
రెండు వేర్వేరు గడువులు ఉంటాయి. వాటిని కలిపి అర్థం చేసుకుంటే సమయం వృథా అవుతుంది.
Preauth keys ఉద్దేశపూర్వకంగా త్వరగా expire అవుతాయి. Default ఒక గంట మరియు ఒక వినియోగం. tailscale up key ను తిరస్కరిస్తే, client లో ఏదైనా మార్చడం కంటే server పై కొత్తదాన్ని generate చేయండి.
Node keys ఎక్కువ కాలం చెల్లుబాటు అయ్యే భాగం. config.yaml లోని node section expiry: 0 ను సెట్ చేస్తుంది. 0 అంటే default expiry ఉండదు. అయినప్పటికీ explicit client expiry లేదా OIDC expiry వర్తించవచ్చు. Tagged nodes automatic expiry నుంచి మినహాయించబడతాయి. అయితే administrator వాటిని explicit గా expire చేయవచ్చు. Non-tagged registrations కోసం 180-day default కావాలంటే expiry: 180d సెట్ చేయండి. అయితే client-requested expiry కి ప్రాధాన్యం ఉంటుంది. OIDC default ను override చేయవచ్చు. ఈ setting మార్చడం వల్ల ఇప్పటికే ఉన్న registrations వెనుకకు వర్తించదు. Expiry ఉన్న node ఆ deadline కు ముందు sudo tailscale up --login-server https://headscale.example.com --force-reauth ఉపయోగించి మళ్లీ authenticate కావాలి. ఎవరూ re-authenticate చేయని headless server registration expire అయినప్పుడు network నుంచి తొలగిపోతుంది.
ఎవరైనా laptop కోల్పోతే దీన్ని manual గా చేయండి. sudo headscale nodes list మీకు ID ఇస్తుంది. తరువాత sudo headscale nodes expire -i 3 ఆ node ను logout చేస్తుంది. sudo headscale nodes delete -i 3 దాన్ని network నుంచి పూర్తిగా తొలగిస్తుంది.
బ్యాకప్లు మరియు upgrades
/var/lib/headscale మరియు /etc/headscale కలిసి మొత్తం server ను ఏర్పరుస్తాయి. వాటిని copy చేయడానికి ముందు service ను stop చేయండి. SQLite లో ఇంకా writes కొనసాగుతూ ఉండవచ్చు. Load లో ఉన్న database ను copy చేస్తే అది inconsistent గా మారవచ్చు.
sudo systemctl stop headscale
sudo tar czf /root/headscale-state.tgz -C /var/lib headscale
sudo tar czf /root/headscale-config.tgz -C /etc headscale
sudo systemctl start headscale
sudo chmod 600 /root/headscale-*.tgzరెండు files ను server వెలుపలికి తరలించండి. వాటిలో private keys మరియు ప్రతి registration ఉంటాయి. అందువల్ల server కు ఇచ్చేంత జాగ్రత్తనే వీటికీ ఇవ్వాలి. VPS నుంచి restic backups ను schedule ప్రకారం, encrypted గా చేయడం గురించి వివరిస్తుంది.
Upgrades install ప్రక్రియనే అనుసరిస్తాయి: కొత్త .deb, sudo apt install ./headscale.deb ను download చేసి, తరువాత restart చేయండి. ఆపై is-active మరియు /health checks ను మళ్లీ అమలు చేయండి. 0.29 నుంచి upgrade path కఠినంగా ఉంది. Minor version ను దాటడం నిరోధించబడుతుంది. పాత minor version కు downgrade చేయడం కూడా నిరోధించబడుతుంది. ఒక్కసారి ఒక minor version చొప్పున upgrade చేయండి. ప్రతి దశకు ముందు backup తీసుకోండి. ఆ version యొక్క release notes ను ముందుగా చదవండి. అదే release ACL policy behaviour ను మార్చి, అనేక configuration keys ను తరలించింది. Version 0.29.6 లో certificate validation మరియు dependencies కు security updates కూడా ఉన్నాయి. అందువల్ల ఇప్పటికే ఉన్న 0.29 installations ఈ patch release కు upgrade చేయాలి.
FAQ
నేను .debను ఇన్స్టాల్ చేసిన వెంటనే headscale ఇప్పటికే నడుస్తుందా?
అవును. ప్యాకేజీ ఇన్స్టాల్ అయిన వెంటనే సేవను ప్రారంభిస్తుంది. అది అందించిన /etc/headscale/config.yamlలో సేవ loopback పై మాత్రమే listen చేస్తుంది మరియు server_urlను http://127.0.0.1:8080కు సెట్ చేస్తుంది. కొత్త ఇన్స్టాలేషన్లో సేవ enable చేయబడదు. అందువల్ల sudo systemctl enable headscaleను అమలు చేసే వరకు boot సమయంలో ఇది ప్రారంభం కాదు. అందించిన address clientలకు ఉపయోగపడదు. కాబట్టి server_url, listen_addr మరియు base_domainను సవరించి, తరువాత sudo systemctl restart headscaleను అమలు చేసి sudo systemctl is-active headscaleతో నిర్ధారించండి. ఇది తప్పనిసరిగా restart కావాలి. headscale ఫైల్ను ప్రారంభమైనప్పుడు మాత్రమే చదువుతుంది. ఇప్పటికే నడుస్తున్న సేవపై enable --now అమలు చేస్తే boot కోసం enable అవుతుంది కానీ సేవ restart కాదు. అందువల్ల పాత విలువలే అమల్లో ఉంటాయి. restart తర్వాత ఇది విఫలమైతే sudo journalctl -u headscale -n 50 --no-pager సమస్యను సూచిస్తుంది. ఈ దశలో కారణం దాదాపు ఎల్లప్పుడూ YAML లోపమే. ఎందుకంటే headscale portకు bind కావడానికి ముందు మొత్తం ఫైల్ను parse చేస్తుంది.
నా యంత్రాల్లో సాధారణ Tailscale clientను ఇంకా ఇన్స్టాల్ చేయాలా?
అవును. headscale control serverను మాత్రమే భర్తీ చేస్తుంది. ప్రతి node Tailscale అందించే అధికారిక clientను నడుపుతుంది. sudo tailscale up --login-server https://headscale.example.comతో దాన్ని మీ serverకు point చేయాలి. ఆ flag ప్రామాణిక clientలోనే ఉంటుంది. కాబట్టి ఏదీ patch చేయడం లేదా rebuild చేయడం అవసరం లేదు.
నా traffic headscale server ద్వారా వెళ్తుందా?
సాధారణంగా కాదు. headscale networkను సమన్వయం చేసి keys మరియు addressesను అందిస్తుంది. Data path మాత్రం మీ nodes మధ్య నేరుగా WireGuard ద్వారా ఉంటుంది. రెండు nodes ఒకదానితో మరొకటి నేరుగా చేరుకోలేనప్పుడు మాత్రమే traffic DERP relay ద్వారా మళ్లించబడుతుంది. అందించిన configurationలో ఆ relays Tailscale యొక్క public relaysగా ఉంటాయి. ఒక nodeపై tailscale statusను అమలు చేసి, నిర్దిష్ట peer directలో ఉందా లేదా relayలో ఉందా చూడండి.
Register అయిన తర్వాత నా node offlineగానే ఎందుకు ఉంటుంది?
headscale nodes listలో కనిపించినా onlineకు రాని nodeకు reverse proxyతో సహా దాని control connectionను పరిశీలించాలి. ఈ connection `Upgrade: tailscale-control-protocol headerతో పంపే HTTP upgrade. Upgrade మరియు Connection headersను proxy_set_headerతో స్పష్టంగా forward చేయకపోతే nginx దాన్ని drop చేస్తుంది. పై configuration తన map $http_upgrade $connection_upgrade` block ద్వారా ఇదే చేస్తుంది. ఆ headersను drop చేయడం వల్ల కొత్త nodes register కావడం కూడా ఆగిపోతుంది. Caddyకి అదనపు configuration అవసరం లేకుండానే దీన్ని forward చేస్తుంది. అందువల్ల proxy కారణమా కాదా పరీక్షించడానికి ఇది వేగవంతమైన మార్గం.
headscale కోసం domain name మరియు TLS అవసరమా?
ఈ setup కోసం అవును. Domain name మరియు HTTPS ఉపయోగించండి. Bare IP addressesకు కూడా certificates వర్తించవచ్చు. అయితే configuration file ప్రకారం DERPకు TLS అవసరం. Domainతో పాటు Caddyను ఉపయోగిస్తే సుమారు ఐదు నిమిషాల్లో setup పూర్తవుతుంది. స్వయంగా renew అయ్యే HTTPS endpoint కూడా లభిస్తుంది. Plain HTTP సాధ్యమే. అయితే production కోసం port 443పై HTTPSను ఉపయోగించాలని headscale documentation గట్టిగా సిఫారసు చేస్తుంది. కొన్ని పరిస్థితుల్లో Tailscale client port 443పై HTTPS ఉంటుందని ఆశిస్తుందని కూడా documentation పేర్కొంటుంది.